From 7a693713157efd8ea80b76c60c9da3652183b52d Mon Sep 17 00:00:00 2001 From: chengma Date: Thu, 9 Jul 2026 16:49:42 +0800 Subject: [PATCH] docs(agents): add user shorthand commands to work rules MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit 工作规则新增用户指令暗语：bug:/需求:（查码分析不改代码）、 grill:（反方评审）、落task（定案落文档并自动提交）、审 T-### （核实后审核任务更新）、补（补结论并提交）、做 T-###（实现+ 验证+执行记录+提交）。默认全栈视角、只提交本次相关文件。 Co-Authored-By: Claude Opus 4.8 --- AGENTS.md | 7 +++++++ 1 file changed, 7 insertions(+) diff --git a/AGENTS.md b/AGENTS.md index 7270b6e..eaaa266 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -31,6 +31,13 @@ - CDP 选择器 / 流程 / 配置 schema 变化，必须同步更新 `docs/04-architecture.md` 与相关任务。 - **新任务一任务一文件写进 `docs/tasks/T-<编号>.md`，不再手改 `docs/06-tasks.md`**（已冻结为 T-000~T-549 历史归档）；命名/frontmatter/领取规则见 `docs/tasks/README.md`。为避免多 agent 并发抢改同一文件、ID 撞号。 - 改完后**只更新对应任务文件**：把状态改 `DONE`、执行记录写进该任务文件的 `## 执行记录` 一节。**不再逐任务追加 `progress.md`、不再逐任务覆盖 `docs/current-state.md`**（这两个是每任务共享写入点，多 agent 并发会互相抢/覆盖）。`progress.md` 冻结为历史归档；`docs/current-state.md` 不再手动逐任务维护，当前状态以 `docs/tasks/` 各任务 frontmatter 为准，后续可由脚本汇总生成。 +- **用户指令暗语**（用户输入以下触发词时按约定执行，默认全栈工程师视角、只提交本次相关文件）： + - `bug: <现象>` / `需求: <描述>` → 先查代码再给分析和方案，**只讨论不改代码**； + - `grill: <方案>` → 反方评审，逐点挑战该方案； + - `落task` → 把已讨论定案落成 `docs/tasks/T-<编号>.md`（按上述规则查号防撞），**只写文档不写代码，写完自动提交 git**； + - `审 T-<编号>` → 先核代码事实，再审核该任务文件最近的更新是否合理、给缺口； + - `补` → 把讨论新增的结论补进当前任务文件并提交 git； + - `做 T-<编号>` → 实现该任务 + 跑任务内验证命令 + 执行记录写进任务文件 + 提交 git。 ## 安全红线