docs(tasks): add user shorthand command convention (H-408)

docs/tasks/README.md 新增「用户指令暗语」可选约定:触发词表
(bug:/需求:/grill:/落task/审 T-###/补/做 T-###)映射到工作流各
阶段的默认动作,含默认值说明与"采用时同步写进项目 AGENTS.md"
指引;tasks.md 登记 H-408。

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
This commit is contained in:
chengma
2026-07-09 16:57:29 +08:00
co-authored by Claude Opus 4.8
parent aee7e25d1f
commit d29802c0d0
2 changed files with 17 additions and 0 deletions
+16
View File
@@ -40,6 +40,22 @@ created: 【日期】
- **执行记录写进本任务文件的 `## 执行记录` 一节**(改了什么、跑了什么验证、结果、决策)——**不再逐任务追加共享的 `progress.md`、也不再逐任务覆盖 `current-state.md`**(那两个是每任务共享写入点,多 agent 会抢/覆盖)。
- **只改自己那个任务文件**;不要编辑别人正在做的任务文件。
## 用户指令暗语(可选约定)
> 用户的工作流通常固定为:提 bug/需求 → 讨论定案 → 落成任务文件 → 提交 → 实现 → 提交。
> 为减少重复输入,可约定以下触发词;agent 读到即按约定执行。默认值:不注明视角就是全栈工程师视角;每步产物默认提交 git(只提交本次相关文件)。
| 用户输入 | agent 执行 |
| --- | --- |
| `bug: <现象>` / `需求: <描述>` | 先查代码再给分析和方案,**只讨论不改代码** |
| `grill: <方案>` | 反方评审,逐点挑战该方案 |
| `落task` | 把已讨论定案落成 `docs/tasks/T-<编号>.md`(按上述规则查号防撞),**只写文档不写代码,写完自动提交 git** |
| `审 T-<编号>` | 先核代码事实,再审核该任务文件最近的更新是否合理、给缺口 |
| `补` | 把讨论新增的结论补进当前任务文件并提交 git |
| `做 T-<编号>` | 实现该任务 + 跑任务内验证命令 + 执行记录写进任务文件 + 提交 git |
采用时把这套暗语同时写进项目的 `AGENTS.md` 工作规则,保证所有 agent 认同一套指令;触发词可按团队习惯改名,关键是「一个词 = 一个流程阶段 + 默认动作」。
## 看板视图
- 现阶段:`ls docs/tasks/` + 看各文件 frontmatter 的 `status`/`deps` 挑任务。