════════════════════════════════════════════════════════════
  基金健诊 Skill 使用说明  v3.1
════════════════════════════════════════════════════════════

本 Skill 是一个运行在 WorkBuddy 中的纯提示词技能包（不携带任何可执行
脚本），用于对客户的基金持仓做系统化健诊，输出专业的健诊报告。

⚠ 本工具仅供研学和内部参考，不构成任何投资建议。
  最终诊断结论请由持证专业人员审核后使用。

────────────────────────────────────────────────────────────
【0】v3.1 有什么变化
────────────────────────────────────────────────────────────
· 移除全部 Python 脚本，改为纯提示词 + 规则库驱动
· 报告由 AI 直接生成（HTML 优先；需要 Word 时可调用平台内置文档技能），
  无需安装任何运行环境或依赖库
· 不再需要 Python 环境，装好即可用

────────────────────────────────────────────────────────────
【1】运行前需要准备什么
────────────────────────────────────────────────────────────

  项目                  说明
  ─────────────────────────────────────────────
  WorkBuddy             本 Skill 的宿主环境，需安装并登录
  金融数据连接器         基金数据推荐「盈米基金」（yingmi-mcp）；
                        行情/宏观可用东方妙想、同花顺或 neodata
                        （连接后自动使用，无需任何安装）
  投资者信息表           可直接使用 assets/投资者信息模板.xlsx，
                        或在对话中直接告知客户信息

说明：本 Skill 全程零安装、零配置，不需要 pip，也不需要 Python。

────────────────────────────────────────────────────────────
【2】使用步骤
────────────────────────────────────────────────────────────

步骤 1 ▶ 连接数据源（推荐）
  在 WorkBuddy 的「连接器」面板接通金融数据连接器
  （基金数据推荐「盈米基金」；行情/宏观可接东方妙想、同花顺或 neodata）。

  ℹ 未连接连接器不会阻塞流程：Skill 会按「外部数据解析阶梯」提醒你在
   WorkBuddy 中接通连接器；如坚持先行则降级为网络搜索，并在报告中
   如实标注数据来源与置信度。

步骤 2 ▶ 准备投资者信息
  使用 assets/投资者信息模板.xlsx 填写，或在对话中直接提供：
  · 客户信息：姓名、年龄、称谓、风险等级、最大可接受回撤、
    预期年化收益率、权益/固收/货币目标占比、资金用途
  · 持仓基金：基金代码、基金名称、持有份额

步骤 3 ▶ 发起健诊
  在对话框输入：「帮我做基金健诊」或「启动基金健诊」。

步骤 4 ▶ 确认信息
  AI 会展示解析到的客户信息与持仓，确认无误后回复「确认」即开始诊断。
  （此步必做，未确认不会进入取数环节）

步骤 5 ▶ 获取报告
  诊断完成后，AI 直接输出健诊报告：
  · 默认 HTML 版本，可在浏览器中预览、截图入稿
  · 如需 Word 版本，直接说「输出 Word 版」，由平台内置文档技能生成

────────────────────────────────────────────────────────────
【3】健诊流程（9 步）
────────────────────────────────────────────────────────────
  1 收集投资者信息
  2 整理确认投资者信息
  3 分析当前市场形态
  4 获取基金数据（走已接通连接器）
  5 单只基金深度检视
  6 组合检视
  7 投资者行为检视
  8 报告撰写
  9 交付与存档

  检视维度：类型适配性、成立时间、规模、业绩（含同类四分位）、
  风险指标（夏普 / 最大回撤 / α / β）、基金经理、非业绩风险、
  组合分散度、配置偏离度、投资者行为匹配度。

────────────────────────────────────────────────────────────
【4】常见问题
────────────────────────────────────────────────────────────

问题：提示「数据源不可用」
解决：在 WorkBuddy 连接器面板接通金融数据连接器（基金推荐「盈米基金」）。
      本 Skill 不依赖任何本地运行环境，无需额外安装。

问题：Excel 模板解析失败
解决：请使用包内官方模板，不要修改表头或工作表名称；
      或将信息直接在对话中告知 AI。

问题：需要 Word 版报告
解决：直接说「输出 Word 版」。本 Skill 已移除报告生成脚本，
      Word 由 WorkBuddy 平台内置的文档技能生成。

问题：基金数据获取超时
解决：网络问题，稍后重试；Skill 会自动降级到其他可用数据源并在报告中
      标注来源。

────────────────────────────────────────────────────────────
【5】Skill 文件结构
────────────────────────────────────────────────────────────

fund-diagnosis-pro/
├── SKILL.md                    Skill 定义文件（AI 读取的工作流程）
├── 使用说明.html               HTML 版使用说明（推荐）
├── 使用说明.txt                本文件
├── CHANGELOG.md                版本变更记录
├── assets/
│   └── 投资者信息模板.xlsx      请用此模板填写客户信息
└── references/
    ├── 健诊规则.json            诊断标准规则库
    ├── 字段映射.json            数据字段定义
    ├── 报告模板_结构.json        报告结构与字段清单
    └── 报告样式规范.md           报告视觉规格（配色/字体/组件）

────────────────────────────────────────────────────────────
  仅供研学，请审慎使用
════════════════════════════════════════════════════════════
