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
+11 -2
View File
@@ -12,13 +12,13 @@
harness coding 需要的项目文档模板主要集中在 `docs/` 目录;根目录还包含 `progress.md` 执行流水模板。
后续 Codex 或其他 AI coding agent 进入使用这些模板的新项目时,应先读取仓库级规则文件,再从 `docs/00-ai-start-here.md` 开始建立上下文;该文件会继续导航到需求、技术栈、架构、编码规则、任务路线图、任务文件和当前状态。
后续 Codex 或其他 AI coding agent 进入使用这些模板的新项目时,应先读取仓库级规则文件,再从 `docs/00-ai-start-here.md` 和 `docs/agent-context.json` 建立上下文;入口文件负责流程,清单负责把任务类型路由到需求、技术栈、架构、编码规则、任务文件和当前状态。
根目录 `README.md` 和 `docs/README.md` 主要用于人类快速了解样本库和文档清单;agent 真正开始编程时,以 `docs/00-ai-start-here.md` 作为工作入口。
## 必读顺序
每次开始工作前,按顺序读取:
维护本样本库时,每次开始工作前仍按顺序完整读取:
1. `README.md`:了解本仓库用途和文档集合。
2. `docs/README.md`:了解文档导航。
@@ -27,6 +27,15 @@ harness coding 需要的项目文档模板主要集中在 `docs/` 目录;根
5. `progress.md`:理解执行流水和当前状态的职责边界。
6. 与当前任务相关的具体文档。
模板复制到业务项目后,日常会话可按最小路径读取:
1. 仓库级规则和 `docs/agent-context.json`。
2. 清单 `bootstrap.always_read` 中的文件。
3. 本轮任务文件或对应 Gitea Issue。
4. 清单中与任务类型匹配的 `routes`;重复路径只读一次。
领取任务时记录默认分支头提交为 `context_ref`;同一会话中文件 SHA 未变化时可复用已读内容,ref 变化后重新读取清单和受影响文档。
如果用户要求修改某类模板,优先阅读对应文件,不要只凭文件名猜内容。
## 工作规则