Communitygithub.com

个人基金持仓组合分析

接收基金代码、当前市值、持仓盈亏,精确计算组合收益、回本涨幅、条件补仓金额及资产分布,默认生成两页中文可检索PDF。仅作有依据的数据分析,不自动生成买卖、换仓建议。

个人基金持仓组合分析란 무엇인가요?

이 스킬은 사용자의 펀드 투자 포트폴리오를 분석하여 보유 내역, 수익률, 손익분기점 달성에 필요한 상승률, 조건부 추가 매수 금액, 자산 배분 등을 정밀 계산합니다. 사용자가 입력한 펀드 코드, 현재 시가총액(V), 보유 손익(P)을 바탕으로 Decimal 연산을 수행하며, 기본적으로 10%와 20%의 상승 시나리오에 따른 추가 매수 금액을 산출합니다. 분석 결과는 검색 가능한 두 페이지짜리 PDF 보고서(보유 총괄표와 레이블이 있는 자산 배분 가로 막대 그래프)로 자동 생성됩니다. 이 스킬은 Claude Code, Cursor, Codex 등 다양한 AI 에이전트 플랫폼에서 실행할 수 있는 Python 스크립트(`scripts/portfolio_calc.py` 및 `scripts/build_report_pdf.py`)로 구성되어 있으며, 입력 JSON 파일을 받아 PDF 출력을 생성합니다. 중요하게도, 이 스킬은 순수한 데이터 분석에 초점을 맞추며 매수, 매도, 교체와 같은 투자 결정을 자동으로 제안하지 않습니다. 사용자가 거래 결정을 요청할 경우 별도의 실시간 평가, 기본 분석, 보유 기간, 실제 수수료, 위험 감수 능력, 기회 비용 등이 필요함을 명확히 합니다.

지원 대상~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/retc1/skills/tree/HEAD/plugin/personal-fund-portfolio/skills/personal-fund-portfolio-analysis

즐겨 사용하는 AI에게 물어보기

이 에이전트 스킬이 미리 로드된 새 채팅을 엽니다.

문서

펀드 투자 포트폴리오 분석

목표 및 적용 범위

펀드 보유 포트폴리오에 대해 검증 가능한 금액 및 구조 분석을 수행하며, 기본적으로 검색 가능한 한국어 PDF를 제공합니다. 주식형, 혼합형, 인덱스, 채권형, 머니마켓, 상품, 금 등 모든 유형의 펀드에 적용 가능합니다. 펀드 외 자산을 포함하려면 해당 자산의 유형과 통계적 경계를 명확히 해야 합니다.

보고서는 확인된 데이터, 계산 결과 및 필요한 최소한의 설명만을 제시합니다. '핵심 판단', '지금 필요한 조치', '우선 연구', '매수/매도/교체 제안', '섹터 증감 지시' 등을 기본적으로 출력하지 않습니다. 자산 구조만으로 거래 제안을 직접 유도하지 않습니다. 사용자가 거래 결정을 요청할 경우, 실시간 평가 및 펀더멘털, 보유 기간, 실제 수수료, 위험 감수 능력, 가용 자금, 거래 기회 비용 등 증거가 필요하며, 그렇지 않으면 신뢰할 수 있는 판단이 불가능함을 명확히 하고 이론적 계산을 투자 추천으로 간주하지 않습니다.

