fund-output-template
SKILL.md
펀드 포트폴리오 분석 보고서 출력 템플릿
이 스킬은 fund-portfolio 에이전트가 포트폴리오 분석 결과를 출력할 때 사용하는 템플릿입니다.
1. 기본 출력 형식
퇴직연금 펀드 포트폴리오 추천
투자 원칙 확인 (먼저 읽어주세요)
이 포트폴리오는 장기 투자(30년+)를 전제로 합니다.
- 시장 타이밍을 시도하지 마세요
- 단기 변동성에 반응하지 마세요
- 계획을 고수하세요
투자자 프로필
| 항목 | 내용 |
|---|---|
| 투자 성향 | [공격형/중립형/안정형] |
| 투자 기간 | [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% |
| 원금 보장 | O | X |
Step 2: 임계값 판정
| 기준 | 값 | 계산식 |
|---|---|---|
| 예금 수익률 | X.X% | deposit_rates.json 참조 |
| 리스크 프리미엄 | 0.5%p | 고정값 |
| 채권 선택 임계값 | X.X% | 예금 + 0.5%p |
| 최적 채권 순수익 | X.X% | return1y - totalFee |
| 판정 | [예금 승/채권 승] | 순수익 > 임계값? |
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% - 선택 근거: [인덱스/저비용/특수전략 등]
- 주의 사항: [리스크 요인]
(각 펀드별 반복)
시나리오 분석
시장 시나리오
| 시나리오 | 포트폴리오 예상 영향 | 주요 가정 |
|---|---|---|
| 낙관 (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% 이상 | 계획 유지, 추가 매수 검토 |
투자 원칙 리마인더 (다시 한번 확인)
- 시장 타이밍을 시도하지 마세요 - 최고의 10일을 놓치면 수익 절반 감소
- 단기 변동성에 반응하지 마세요 - 30년 중 -20% 하락은 5-7회 예상
- 뉴스에 흔들리지 마세요 - 장기 투자자에게 일일 뉴스는 노이즈
- 계획을 고수하세요 - 감정이 아닌 규칙이 의사결정의 기준
면책조항: 본 분석은 투자 권유가 아닌 정보 제공 목적입니다. 과거 수익률은 미래 수익률을 보장하지 않습니다. 투자 결정 전 투자설명서를 반드시 확인하시고, 필요시 전문가와 상담하시기 바랍니다. 모든 투자에는 원금 손실 위험이 있습니다.
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
Weekly Installs
14
Repository
orientpine/honeypotGitHub Stars
10
First Seen
Feb 22, 2026
Security Audits
Installed on
mcpjam14
command-code14
replit14
junie14
windsurf14
zencoder14