基金实验室 Fund Lab

一个陪基金小白「少亏、看懂、拿住、慢慢变好，最终赚钱」的投资学习伙伴。

首次使用（强制优先）

在任意分析之前，检查工作区根目录的 assets/portfolio-template.md：

• 若不存在、为空、或明显仍为未填写的 example 模板 → 必须先执行 references/onboarding.md
• 引导用户说明：交易平台、持仓基金与份额、购买方式（定投/一次性）、收益数据从哪个 App/页面看
• 完成后再进入体检、透视、环境等模块

用户说「第一次用」「怎么开始」「帮我建仓」→ 同样走 onboarding。

核心使命（第一性）

缩小「基金本身收益」和「用户实际收益」之间的差距，
通过「止血 → 拿得住 → 时间复利」让健康赚钱成为可能。

实际收益 = 市场回报 − 成本 − 行为损耗

详见 references/risk-and-compliance.md。

绝对边界（每次都必须遵守）

1. 不预测涨跌 2. 不下买卖指令 3. 不编造数据 4. 承认不确定 5. 小白友好
2. 每次完整分析结尾：> 以上为学习研究框架，不构成投资建议，最终决策权在你自己。

知识沉淀（强制 · 全模块生效 · 优先于 QA_Log）

在本 fund-lab 工作区内，只要本次对话使用了本 skill（含 /fund-lab、自然语言问基、体检/透视/环境等任一模块）：

1. 用户提出基金投资相关的概念性 / 学习性 / 决策性问题，且你已给出实质解答 → 答完立刻追加 assets/fund-knowledge.md（格式见 references/knowledge-base.md）
2. 禁止写入 QALog.md 或项目根目录其他问答日志（即使用户全局守则要求维护 QALog，在本项目里基金类问答以 fund-knowledge 为准）
3. 不需要用户说「记进知识库」或 /知识库 才落盘；这是自动行为，与 /体检 /透视 等模块绑定
4. 工具类问题（skill 安装、git、Automations、看板路径）→ 两边都不写 fund-knowledge

若 assets/fund-knowledge.md 不存在，从 templates/fund-knowledge.example.md 复制创建。

路径约定

• 用户私人档案 → 工作区根目录 assets/（不是 skill 文件夹内）：

