포트폴리오 구축 (안내 모드)
목표는 사용자가 템플릿의 6개 섹션과 모든 하위 카테고리로 분류된 포트폴리오 대시보드를 완성하고, 선택적으로 Excel을 다운로드할 수 있도록 하는 것입니다. 많은 사용자가 불완전한 정보를 가지고 오므로, 포트폴리오는 부분별로 구축됩니다. 각 턴마다 업로드된 내용을 처리하고, 진행 상황을 보여준 후, 다음 단계를 요청합니다.
이 스킬의 파일들 (기본 디렉토리 기준 상대 경로):
| 파일 | 용도 |
|---|---|
references/guia-paso-a-paso.md | 사용자 안내 방법: 섹션 순서, 질문 및 어조. 시작할 때 읽으세요. |
references/reglas-clasificacion.md | 각 상품의 카테고리를 결정하는 방법. 분류하기 전에 읽으세요. |
references/formato-entrada.md | 진행 상황 파일인 estado.json의 형식. |
assets/categorias.json | 유효한 카테고리 코드 ↔ 템플릿 셀. |
assets/tema.json | 대시보드의 색상 및 브랜드. |
assets/plantilla-portafolio-final.xlsx | 공식 템플릿; 수동으로 편집하지 마세요. |
scripts/generar_dashboard.py | HTML 대시보드 생성 (중간 진행 상황에서도 가능). |
scripts/llenar_plantilla.py | 템플릿을 채워 최종 Excel 생성. |
scripts/importar_excel.py | 이전에 생성된 Excel에서 진행 상황 복구. |
각 턴의 주기
-
재개 또는 시작.
- 작업 디렉토리에
estado.json이 이미 존재하면 불러옵니다. - 사용자가 이 플러그인으로 이전에 생성한 Excel을 업로드하면,
python <dir-skill>/scripts/importar_excel.py 파일.xlsx estado.json명령으로 진행 상황을 복구합니다. - 아무것도 없으면,
cliente,fecha_corte,secciones(6개 모두pendiente),posiciones: []로estado.json을 생성하고, 안내에 따라 환영 메시지를 표시합니다.
- 작업 디렉토리에
-
새로운 내용 처리. 이번 턴에 업로드된 모든 파일을 읽습니다. 각 포지션의 시장 가치, 통화, 기관 및 페이지 또는 위치를 추출합니다. 현금 및 "기타 자산" 섹션도 확인합니다. 읽을 수 없는 숫자는 추측하지 말고 질문하세요.
-
분류.
references/reglas-clasificacion.md에 따라 각 포지션에assets/categorias.json의 코드를 할당합니다. 티커, ISIN 또는 펀드를 인식하지 못하면 분류하기 전에 검색하세요. 글로벌 또는 혼합 펀드는 팩트시트에 따라 나눕니다. 명확하지 않은 모든 분류는nota에 설명하세요. -
저장. 포지션을
estado.json에 추가합니다. 동일한 계좌의 더 최신 문서가 도착하면 해당 계좌의 이전 포지션을 교체하고 알립니다. 사용자가 확인한 내용에 대해서만secciones를 업데이트합니다. -
진행 상황 표시.
python <dir-skill>/scripts/generar_dashboard.py estado.json dashboard.htmldashboard.html을 artifact로 게시합니다 (해당 도구가 있는 경우; 이후 턴에서는 동일한 artifact를 업데이트). 그렇지 않으면 파일로 전송합니다. 짧은 요약을 함께 제공합니다: 추가된 내용, 구체적인 질문 사항, 그리고 안내 체크리스트의 다음 질문. -
종료는 6개 섹션이 모두
completa또는no_aplica상태일 때:python <dir-skill>/scripts/llenar_plantilla.py estado.json "Portafolio_<이름>_<YYYY-MM-DD>.xlsx" python <dir-skill>/scripts/generar_dashboard.py estado.json dashboard.html --excel "Portafolio_<이름>_<YYYY-MM-DD>.xlsx"llenar_plantilla.py가 100이 아닌suma_pct(± 0.05)를 출력하면, 전달하기 전에 확인하세요.recalc.py가 포함된 Excel(xlsx) 스킬이 있으면, 파일을 다시 계산하고 오류가 없으며Sheet1!D94= 100%인지 확인하세요.- 대시보드를 주요 결과물로 제공하고, "Excel 다운로드" 버튼이 포함되어 있어야 합니다. Excel도 별도 파일로 제공하세요.
- 사용자에게 Excel에서 빈 열(수익률 및 목표 포트폴리오)을 직접 채우고 템플릿 제출 지침을 따라야 한다는 점을 상기시키세요.
사용자는 포트폴리오가 불완전하더라도 언제든지 Excel을 요청할 수 있습니다. 이 경우 Excel을 생성하고 누락된 섹션을 알려주세요.
규칙
- 금액을 절대 임의로 생성하지 마세요. 모든 숫자는 문서 또는 사용자로부터 비롯됩니다.
- 항상 기준일자의 시장 가치를 사용하고, 매입 원가는 사용하지 마세요.
- 백분율은 투자 포트폴리오를 기준으로 계산됩니다.
EMPRESA_PRIVADA및EXCLUIR는 해당 총계에 포함되지 않습니다. - 섹션은 사용자가 확인한 경우에만
completa또는no_aplica로 표시됩니다. - 문서에는 개인 재무 정보가 포함되어 있으므로 대화 외부로 공유하지 마세요.
- 대시보드의 색상 및 브랜드는
assets/tema.json에서 가져옵니다. 임의로 변경하지 마세요.