From 9827c8c6d8474ca909383ccc9295869e8ac04471 Mon Sep 17 00:00:00 2001 From: chengma Date: Thu, 9 Jul 2026 17:15:14 +0800 Subject: [PATCH] docs(agents): harden shorthand commands (green-only commit, git-diff review, backlog, authority) MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit 暗语条目补四个缺口：做 T-### 验证全绿才提交、红灯报告不提交； 审 T-### 以 git 历史定位最近改动；新增 记backlog: 触发词； 落task/补 可带参数、无上下文必须先问不得猜。声明本条目为 唯一权威源，记忆/模板副本仅为指针。 Co-Authored-By: Claude Opus 4.8 --- AGENTS.md | 7 +++++-- 1 file changed, 5 insertions(+), 2 deletions(-) diff --git a/AGENTS.md b/AGENTS.md index eaaa266..0f115db 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -35,9 +35,12 @@ - `bug: <现象>` / `需求: <描述>` → 先查代码再给分析和方案，**只讨论不改代码**； - `grill: <方案>` → 反方评审，逐点挑战该方案； - `落task` → 把已讨论定案落成 `docs/tasks/T-<编号>.md`（按上述规则查号防撞），**只写文档不写代码，写完自动提交 git**； - - `审 T-<编号>` → 先核代码事实，再审核该任务文件最近的更新是否合理、给缺口； + - `审 T-<编号>` → **以 git 历史为准**（`git log -p docs/tasks/T-<编号>.md` 找出最近改动），先核代码事实，再审核该改动是否合理、给缺口； - `补` → 把讨论新增的结论补进当前任务文件并提交 git； - - `做 T-<编号>` → 实现该任务 + 跑任务内验证命令 + 执行记录写进任务文件 + 提交 git。 + - `做 T-<编号>` → 实现该任务 + 跑任务内验证命令；**验证全绿才提交**（执行记录写进任务文件、状态改 DONE、提交 git）；验证失败 → 报告结果、**不提交**、状态留 DOING 或标 BLOCKED 记原因； + - `记backlog: <一行>` → 追加进 `docs/06-tasks.md` 待办池并提交（只记一行，不建任务文件）。 + - 上下文规则：`落task`/`补` 可带参数（如 `落task <主题>`、`补 T-<编号>`）；新会话或无对话上下文时**必须先问清指代对象，不得猜**。 + - 本条目是这套暗语的**唯一权威源**；agent 记忆和模板库中的副本仅为指针/种子，以此处为准。 ## 安全红线