feat(context): add task-routed context manifest (phase 1)

This commit is contained in:
chengma
2026-07-14 12:07:50 +08:00
parent 56fb3a7547
commit 94ff8b7e06
11 changed files with 476 additions and 8 deletions
+12 -2
View File
@@ -8,9 +8,9 @@
第一版 MVP 只做:【列出最小闭环功能】。
## 必读顺序
## 上下文读取
每次开始写代码前,按这个顺序建立上下文:
首次接入、[`agent-context.json`](agent-context.json) 缺失或校验失败时,按这个顺序建立完整上下文:
1. [`01-vision.md`](01-vision.md):为什么做、为谁做、什么不做。
2. [`02-requirements.md`](02-requirements.md):MVP 要什么、怎么算达成。
@@ -21,6 +21,16 @@
7. [`tasks/README.md`](tasks/README.md):任务文件约定(一任务一文件);本轮任务从 `docs/tasks/` 领取。
8. [`current-state.md`](current-state.md):当前代码现实、可运行命令、下一步任务。
日常会话不需要机械重读全部文档:
1. 读取仓库级规则和 [`agent-context.json`](agent-context.json)。
2. 读取 `bootstrap.always_read`。
3. 读取本轮任务文件 / Gitea Issue。
4. 按任务类型读取 `routes` 中的文档;一个文件命中多个路由时只读一次。
5. 记录默认分支头提交为 `context_ref`;同一会话中文件 SHA 未变化时复用已读内容。
清单的使用、缓存和断连降级规则见 [`agent-context.md`](agent-context.md)。
`../progress.md` 为可选的历史归档 / 项目级大事记,仅在需要追溯早期历史时查阅。
如果仓库根目录有 `AGENTS.md`、`CLAUDE.md` 或其他 agent 规则文件,也必须先读。仓库级规则优先于项目局部建议。