跳到主要内容

Checkpoint: core-entrypoint-3a

日期：2026-05-13
Controller：Labs-FinTecAI Admin
Lane：knowledge-refactor
状态：Proposed

1. 本批完成​

Batch 3A 已完成 README.md 与 CONTEXT-MAP.md 的职责收束。

README.md 当前承担：

  • 仓库一句话定位；
  • Markdown 事实源与 portal / manifest / search / controller / packet 的权威性边界；
  • 五个生态对象的入口；
  • 关键边界口径；
  • 文档层级和目录角色；
  • 当前治理重构控制包入口；
  • 与 open-cowork 的关系。

CONTEXT-MAP.md 当前承担：

  • 默认进入规则；
  • 任务路由表；
  • 对象路由表；
  • 变更写回路由；
  • 使用提醒。

2. 未做事项​

  • 未修改 ACCESS_GUIDE.md 和 INDEX.md，留到 Batch 3B / 3C。
  • 未修改 docs-manifest.json、sidebars.js、llms.txt，留到 Batch 3D。
  • 未修改项目正文、FinClaw 设计包、PRD、评测、参考体验或运行日志。

3. Reader Testing 结果​

测试当前结果
新成员 3 分钟内判断仓库定位README 首屏直接说明治理知识库，不是工程仓库、聊天归档或任务系统
判断事实源README 明确 .md 是事实源，portal / Pagefind / manifest / llms / Graphiti-ready 不产生新事实
判断 Controller 和 packet 权威性README 和 CONTEXT-MAP 均明确 controllers/ 是 recovery surface，packets/ 是 coordination surface
Agent 选择最小上下文CONTEXT-MAP 按任务类型给出 3 到 5 份首批读物
不全仓库扫描README 和 CONTEXT-MAP 均保留禁止目录树起步和全仓库扫描的规则

4. 验证​

  • docs-manifest.json parse：通过。
  • git diff --check：通过。
  • DOC_CHANGE_SCOPE=ecosystem,public-entrypoints,controllers,packets,tooling npm run verify:change-scope：通过，10 个变更文件均在允许范围内。
  • npm run build：通过，Docusaurus build 成功，Pagefind 索引 126 pages。

5. 下一步​

进入 Batch 3B：重构 ACCESS_GUIDE.md。

3B 应保持以下边界：

  • 按角色和任务意图给出 3 到 5 份最小读物；
  • 不复制 INDEX.md 的完整目录；
  • 不复制项目正文；
  • 保留人类、个人域 Agent、团队域 Agent、Program Controller、外部协作者的不同使用方式；
  • 若修改机器路由或门户导航，等 3D 统一处理。