펀드 포트폴리오 분석 보고서 출력 템플릿

이 스킬은 fund-portfolio 에이전트가 포트폴리오 분석 결과를 출력할 때 사용하는 템플릿입니다.

1. 기본 출력 형식

퇴직연금 펀드 포트폴리오 추천

투자 원칙 확인 (먼저 읽어주세요)

이 포트폴리오는 장기 투자(30년+)를 전제로 합니다.

1. 시장 타이밍을 시도하지 마세요
2. 단기 변동성에 반응하지 마세요
3. 계획을 고수하세요

투자자 프로필

macro-outlook 권고 반영 현황 (Multi-Agent 모드 시)

[참조: 00-macro-outlook.md]

추천 포트폴리오 요약

핵심-위성 구조

상세 포트폴리오

위험자산 비중: [X]% (DC형 한도 70% 준수: O/X)

비용 분석 (31년 장기 영향)

비용 절감 기회: [대안 펀드와 비교 시 절감 가능 금액]

안전자산 결정 (SAFE_ASSET_DECISION) – 필수

Step 1: 예금 vs 최적 채권 비교

Step 2: 임계값 판정

Step 3: 최종 결정

SAFE_ASSET_DECISION = "[예금 / 채권펀드명]"

선택 근거: [구체적인 수치 비교 및 판정 이유]

⚠️ HARD RULE: SAFE_ASSET_DECISION이 “예금”이면, 포트폴리오에 채권형 펀드 비중은 반드시 0%

펀드별 상세 분석

1. [펀드명] – [역할]

• 운용사: [운용사명]
• 위험등급: [등급] ([설명])
• 총보수: [X.XX]% ([적정/높음])
• 순자산: [X억원]
• 수익률 현황:

  1개월	3개월	6개월	1ë „	3ë „
  X%	X%	X%	X%	X%

• 선택 근거: [인덱스/저비용/특수전략 등]
• 주의 사항: [리스크 요인]

(각 펀드별 반복)

시나리오 분석

시장 시나리오

금리 시나리오 (채권 영향)

비판적 검토 (Counter-Arguments)

근거 출처 테이블

리밸런싱 가이드

투자 원칙 리마인더 (다시 한번 확인)

1. 시장 타이밍을 시도하지 마세요 – 최고의 10일을 놓치면 수익 절반 감소
2. 단기 변동성에 반응하지 마세요 – 30년 중 -20% 하락은 5-7회 예상
3. 뉴스에 흔들리지 마세요 – 장기 투자자에게 일일 뉴스는 노이즈
4. 계획을 고수하세요 – 감정이 아닌 규칙이 의사결정의 기준

면책조항: 본 분석은 투자 권유가 아닌 정보 제공 목적입니다. 과거 수익률은 미래 수익률을 보장하지 않습니다. 투자 결정 전 투자설명서를 반드시 확인하시고, 필요시 전문가와 상담하시기 바랍니다. 모든 투자에는 원금 손실 위험이 있습니다.

Generated by Claude Code Fund Portfolio Analyst

2. Multi-Agent 보고서 출력 형식 (coordinator 호출 시)

portfolio-orchestrator에서 호출될 때 반드시 지정된 경로에 보고서를 저장합니다.

파일 출력 경로

portfolios/YYYY-MM-DD-{profile}-{session}/01-fund-analysis.md

보고서 메타데이터 (상단 필수)

# 펀드 포트폴리오 분석 보고서

**생성일**: YYYY-MM-DD HH:MM:SS
**에이전트**: fund-portfolio
**세션 ID**: {session_id}

---

JSON 출력 형식 (Coordinator 호출 시)

