diff --git a/agent-context.-.md b/agent-context.-.md new file mode 100644 index 0000000..1677861 --- /dev/null +++ b/agent-context.-.md @@ -0,0 +1,38 @@ + +> 同步来源:[`docs/agent-context.md`](/chengma/mroubao/src/commit/afc651f75a3abc2676bb13aa8a80f6aa6a25a72e/docs/agent-context.md) · commit `afc651f75a3a` + +# Agent 上下文清单 + +[`agent-context.json`](/chengma/mroubao/src/commit/afc651f75a3abc2676bb13aa8a80f6aa6a25a72e/docs/agent-context.json) 用于按任务类型读取最小上下文, +[`agent-context.schema.json`](/chengma/mroubao/src/commit/afc651f75a3abc2676bb13aa8a80f6aa6a25a72e/docs/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 可解析且所有仓库相对路径存在。