AgentSkillsCN

fund-output-template

基金组合分析报告输出模板。定义了 fund-portfolio 代理在输出组合分析结果时所采用的格式,并制定了质量标准检查清单。

SKILL.md
--- frontmatter
name: fund-output-template
description: "펀드 포트폴리오 분석 보고서 출력 템플릿. fund-portfolio 에이전트가 포트폴리오 분석 결과를 출력할 때 사용하는 형식, 품질 기준 체크리스트를 정의합니다."

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

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


1. 기본 출력 형식

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

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

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

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

투자자 프로필

항목내용
투자 성향[공격형/중립형/안정형]
투자 기간[X년]
선호 유형[펀드 유형]
수익률 기준[기간]
분석 기준일[날짜]

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

항목macro-outlook 권고실제 반영편차근거
위험자산 비중XX%XX%X%p[근거 또는 "권고 준수"]
미국 비중XX%XX%X%p[근거 또는 "권고 준수"]
반도체 비중≤XX%XX%OK/초과[근거]
환헤지[권고][반영]-[근거]

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

추천 포트폴리오 요약

핵심-위성 구조

구분펀드비중역할
핵심(Core)[펀드1]X%시장 수익 확보
핵심(Core)[펀드2]X%분산/안정
위성(Satellite)[펀드3]X%초과 수익 추구
안전자산[예금 또는 채권펀드]X%원금 보존

상세 포트폴리오

순위펀드명유형위험등급배분비율총보수기준수익률
1[펀드명][유형][등급][X]%[X.XX]%[X.XX]%
.....................

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

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

펀드비중총보수31년 비용 (1억 기준)평가
[펀드1]X%X.XX%X,XXX만원적정/높음
가중평균100%X.XX%X.X억원

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

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

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

항목예금 (SEMA 1년)최적 채권펀드
상품명과기공 예금[최고 순수익 채권펀드명]
명목 수익률X.X%X.X%
총보수0%X.X%
순수익률X.X%X.X%
원금 보장OX

Step 2: 임계값 판정

기준계산식
예금 수익률X.X%deposit_rates.json 참조
리스크 프리미엄0.5%p고정값
채권 선택 임계값X.X%예금 + 0.5%p
최적 채권 순수익X.X%return1y - totalFee
판정[예금 승/채권 승]순수익 > 임계값?

Step 3: 최종 결정

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

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

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

펀드별 상세 분석

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

  • 운용사: [운용사명]
  • 위험등급: [등급] ([설명])
  • 총보수: [X.XX]% ([적정/높음])
  • 순자산: [X억원]
  • 수익률 현황:
    1개월3개월6개월1년3년
    X%X%X%X%X%
  • 선택 근거: [인덱스/저비용/특수전략 등]
  • 주의 사항: [리스크 요인]

(각 펀드별 반복)

시나리오 분석

시장 시나리오

시나리오포트폴리오 예상 영향주요 가정
낙관 (Bull)+XX%[가정]
중립 (Base)+XX%[가정]
비관 (Bear)-XX%[가정]

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

금리 시나리오채권 영향포트폴리오 영향
금리 인하 (-1%p)[영향][총 영향]
금리 유지[영향][총 영향]
금리 인상 (+0.5%p)[영향][총 영향]

비판적 검토 (Counter-Arguments)

리스크 요인출처포트폴리오 영향대응 방안
[리스크1][출처][영향 분석][대응책]
[리스크2][출처][영향 분석][대응책]

근거 출처 테이블

권고 사항주요 출처검색일
[권고1][출처1: Bloomberg, Morgan Stanley 등][YYYY-MM-DD]
[권고2][출처2][YYYY-MM-DD]

리밸런싱 가이드

유형조건조치
정기 리밸런싱매년 1월 (또는 반기)목표 비율로 조정
임계값 리밸런싱비중 ±5%p 초과 시해당 펀드만 조정
긴급 리밸런싱시장 -20% 이상계획 유지, 추가 매수 검토

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

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

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

Generated by Claude Code Fund Portfolio Analyst


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

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

파일 출력 경로

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

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

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

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

---

JSON 출력 형식 (Coordinator 호출 시)

json
{
  "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 채권형 비교 (안전자산) (필수)
  • 투자 원칙 리마인더 (필수)
  • 면책조항 포함

행동재무학 점검

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

메타 정보

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