feat(context): add task-routed context manifest (phase 1)
This commit is contained in:
@@ -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 变化后重新读取清单和受影响文档。
|
||||
|
||||
如果用户要求修改某类模板,优先阅读对应文件,不要只凭文件名猜内容。
|
||||
|
||||
## 工作规则
|
||||
|
||||
Reference in New Issue
Block a user