Skip to content

Repository navigation

AGENTS.md

Latest commit

 

History

History
62 lines (50 loc) · 3.59 KB

AGENTS.md

File metadata and controls

62 lines (50 loc) · 3.59 KB
Raw

AGENTS.md —— coding-agent v0.6 升级协作约定

权威计划：docs/coding-agent/coding-agent升级报告与三智能体并行开发计划-v1.md （在 guahub/interview 工作区）；本仓库内的规范与 ADR 优先于计划里过时的细节。 基线标签：v06-base（main@3933fd8 + 第 0 阶段契约，已知失败见 docs/upgrade-v06/baseline.md）。

先读：specs/（尤其 subagent.md、event.md）、docs/adr/ADR-004~006、 docs/arch-refactor/five-lang-sync.md、docs/upgrade-v06/baseline.md。

规则（对 A/B/C 全体生效）

  1. 只改下方所有权矩阵中属于你的路径；需要改其他文件时停止修改，写 docs/integration-requests/{A|B|C}.md，用本地替身绕过（测试里直接组装， 不动接线点）。
  2. 规范先于实现：实现与 specs/ 冲突时写集成请求，不得自行改规范。
  3. 先写失败测试（反例优先），确认失败再实现；一个任务一个提交。
  4. 保持零依赖；不推送、不合并；不改 Go / Rust / C#（Tier 2 冻结，ADR-004）。
  5. 不编造数据；未执行的测试不得宣称通过；单配置更差就如实写更差。
  6. 收尾输出日报：完成任务 ID / 测试命令与结果 / 阻塞 / 集成请求 / 最不自信 3 点。

所有权矩阵

路径 A B C 主线程
impls/python/** 写 — 读 审
impls/typescript/src/core/subagent*.ts、src/plugins/tools/task.ts、test/subagent*.test.ts — 写 读 审
impls/typescript/src/plugins/tools/memory_append.ts、commands/memory.ts、对应测试 — 写 — 审
evals/**（新） 读 读 写 审
conformance/scenarios/SC-011* — 写 — 审
specs/**、docs/adr/**、AGENTS.md 读 读 读 写
impls/typescript/src/ 其余文件（agentloop、registry、main 等） — 读（接线需求走集成请求） — 写（第 0 / 4 阶段）
conformance/ 其余、.github/**、README.md、ARCHITECTURE.md、five-lang-sync.md — — — 写（第 4 阶段）
`impls/go rust csharp/**` — —
docs/integration-requests/{A,B,C}.md 追加自己的 追加自己的 追加自己的 读并处理

提交规范

  • 格式：<scope>: <任务ID> <摘要>，如 python: A1 工具参数非法不再静默变 {}、 subagent: B3 子 Agent 权限交集与审批冒泡、evals: C2 运行器与隐藏测试执行。 scope 约定：A=python，B=subagent，C=evals。
  • 主线程用仓库现有格式（coding-agent(<area>): <摘要> / conformance: <摘要>）。
  • 提交正文写动机与验证证据（跑了什么命令、结果数字）；未跑的测试不写"已通过"。

日报模板（追加到各自日报文件或收尾输出）

## <日期> 日报（A|B|C）
- 完成：<任务 ID 列表，各附一句结果>
- 测试：<命令与结果数字，未跑的明说>
- 阻塞：<阻塞项与继续条件；无则写"无">
- 集成请求：<docs/integration-requests/X.md 的新增条目；无则写"无">
- 最不自信的 3 点：<具体到文件与行为>

环境注意（本机实测，见 baseline.md）

  • 一切 Python 调用必须显式 python3.13（非交互 python3 是系统 3.9，会 ImportError）；python 已链接到 3.13。
  • test:ui 基线有 13 个预存失败（F1，见 baseline.md）——它们不是你的回归， 但也不得当作"全绿"证据。
  • conformance 的 ccode DRIFT/INFRA 是预构建产物崩溃（F2），与 TS/Python 无关。