입력 및 분류

  • 필수: 각 펀드의 코드 또는 이름, 현재 시가총액 V, 현재 보유 누적 손익 P(이익은 양수, 손실은 음수); 통화 기본값은 위안화(CNY); 계정 스냅샷 날짜를 명시해야 합니다.
  • 선택 사항: 펀드 이름, 펀드 유형, 주요 투자 카테고리, 지분 유형, 매수/매도 내역, 배당금, 수수료, 비용 세부 정보 등.
  • 이미 매도된 펀드는 현재 포트폴리오에 포함되지 않습니다. 사용자가 별도로 실현 손실을 제공하는 경우 별도로 기록하며, 현재 포트폴리오의 시가총액이나 손익에 자동으로 혼합하지 않습니다.
  • 포트폴리오 분류는 펀드 계약, 정기 보고서 및 사용자가 명확히 제공한 펀드 속성에 따라 결정됩니다. 확인할 수 없는 경우 '분류 대기'로 표시합니다. 동일한 시가총액은 하나의 주요 카테고리에만 할당할 수 있으며, 중복 통계는 금지됩니다. 분류는 펀드 상품 수준의 통계이며, 기초 증권의 실제 비율을 나타내지 않습니다.
  • 사용자가 코드만 제공하고 카테고리를 제공하지 않은 경우, 공개된 자료를 확인할 수 있습니다. 입력 날짜가 다른 경우 동일한 날짜의 실제 포트폴리오로 잘못 표시해서는 안 됩니다. 모든 보고서에는 사용자 계정 스냅샷 날짜와 외부 자료 날짜를 명확히 표시해야 합니다.
  • C = V-P는 계정 포트폴리오 손익을 기반으로 역산된 현재 포트폴리오 비용이며, 반드시 역사적 모든 현금 흐름 투자의 합계는 아닙니다. 부분 환매, 배당금, 계좌 이체 등의 경우 이 한계를 명시해야 합니다.

정밀 계산

10진수 금액 연산(Decimal)을 사용하며, 표시 시에만 반올림합니다. 최소 추가 매수 금액은 원 단위로 올림 처리합니다.

V를 현재 포트폴리오 시가총액, P를 포트폴리오 누적 손익, C=V-P, r>0을 현재 가격 대비 미래 가정된 상승 비율이라고 가정합니다.

통계 항목계산식
포트폴리오 수익률P/C
개별 손실 펀드의 추가 매수 없이 손익분기점 달성에 필요한 상승률-P/V
미래 상승률 r 가정 시 개별 손익분기점 달성에 필요한 추가 금액A=max(0,-P/r-V) (이익 시 0)
추가 매수 A 후 손익분기점 달성에 필요한 상승률-P/(V+A) (손실 시)
포트폴리오 총 시가총액, 총 손익, 총 비용ΣV, ΣP, ΣC
포트폴리오 총 수익률, 전체 추가 매수 없이 손익분기점 달성에 필요한 상승률ΣP/ΣC, 손실 시 -ΣP/ΣV
각 펀드별 손익분기점 달성을 위한 총 추가 매수 금액Σmax(0,-Pᵢ/r-Vᵢ) (이익 항목은 0)
전체 계정 손익 상계를 위한 이론적 추가 매수 금액max(0,-ΣP/r-ΣV), 모든 포트폴리오가 동일하게 r만큼 상승한다고 가정

기본 시나리오 r=10% 및 r=20%를 사용하며 사용자가 변경할 수 있습니다. 추가 매수 금액이 양수인 경우 (V+A)×(1+r)≥C+A를 정밀 소수점으로 검증합니다. 기본적으로 추가 매수 원리, 검증 예시 또는 포트폴리오 손익분기점 시나리오 설명 페이지를 출력하지 않습니다. 비전문가 독자가 바로 표를 볼 수 있도록 합니다.

PDF 고정 내용 (기본적으로 두 페이지만)

