From fff33e44e1ffe39681ff42e4ac05529e973d1cd6 Mon Sep 17 00:00:00 2001 From: ila Date: Mon, 10 Aug 2026 01:06:14 +0800 Subject: [PATCH] =?UTF-8?q?docs:=20=E5=AE=9A=E4=B9=89=20Agent=20=E8=87=AA?= =?UTF-8?q?=E7=84=B6=E8=AF=AD=E8=A8=80=E5=BF=AB=E6=8D=B7=E6=8C=87=E4=BB=A4?= =?UTF-8?q?=20(#9)?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- Development-Workflow.-.md | 23 +++++++++++++++++++++++ 1 file changed, 23 insertions(+) diff --git a/Development-Workflow.-.md b/Development-Workflow.-.md index 9ada627..4a54a08 100644 --- a/Development-Workflow.-.md +++ b/Development-Workflow.-.md @@ -162,6 +162,29 @@ python dev_scripts/new_task_archive.py 123 "修复登录超时" - “最小验收条件”包括当前工单要求的实现、必要测试、文档影响处理、Wiki 镜像检查、提交和证据回写，不等同于功能第一次运行成功。 - 未影响当前验收的相邻问题只提示或建单，不顺手处理。 +## 自然语言快捷指令 + +快捷指令是对本工作流的自然语言别名，供 Claude Code、Codex 和维护者使用。它们只减少重复描述，不得绕过方案确认、前置依赖、安全规则、工单范围、Wiki 主源、必要验证或人工验收。 + +| 指令 | 执行动作 | 停止位置 | +|---|---|---| +| `只分析` | 只读检查需求、代码、日志和文档，区分事实与假设并给出方案 | 输出方案并等待确认；不建单、不修改 | +| `建工单` | 根据已经确认的方案创建单元任务工单 | 工单创建并记录完成；不修改代码 | +| `执行工单 #N` | 读取工单和前置依赖，实施、测试、提交、更新 Wiki、导出镜像、推送并回写证据 | 工单保持“待验收” | +| `建工单并做` | 依次执行“建工单”和“执行工单”；`建工单，做`、`建工单,做` 含义相同 | 工单保持“待验收” | +| `继续工单 #N` | 核对工单、Git 和 Wiki 证据，从首个未完成步骤继续，不重复仍然有效的检查 | 到达该工单当前流程的停止条件 | +| `检查工单 #N` | 只读对照范围、验收标准、测试和证据，报告通过项、缺失项及未验证部分 | 输出检查报告；不自动修复 | +| `同步文档` | 读取 Wiki，导出已映射的 `docs/` 镜像并检查一致性 | 显示结果和差异；不修改 Wiki、不自动提交 | +| `#N 验收通过` | 记录明确验收，更新 Wiki 归档为“已完成”，导出并提交镜像，推送、同步父工单并关闭任务 | 工单“已完成”并关闭 | + +补充边界： + +- 方案未确认时，`建工单`、`建工单并做` 和 `执行工单 #N` 不得绕过确认；Agent 应停在方案确认。 +- 前置依赖未满足且不允许并行时，实施类指令停在“待实施”。 +- `#N 验收通过` 必须来自用户明确表达；其他快捷指令不得关闭待验收工单。 +- `同步文档` 发现镜像有未提交改动时停止，不覆盖现有修改。 +- Gitea 工单保留讨论和过程，不把工单全文导出到本地；`docs/task/` 只保存 Wiki 最终任务归档的镜像。 + ## 什么时候重新确认方案 以下变化必须先更新工单，再由用户确认：