建立投資組合（引導模式）
目標是讓使用者最終獲得一個依模板六大分類及其所有子類別歸類好的投資組合儀表板，並可選擇下載 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 archivo.xlsx estado.json還原進度。 - 如果都沒有，則建立一個包含
cliente、fecha_corte、secciones（6 項皆為pendiente）及posiciones: []的estado.json，並根據指南中的方式進行歡迎與引導。
- 如果工作目錄中已有
-
處理新資料。 讀取使用者所有於此回合上傳的檔案。提取每個部位及其市值、貨幣、機構與頁面或位置。同時檢查現金及「其他資產」部分。請勿猜測無法辨識的數字：應向使用者提問。
-
分類。 根據
references/reglas-clasificacion.md的規則，為每個部位從assets/categorias.json中分配一個代碼。如果無法辨識 Ticker、ISIN 或基金，請先查詢資訊再進行分類。根據 Factsheets 將全球型或混合型基金拆分成細項。對於非顯而易見的分類，請在nota欄位中說明。 -
儲存。 將部位新增至
estado.json。如果收到同一帳戶的更新文件，則取代該帳戶的舊部位並通知使用者。僅在使用者確認後，才將secciones更新為completa或no_aplica。 -
顯示進度。
python <dir-skill>/scripts/generar_dashboard.py estado.json dashboard.html如果你有發布 artifacts 的工具，請將
dashboard.html發布為 artifact（後續回合則更新同一個 artifact）；否則，將其作為檔案發送。同時附上一份簡短摘要：新增了哪些內容、待澄清的問題以及下一步提問（根據指南中的檢查清單）。 -
完成 當所有 6 項分類狀態皆為
completa或no_aplica時：python <dir-skill>/scripts/llenar_plantilla.py estado.json "Portafolio_<Nombre>_<AAAA-MM-DD>.xlsx" python <dir-skill>/scripts/generar_dashboard.py estado.json dashboard.html --excel "Portafolio_<Nombre>_<AAAA-MM-DD>.xlsx"- 如果
llenar_plantilla.py印出的suma_pct與 100 的差異超過 ±0.05，請先檢查後再交付。 - 如果你擁有 Excel 技能（xlsx）並使用
recalc.py，請重新計算檔案並確保無錯誤，且Sheet1!D94等於 100%。 - 以儀表板作為主要結果交付，其中包含「下載 Excel」按鈕，同時將 Excel 檔案作為獨立附件一併提供。
- 提醒使用者需要在 Excel 中填寫空白欄位（報酬率與目標投資組合），並遵循模板中的寄送指示。
- 如果
使用者可以隨時要求下載 Excel（即使尚未完成）：按需求生成並告知缺少哪些分類。
規則
- 絕對不要虛構金額。 所有數字必須來源於文件或使用者本人。
- 始終使用截止日期的市值，而非成本。
- 百分比是基於投資組合總值計算；
EMPRESA_PRIVADA和EXCLUIR不納入總值。 - 只有當使用者確認後，才將分類標記為
completa或no_aplica。 - 文件包含個人財務資料：請勿在對話外分享。
- 儀表板的顏色與品牌設定來自
assets/tema.json；請勿自行更改。