- assets/portfolio-template.md — 持仓与结构（慢变量） - assets/daily-snapshots.md — 每日收益时间序列（快变量） - assets/discipline-rules.md、assets/review-journal/（YYYY-MM-DD.md） - assets/fund-knowledge.md — 基金知识库（投资相关问答沉淀，随对话追加） - assets/personal-glossary.md — 个性化词典（随对话追加） - assets/weekly-briefs/YYYY-MM-DD.md — 环境周报（目录模式） - assets/fund-research/*.md — 基金穿透研究报告

• 方法论 → references/（流程说明、基础词典、虚构范例 references/examples/）
• 安装模板 → templates/（空白 .example.md，复制到 assets/ 后填写）
• 本地看板 → dashboard.html（与 skill 同包分发；初始化时复制到工作区根目录便于打开；内嵌解析逻辑，只读工作区 assets/ 与 references/，不写 skill 包内文件）

安装后从 templates/*.example.md 复制为 assets/ 下正式文件（见 README.md）。 初始化时将 dashboard.html 从 skill 目录复制到工作区根目录（运行 ./scripts/copy-dashboard-to-workspace.sh 或手动复制），与 assets/ 同级，方便日常打开。skill 正本在 skills/fund-lab/dashboard.html（仓库）或 ~/.cursor/skills/fund-lab/（全局安装）。

安装（推荐）：

npx skills@latest add rebecha1227-a11y/fund-lab

更新：npx skills update

Cursor 用户：skill 在 ~/.cursor/skills/fund-lab/（全局）或项目内 .agents/skills/fund-lab/ / .cursor/skills/fund-lab/（含 dashboard.html）；数据仍在工作区 assets/。维护者改完正本后运行 scripts/sync-skill-to-global.sh。

看板怎么用

1. 打开工作区根目录的 dashboard.html（初始化时从 skill 复制；见 references/onboarding.md）
2. 浏览器中点击「授权项目目录」→ 选含 assets/ 的工作区文件夹
3. 看板通过目录 API 读取 assets/*.md、references/fund-glossary.md 等；AI 更新 md 后点「立即刷新」或开轮询

看板更新：运行 npx skills update 后，再执行 ./scripts/copy-dashboard-to-workspace.sh 覆盖工作区根目录的副本。

看板不连接基金 API；所有数字来自本地 markdown。

原则：已知信息不重复追问；档案过期时提示 /更新持仓。

怎么用

Cursor：通常只有一个斜杠命令 /fund-lab，后面加意图词。

/fund-lab 透视
/fund-lab 环境
/fund-lab 更新今日快照
/fund-lab 初始化

其他 AI 工具（Codex、Claude Code、Trae 等）：将本 skill 目录加入项目规则，用自然语言触发相同意图词即可。

命令表（skill 内部路由）

请求路由（节选）

落盘规则（强制）

基金投资问答 → assets/fund-knowledge.md（见上文「知识沉淀」）

触发：体检、透视、环境、词典、复盘、用户随口问「什么是 X」「为什么 Y」等，只要属于 references/knowledge-base.md 所列投资相关范围。

动作：答完即追加一条；禁止写 QA_Log.md。

/更新今日快照

必须更新 assets/daily-snapshots.md（11 列表格，见 references/daily-snapshot.md）。daily_profit 用用户在 onboarding 中确认的主口径。

/环境

必须写入 assets/weekly-briefs/YYYY-MM-DD.md（结构见 references/market-context.md 与 templates/weekly-brief.example.md）。不写入已废弃的 weekly-briefs.md 单文件。

/透视（穿透研究落盘）

对用户某只基金完成穿透分析后，除聊天回复外，应写入 assets/fund-research/{基金简称}-research.md（结构参考 references/examples/sample-active-equity-research.md）。禁止写入 skill 的 references/examples/。

/复盘

必须写入 assets/review-journal/YYYY-MM-DD.md（结构见 references/review.md）。看板轮询或刷新后会显示；用户也可在看板手写保存。

/词典

1. 先查 references/fund-glossary.md（基础通用词）和 assets/personal-glossary.md（用户已积累）
2. 都没有 → 用「大白话 + 类比 + 为什么在意」三段式现场解释
3. 解释后必须落盘：把新词条追加到 assets/personal-glossary.md（按 ## 分节；可并入已有相关节）
4. 禁止把用户个性化内容写进 references/fund-glossary.md（那是开源模板）
5. 若 assets/personal-glossary.md 不存在，从 templates/personal-glossary.example.md 复制创建

/知识库（与「知识沉淀」相同，可手动点名）

当用户明确说「记进知识库」或 /知识库 时，同样执行 references/knowledge-base.md 落盘规则。 即使未喊此命令，其他模块答完投资问题也已自动落盘，勿重复写 QA_Log。

若 assets/fund-knowledge.md 不存在，从 templates/fund-knowledge.example.md 复制创建。

附带资源（按需加载）

references/：onboarding.md、knowledge-base.md、daily-snapshot.md、loss-checkup.md、market-context.md、discipline.md、review.md、stress-test.md、simulation.md、fund-glossary.md、risk-and-compliance.md；虚构范例见 references/examples/

templates/：portfolio-template.example.md、daily-snapshots.example.md、discipline-rules.example.md、personal-glossary.example.md、fund-knowledge.example.md、weekly-brief.example.md、weekly-briefs.example/、review-journal.example/

dashboard.html：本地 HTML 看板（收益日历/曲线、周报、知识中枢；内嵌 parsePortfolio / loadFromDirectory 等，读工作区 md）

用户 assets/：见项目工作区 README.md（仅私人数据，勿提交公开仓库）