基金健诊 Skill 使用说明

0 这是什么？

基金健诊 Skill 是一个运行在 WorkBuddy（AI 编程助手）中的专属技能包，能够帮助您对客户的基金持仓进行全面诊断，自动生成专业的 Word 健诊报告，包含市场形态分析、单基金深度检视、组合风险评估、投资行为画像等内容。

ℹ️ 本 skill 依赖 qieman MCP（盈米数据接口）和 akshare MCP（市场数据）进行真实数据获取，不会使用 AI 虚构数据。

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

1 环境要求（运行前必读）

软件 / 服务	说明	备注
WorkBuddy（CodeBuddy）	本 skill 的宿主环境	需安装并登录
Python 3.8+	运行 skill 脚本	建议 3.10 或 3.11
qieman MCP	获取基金净值、持仓等数据	需在 WorkBuddy 中配置
akshare MCP	获取市场指数等行情数据	需在 WorkBuddy 中配置
python-docx	生成 Word 报告	pip 安装，见下方步骤
openpyxl	读取投资者 Excel 信息表	pip 安装，见下方步骤

ℹ️ 如果您不确定自己的电脑上是否装了 Python，可以在 WorkBuddy 中对话说"检查一下 Python 是否已安装"，AI 会帮您确认。

2 安装步骤（第一次使用必做）

1

安装 Python（如未安装）

访问 python.org/downloads 下载安装包，安装时勾选"Add Python to PATH"选项，然后一路下一步完成安装。

2

安装 Python 依赖库

打开电脑的"命令提示符"（Windows键+R，输入 cmd，回车），依次执行以下命令：

pip install python-docx openpyxl requests

✅ 如果网络较慢，可加国内镜像：pip install python-docx openpyxl requests -i https://pypi.tuna.tsinghua.edu.cn/simple

3

安装 skill 包

在 WorkBuddy 中，进入"技能中心"，选择"从本地安装"，选择 fund-diagnosis-v2.zip 文件，等待安装完成即可。

4

配置 MCP 服务（关键步骤）

在 WorkBuddy 中确认已配置 qieman 和 akshare 两个 MCP 服务。如未配置，请联系公众号"财金吃瓜党"获取配置指引。

⚠️ 未配置 MCP 时，skill 启动时会提示"MCP 依赖缺失"，无法进行数据获取和诊断。

5

准备投资者信息表

用 skill 包中的 assets/投资者信息模板.xlsx 填写客户基本信息和持仓数据，保存备用。

3 使用流程（每次诊断）

①

打开 WorkBuddy，启动对话

在对话框中，直接说"帮我做基金健诊"或"启动基金健诊 skill"，AI 会自动加载本 skill 并引导您进行下一步。

②

提供投资者信息

按照 AI 提示，将填写好的 Excel 表格路径告知 AI，或直接将文件拖入对话。

③

确认数据，启动诊断

AI 会展示从 Excel 中解析到的客户信息和持仓，请您确认无误后，回复"确认"启动诊断。

④

等待诊断完成，获取报告

诊断过程约需 2–5 分钟（取决于持仓数量）。完成后 AI 会告知 Word 报告的保存路径，直接打开即可。

ℹ️ 诊断过程中 AI 会逐步展示各阶段结果（市场形态 → 单基金检视 → 组合分析 → 行为画像），每个阶段均需您确认后才继续，确保准确性。

4 常见问题

问题	解决方法
提示"MCP 依赖缺失"	请检查 WorkBuddy 中 qieman 和 akshare MCP 是否已正确配置并启用
pip install 报错	确认 Python 已正确安装且已加入 PATH；尝试换国内镜像源
Excel 模板解析失败	请确认使用的是 skill 包内的官方模板，不要自行修改表头或工作表名称
报告生成失败	请确认 python-docx 已安装；检查输出路径是否有中文特殊字符或权限限制
基金数据获取超时	网络问题，稍后重试；或检查 qieman MCP 配置是否有效

5 Skill 文件结构说明

fund-diagnosis-v2/
├── SKILL.md                  ← Skill 定义文件（AI 读取的工作流程）
├── 使用说明.html             ← 本文件
├── 使用说明.txt              ← 纯文本版使用说明
├── assets/
│   ├── 投资者信息模板.xlsx   ← 请用此模板填写客户信息
│   └── 二维码组合-白底.png   ← 公众号 Logo（HTML 说明引用）
├── references/
│   ├── 健诊规则.json         ← 诊断标准规则库
│   ├── 字段映射.json         ← 数据字段定义
│   └── 报告模板_结构.json    ← 报告结构定义
└── scripts/
    ├── data_loader.py        ← 读取投资者 Excel
    ├── market_analyzer.py    ← 市场形态分析
    ├── fund_analyzer.py      ← 单只基金深度检视
    ├── portfolio_analyzer.py ← 组合风险分析
    ├── behavior_analyzer.py  ← 投资行为画像
    ├── report_generator.py   ← Word 报告生成（主入口）
    ├── html_report_generator.py ← HTML 预览报告生成
    └── dependency_checker.py ← MCP 依赖检查

基金健诊 Skill · 使用说明