feat(context): add task-routed context manifest (phase 1)
This commit is contained in:
@@ -19,24 +19,28 @@
|
||||
| `AGENTS.md` | 仓库级 agent 入口和总规则 |
|
||||
| `CLAUDE.md` | Claude Code 薄入口,指向 `AGENTS.md` |
|
||||
| `docs/00-ai-start-here.md` | 每轮开工流程 |
|
||||
| `docs/agent-context.json` | 按任务类型选择本轮上下文 |
|
||||
| `docs/agent-context.schema.json` | 上下文清单结构契约 |
|
||||
| `docs/agent-context.md` | 清单读取、缓存和断连降级规则 |
|
||||
| `docs/05-coding-rules.md` | 编码纪律和验证底线 |
|
||||
| `docs/06-tasks.md` | 任务路线图(阶段、里程碑、待办池) |
|
||||
| `docs/tasks/` | 默认任务管理:一任务一文件(`README.md` + `_template.md`) |
|
||||
| `docs/current-state.md` | 当前实现状态快照 |
|
||||
| `init.sh` 或 `init.ps1` | 标准启动与验证入口,按操作系统二选一 |
|
||||
| `scripts/validate_agent_context.py` | 零第三方依赖校验清单和引用路径 |
|
||||
|
||||
推荐随后补齐:`docs/01-vision.md`、`docs/02-requirements.md`、`docs/03-tech-stack.md`、`docs/04-architecture.md`、`docs/api.md`、`docs/routes.md`、`docs/clean-state-checklist.md`;`progress.md` 可选(历史归档 / 项目级大事记)。
|
||||
|
||||
## 接入步骤
|
||||
|
||||
1. 确认仓库根目录,读取已有 `README`、运行脚本、测试配置和主要入口文件。
|
||||
2. 复制最小接入文件,并把所有 `【占位符】` 替换成当前项目事实。
|
||||
2. 复制最小接入文件,把所有 `【占位符】` 替换成当前项目事实,并按项目任务类型调整 `agent-context.json` 的路由。
|
||||
3. 在 `docs/current-state.md` 写清真实目录、真实启动命令、真实验证命令、当前 blocker。
|
||||
4. 在 `docs/03-tech-stack.md` 固定已经实际使用的技术栈,不确定项标为“待定”,不要让 agent 自行选择。
|
||||
5. 在 `docs/04-architecture.md` 记录当前代码的真实模块边界;不清楚的地方标为“待确认”。
|
||||
6. 在 `docs/06-tasks.md` 只放下一阶段能小步交付的建议任务,不要把历史愿望清单全部搬进去;第一轮任务按 `docs/tasks/README.md` 落成 `docs/tasks/T-<编号>.md`。
|
||||
7. 配置 `init.sh` 或 `init.ps1` 顶部三个命令,让它能安装依赖、运行基础验证、打印启动命令。
|
||||
8. 运行标准验证;如果失败,第一轮任务应先修基线,不做新功能。
|
||||
8. 运行 `python scripts/validate_agent_context.py` 和项目标准验证;如果失败,第一轮任务应先修基线,不做新功能。
|
||||
9. 把接入过程、验证结果写进第一轮任务文件的 `## 执行记录`,遗留 blocker 同步到 `docs/current-state.md`。
|
||||
|
||||
## 第一轮 agent 任务建议
|
||||
@@ -61,4 +65,4 @@
|
||||
- 不要一次性把所有模板都填满;先让入口、当前状态、任务和验证路径可用。
|
||||
- 不要把聊天记录当事实来源。
|
||||
- 不要为了让验证通过而降低测试或验收标准。
|
||||
- 不要在接入 harness 的同一轮顺手重构业务代码,除非是修复启动或验证基线所必需。
|
||||
- 不要在接入 harness 的同一轮顺手重构业务代码,除非是修复启动或验证基线所必需。
|
||||
|
||||
Reference in New Issue
Block a user