aifinlab Root Skills Taxonomy Execution Plan
状态：Accepted Initial Plan / 并行启动，独立于 V1 工程化主线
日期：2026-05-16
项目：FinClaw
文档级别：参考体验级独立执行计划
对象：/Users/mlabs/Programs/aifinlab-FinClaw 的 skills/ 目录（982/1022 个 OpenClaw root SKILL.md）
上游决策：v1-engineering-kickoff-decisions.md D-09
执行方：Codex CLI（异步）
回写位置：本目录 aifinlab-root-skills-taxonomy.md（按 batch 增量更新；尚未创建）
1. Purpose
aifinlab-FinClaw 的 60 个精选 skills 已经完成 9 个 batch 的评测（见 aifinlab-skill-layer-evaluation.md）并已产出 MVP 白名单 12 个、5 类产品对象映射。
其 skills/ 根目录还剩约 982 个 SKILL.md（大小写不敏感口径 1022）未做正式分类。本执行计划的目的是：
- 不全量逐个阅读或执行这些 root skills；
- 按目录画像 + metadata 抽取 + 抽样深入 + 按类聚合的方式产出一个对 FinClaw 长期版本（V2+）有参考价值的 Skills Taxonomy；
- 与 V1 工程化主线完全解耦，不作为 V1 任何里程碑的阻塞项；
- 异步运行，定期回写到治理库本目录。
2. Non-Goals
- 本计划不为 V1 提供新的 Fin Skill 候选（V1 的 7 个 Skill 已锁定）；
- 本计划不执行 982 个 SKILL.md 的脚本运行（与 aifinlab-skill-layer-evaluation.md Track B/C 的边界一致）；
- 本计划不承担参考项目代码修复 / 上游 PR 等责任；
- 本计划不评判参考项目原作者的产品判断。
3. Scope
3.1 数据源（仅静态读取）
- 目录路径：
/Users/mlabs/Programs/aifinlab-FinClaw/skills/ - 每个 SKILL.md 抽取：
- 一级目录名（taxonomy bucket 候选）；
- SKILL.md 的 YAML frontmatter（如有）；
- SKILL.md 的标题 + 第一段；
- 是否存在
scripts/或script/子目录； - 是否存在
requirements.txt/requirements.json； - 是否引用真实金融数据源（AkShare / Tushare / yfinance / SEC / etc.）。
3.2 抽样深入
- 每个 taxonomy bucket 抽样 3-5 个 SKILL.md 全文阅读；
- 抽样规则：优先选 frontmatter 完整 + 有 scripts + 描述清晰的；
- 不修代码、不运行脚本（与既有评测边界一致）。
4. Batch Plan
按 aifinlab-skill-layer-evaluation.md §4 Root Skills 初步分桶为基础，分 5 个 batch 异步处理：
| Batch | Bucket（近似数量） | 重点回答 |
|---|---|---|
| B1 | A-share market / quant / strategy (~174) | 是否值得作为 V2 证券扩展的 Skill 候选源 |
| B2 | Bank / banking workflows (~135) | 机构金融 workflow 的可吸收 taxonomy |
| B3 | Risk + Legal/Compliance + Filing (~80) | 风险与合规 Skill 的命名 / 字段 / 边界 |
| B4 | Fund + Trust + Portfolio (~64) | 产品筛选 / 配置 / 投后认知的字段候选 |
| B5 | Client / Sales / Marketing + 全局检索 / 产品 / 场景 utilities (~90) | 是否值得作为「外围工作流 Skill」的候选 |
每个 batch 独立交付，不等待前一 batch 完成。
5. Per-Batch Deliverables
每个 batch 产出一份子文档：
reference-experience/
└── aifinlab-root-skills-taxonomy/
├── README.md
├── batch-1-ashare-quant.md
├── batch-2-bank.md
├── batch-3-risk-compliance.md
├── batch-4-fund-trust-portfolio.md
└── batch-5-client-utilities.md
每份子文档包含：
| 字段 | 内容 |
|---|---|
| Bucket Inventory | 该 bucket 下所有 SKILL.md 的目录名 + 一句话描述 |
| Naming Patterns | 命名约定 / 后缀模式 / 共享前缀 |
| Capability Surface | 该 bucket 的能力覆盖面摘要 |
| Sampled Deep-Read | 抽样 3-5 个 SKILL 的全文要点 |
| FinClaw V2+ 吸收判断 | per-skill 标注：可直接复用 / 重设计后可复用 / 仅作参考 / 排除 |
| Boundary Risks | 是否包含执行 / 资产发行 / 自动调仓等需要 FinClaw 排除的能力 |
| Open Questions | 该 bucket 留待未来回答的问题 |
最终所有 batch 完成后产出 roll-up 文档：
reference-experience/aifinlab-root-skills-taxonomy.md
包含：跨 batch 命名规范、跨 bucket 共性、整体吸收矩阵、对 FinClaw V2+ 的 Skill 候选短名单。
6. Execution Contract
6.1 执行方与节奏
| 项 | 设定 |
|---|---|
| 执行方 | Codex CLI（异步 background） |
| 触发方式 | 项目发起人在 Codex 中执行 codex exec + 本文链接 |
| 节奏 | 每个 batch 预估 1-2 小时；5 个 batch 可在 1-2 天内完成 |
| 中断 | 任一 batch 中断后可从该 batch 重启，不影响其他 batch |
| 并行度 | 5 个 batch 内部不并行；batch 之间可串行或并行（Codex 决定） |
6.2 工具与边界
- 工具：只读 Read / Glob / Grep；
- 禁止：修改参考项目代码、运行参考项目脚本、推送任何 git 操作；
- 写入边界：仅在治理库
reference-experience/aifinlab-root-skills-taxonomy/与本计划的 roll-up 文档； - 不调用 LLM 推理（除非 Codex 自身 reasoning 需要），不消耗 V1 的 model budget；
- 不接入 FinClaw V1 工程仓库。
6.3 Telemetry
每个 batch 完成时记录：
- 起止时间；
- 该 batch 阅读的 SKILL.md 数量；
- 抽样深入的 SKILL.md 数量；
- 产物字数；
- 遇到的 anomaly（损坏的 SKILL.md / 异常 frontmatter / 异常依赖等）。
7. Success Criteria
| 标准 | 衡量 |
|---|---|
| 覆盖度 | 5 个 batch 全部完成；roll-up 文档定稿 |
| 准确度 | 每个 bucket 的描述与抽样深入一致；不引入未在 SKILL.md 出现的能力 |
| 可复用 | FinClaw V2+ 评估 Skill 扩展时，可直接从 roll-up 拿候选短名单 |
| 边界 | 任何 root skill 都没有通过本计划进入 V1 Fin Skills 列表（与 D-09 一致） |
| 时效 | 全部 batch 在 2 周内完成（建议；非硬性 SLA） |
8. Open Items
- Codex CLI 具体启动命令模板（待项目发起人在 Codex 个人域调度时确定）；
- Bucket 划分粒度是否需要进一步细化（建议在 B1 完成后回顾）；
- 是否需要把 root skills 与 v1-skills-domain-knowledge-review-packet.md §3.1 的 7 个 V1 Skill 做交叉对照（建议在 roll-up 阶段做）；
- 是否在 roll-up 完成后启动 Track C（小批量抽样脚本执行），由后续决策决定。
9. Hand-off Note
启动本计划时建议给 Codex 的 prompt 简版：
读取本治理库文档
projects/finclaw/reference-experience/aifinlab-root-skills-taxonomy-execution-plan.md，按 §4 Batch Plan 与 §5 Per-Batch Deliverables 依次执行 batch 1-5。 工具限制：只读 Read / Glob / Grep，不运行任何脚本，不修改参考项目代码。 写入边界：治理库projects/finclaw/reference-experience/aifinlab-root-skills-taxonomy/。 完成每个 batch 后立即产出对应子文档；5 个 batch 完成后再产出 roll-up 文档。
详细 prompt 由项目发起人在调度时按需扩展。
10. References
- aifinlab-skill-layer-evaluation.md（前置 Track A 评测结果）；
- aifinlab-team-alignment-brief.md（团队认知对齐 brief）；
- aifinlab-personal-domain-review-checklist.md（个人域复核清单）；
- v1-engineering-kickoff-decisions.md D-09；
- 参考项目本地路径：
/Users/mlabs/Programs/aifinlab-FinClaw/skills/。