통일된 보고서 이름 및 표지 제목: 펀드 투자 포트폴리오 분석 '진단', '핵심 판단', '실행 제안' 등 다른 주요 제목을 사용하지 않습니다.

  1. 계정 개요: 스냅샷 날짜, 포트폴리오 수, 현재 시가총액, 추정 비용, 누적 손익, 전체 수익률, 전체 손익분기점 상승률. 숫자와 필수 정의만 제공하며, 투자 의견이나 반복적인 자산 구조 차트는 포함하지 않습니다.
  2. 유일한 포트폴리오 총괄표: 펀드/코드|현재 시가총액|손익 및 수익률|추가 매수 없이 손익분기점에 필요한 상승률|미래 10% 상승 시 손익분기점에 필요한 추가 금액|미래 20% 상승 시 손익분기점에 필요한 추가 금액. 표 끝에는 간단한 설명을 추가합니다: 두 열의 합계는 각 펀드별 손익분기점 달성을 위한 추정치이며, 투자 제안이 아닙니다. 손실 숫자는 빨간색, 이익은 녹색으로 표시합니다. 개별 항목 추가 매수 금액이 기본적으로 ≥10,000위안인 경우 빨간색 굵게 표시하고 고액임을 경고합니다. 사용자가 임계값을 변경할 수 있습니다. 금액은 원 단위까지 정확합니다. 충분한 증거가 없는 '현재 조치/판단' 열은 추가하지 않습니다.
  3. 포트폴리오 자산 배분: 텍스트 레이블이 포함된 자세한 가로 막대 그래프 한 세트만 유지하며, 각 행에 카테고리, 막대, 비율 및 금액을 직접 표시합니다. 카테고리는 상호 배타적이며 합계는 총 시가총액과 같습니다. 각 카테고리에 포함된 펀드, 최대 단일 포트폴리오 비중, 카테고리 통계 기준을 첨부합니다. 페이지 상단이나 차트 위에 반복적인 컬러 가로 누적 막대 그래프를 그리지 않습니다. 색상만 있고 텍스트가 없는 차트를 사용하지 않습니다.

기본적으로 포트폴리오 교체 분석, 타이밍 분석, 조정 전후 비교 또는 추론적인 섹터 증감 내용을 생성하지 않습니다. 이러한 내용은 별도의 증거 기반 거래 연구 작업에 속하며, 단순한 시가총액, 손익 및 분배 비율만으로 도출할 수 없습니다.

프레젠테이션 및 품질

  • A4 세로, 한국어, 검색 가능. 차트와 테이블의 텍스트는 명확하게 읽을 수 있으며 모바일 확대에 적합합니다. 페이지 수는 내용의 완전성에 따라 결정되며, 일부러 채우거나 확장하지 않습니다.
  • 카테고리에는 안정적인 색상을 사용하지만, 카테고리 텍스트와 숫자는 막대와 함께 직접 표시되어야 합니다. 고액 추가 매수는 빨간색으로 강조합니다. 일반 금액과 제목에는 색상을 남용하지 않습니다.
  • 원래 포트폴리오의 평가 손실이나 조건부 추가 매수 금액을 사용하여 '추가 매수 가치 있음', '매도 필요', '광범위 지수 매수' 등의 운영 의견을 유도하지 않습니다. 일반화된 시장 전망 판단을 추가하지 않습니다.
  • PDF 파일 이름: 펀드_투자_포트폴리오_분석_YYYY-MM-DD.pdf. 비교를 위해 보고서에 해당하는 스냅샷 날짜를 유지합니다.
  • 생성 후 포트폴리오 테이블과 카테고리 막대 그래프를 렌더링하여 한국어와 숫자가 겹치거나 누락되지 않는지 확인합니다. ΣC=ΣV−ΣP 및 그룹 금액 보존을 확인합니다.

생성 방법

일반 스크립트:

  • scripts/portfolio_calc.py: 10진수 정밀 계산 및 금액 검증.
  • scripts/build_report_pdf.py: JSON을 읽고, 정밀 계산 스크립트를 호출하며, 한국어 PDF를 생성합니다. --html 옵션을 지원하여 검토용 HTML을 출력합니다.

실행: python scripts/build_report_pdf.py input.json output.pdf 입력 예시 구조:

{
  "as_of": "YYYY-MM-DD",
  "currency": "KRW",
  "scenarios": ["0.10", "0.20"],
  "highlight_threshold": "10000",
  "positions": [
    {"code": "펀드코드", "name": "펀드약칭", "market_value": "현재시가총액", "pnl": "현재손익", "category": "펀드주요분류"}
  ],
  "sold_excluded": []
}

ZIP 파일에는 일반 Skill, 계산 및 PDF 스크립트만 포함되며, 사용자 포트폴리오, 과거 논의 또는 개별 사례 거래 결론은 포함되지 않습니다.

Individual skills in this repo

This repo contains 1 individual skill — each has its own dedicated page.

관련 스킬