36 lines
1.3 KiB
Markdown
36 lines
1.3 KiB
Markdown
|
# Agent 上下文清单
|
||
|
|
|
||
|
|
[`agent-context.json`](agent-context.json) 用于按任务类型读取最小上下文，
|
||
|
|
[`agent-context.schema.json`](agent-context.schema.json) 约束其结构。
|
||
|
|
|
||
|
|
## 使用流程
|
||
|
|
|
||
|
|
```text
|
||
|
|
AGENTS.md
|
||
|
|
-> agent-context.json
|
||
|
|
-> bootstrap.always_read
|
||
|
|
-> 当前任务文件
|
||
|
|
-> 一个或多个 routes
|
||
|
|
-> 代码发现、实现、验证
|
||
|
|
```
|
||
|
|
|
||
|
|
- 同一文件命中多个 route 时只读一次。
|
||
|
|
- 首次接入、清单缺失或校验失败时，按 `00-ai-start-here.md` 完整顺序读取。
|
||
|
|
- 仓库未启用 Git 时不能假装存在 `context_ref`；任务 frontmatter 保持 `null`。
|
||
|
|
- Git 启用后，领取时记录默认分支头 SHA；同一会话文件内容未变可复用。
|
||
|
|
- 当前代码和真实命令结果高于历史讨论、计划命令和旧截图。
|
||
|
|
- 远端协调不可用时可以继续已领取任务，但不领取新任务，也不猜测其他执行者状态。
|
||
|
|
|
||
|
|
## 权威来源
|
||
|
|
|
||
|
|
| 信息 | 权威来源 |
|
||
|
|
| --- | --- |
|
||
|
|
| 仓库硬规则 | 最近作用域的 `AGENTS.md` |
|
||
|
|
| 产品范围 | `02-requirements.md` |
|
||
|
|
| 架构和状态机 | `04-architecture.md` |
|
||
|
|
| API 字段 | `api.md` |
|
||
|
|
| 任务规格、状态和证据 | `docs/tasks/T-<编号>.md` |
|
||
|
|
| 当前现实 | `current-state.md`、代码和实际验证 |
|
||
|
|
|
||
|
|
修改清单引用的路径时，必须验证 JSON 可解析且所有仓库相对路径存在。
|