{
  "portfolio": [
    { "name": "펀드명", "weight": 20, "category": "해외주식형", "role": "core" },
    { "name": "과기공 예금", "weight": 30, "category": "예금", "role": "safe" }
  ],
  "safeAssetDecision": {
    "decision": "예금",
    "depositRate": 4.9,
    "bestBond": {
      "name": "한국투자크레딧포커스ESG(채권)",
      "grossReturn": 3.49,
      "totalFee": 0.30,
      "netReturn": 3.19
    },
    "threshold": 5.4,
    "reason": "최적 채권 순수익(3.19%) < 임계값(5.4%) → 예금 선택"
  },
  "analysis": {
    "riskProfile": "공격형",
    "totalRiskWeight": 70,
    "totalSafeWeight": 30,
    "weightedFee": 0.85
  },
  "sources": [
    { "type": "local", "file": "fund_data.json", "fields": ["return3m"] },
    { "type": "local", "file": "deposit_rates.json", "fields": ["rate"] },
    { "type": "web", "url": "https://...", "title": "..." }
  ],
  "output_markdown": "... 전체 마크다운 출력 ..."
}

중요: safeAssetDecision.decision이 “예금”이면 portfolio 배열에 채권형 펀드가 포함되어서는 안 됩니다.

파일 저장 체크리스트

• output_path 파라미터 확인
• 메타데이터 (생성일, 에이전트명, 세션 ID) 포함
• 모든 수치에 출처 명시
• 데이터 출처 섹션 포함
• Write 도구로 파일 저장
• 저장 완료 확인 메시지 반환

3. 품질 기준 체크리스트

건전한 투자 철학 체크 (최우선)

• Bogle 원칙 준수: 시장 타이밍 시도, 과도한 거래 권유 없음
• 저비용 우선: 동일 전략 시 저비용 펀드 선택
• 장기 관점: 단기 성과 추격 권고 없음
• 분산투자: 단일 자산 40% 초과 없음
• 감정적 결정 경고: 시장 타이밍 위험성 명시

데이터 기반 체크 (환각 방지)

• fund_data.json 참조 확인: 모든 펀드 수익률이 로컬 데이터와 일치
• fund_fees.json 참조 확인: 총보수 있는 펀드만 비용 분석 포함
• 출처 명시 100%: 모든 수치에 출처 태그 있음 [출처: ...]
• 환각 체크: “확실”, “반드시”, “무조건” 표현 없음
• 데이터 없음 명시: 누락 데이터는 “미확인” 또는 “분석 생략” 표기

규제 준수 체크 (DC형 필수)

• 위험자산 합계: 정확히 계산되어 70% 이하 확인
• 위험자산 분류: 주식형+주식혼합형+채권혼합형 = 위험자산
• 안전자산 분류: 채권형+예금+MMF = 안전자산
• 합계 검증: 전체 비중 합계 = 100%
• 단일 펀드 한도: 40% 초과 펀드 없음

불확실성 표현 체크 (환각 방지)

• 시장 전망: 범위로 표현 (예: +5%~+15%)
• 확률 수치 없음: 시나리오 확률 % 미사용 (영향만 서술)
• 조건부 표현: “~한 경우”, “~가정 하에” 사용
• 금리 전망: “가능성 높음/낮음” 표현 (확정 수치 금지)

콘텐츠 필수 포함

• 모든 펀드의 정확한 수익률 데이터 (fund_data.json 기준)
• 총보수 정보 및 31년 비용 분석 (데이터 가용 시)
• 위험등급 명시 및 설명
• 구체적인 배분비율과 근거
• 분산투자 효과 분석
• DC형 위험자산 70% 한도 준수 확인 (필수)
• 웹검색 근거 출처 테이블 (필수)
• 비판적 검토 섹션 (필수)
• 시나리오 분석 (시장 + 금리, 영향만 서술)
• 예금 vs 채권형 비교 (안전자산) (필수)
• 투자 원칙 리마인더 (필수)
• 면책조항 포함

행동재무학 점검

• 시장 타이밍 권유가 없는가?
• “지금이 매수/매도 기회”라는 표현이 없는가?
• 단기 성과 추격을 조장하지 않았는가?
• 감정적 결정에 대한 경고가 포함되어 있는가?
• 장기 투자 원칙 리마인더가 포함되어 있는가?

메타 정보

version: "1.1"
created: "2026-01-15"
converted_to_skill: "2026-01-30"
purpose: "fund-portfolio 에이전트용 출력 템플릿 스킬"
consumers:
  - fund-portfolio