From c76cdb6317870365bea190c775bfa51451a19025 Mon Sep 17 00:00:00 2001 From: ila Date: Mon, 10 Aug 2026 01:11:09 +0800 Subject: [PATCH] =?UTF-8?q?docs:=20=E5=AE=8C=E6=88=90=E4=BB=BB=E5=8A=A1=20?= =?UTF-8?q?#9=20=E5=BD=92=E6=A1=A3?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- ...0%E5%BF%AB%E6%8D%B7%E6%8C%87%E4%BB%A4.-.md | 76 ++++++++++++++----- 1 file changed, 59 insertions(+), 17 deletions(-) diff --git a/Task-9-Agent%E8%87%AA%E7%84%B6%E8%AF%AD%E8%A8%80%E5%BF%AB%E6%8D%B7%E6%8C%87%E4%BB%A4.-.md b/Task-9-Agent%E8%87%AA%E7%84%B6%E8%AF%AD%E8%A8%80%E5%BF%AB%E6%8D%B7%E6%8C%87%E4%BB%A4.-.md index 26079be..2e58f18 100644 --- a/Task-9-Agent%E8%87%AA%E7%84%B6%E8%AF%AD%E8%A8%80%E5%BF%AB%E6%8D%B7%E6%8C%87%E4%BB%A4.-.md +++ b/Task-9-Agent%E8%87%AA%E7%84%B6%E8%AF%AD%E8%A8%80%E5%BF%AB%E6%8D%B7%E6%8C%87%E4%BB%A4.-.md @@ -1,9 +1,9 @@ -# 9 Agent自然语言快捷指令 +# 9 Agent 自然语言快捷指令 -- 类型：需求 / 缺陷 / 重构 -- 所属 Epic：# -- 所属 MVP / 版本：# -- 状态：待验收 / 已完成 +- 类型：开发流程优化 +- 所属 Epic：无 +- 所属 MVP / 版本：无 +- 状态：待验收 - 日期：2026-08-10 - Gitea 工单：http://ilaer.eicp.net:8418/opc/dev_harness/issues/9 - Wiki 页面：Task-9-Agent自然语言快捷指令 @@ -11,32 +11,74 @@ ## 背景与目标 - +Agent 过去能够结合上下文理解“建工单，做”，但仓库没有正式定义快捷指令的名称、允许操作和停止位置，不同平台或会话可能产生不同理解。 + +本任务定义一组共享的自然语言快捷指令，让 Claude Code、Codex 和维护者使用同一套工作流语义，同时保持方案确认、依赖、安全、Wiki 主源和人工验收门禁。 ## 最终方案 - +正式定义以下 8 个快捷指令： + +- `只分析`：只读检查并给出方案，停在等待确认。 +- `建工单`：根据已确认方案创建工单，建单后停止。 +- `执行工单 #N`：实施现有工单并完成提交、归档和证据，停在“待验收”。 +- `建工单并做`：依次建单和执行；`建工单，做`、`建工单,做` 是等价表达，停在“待验收”。 +- `继续工单 #N`：从首个未完成步骤继续，不重复仍然有效的检查。 +- `检查工单 #N`：只读核对范围、验收、测试和证据，不自动修复。 +- `同步文档`：Wiki → `docs/` 同步并检查，不修改 Wiki、不自动提交。 +- `#N 验收通过`：仅在用户明确验收后完成验收归档、推送、父工单同步并关闭任务。 + +补充边界： + +- 快捷指令只是自然语言别名，不绕过任何强制规则。 +- 方案未确认时，建单或实施类指令停在方案确认。 +- 前置依赖未满足且不允许并行时，实施类指令停在“待实施”。 +- 除 `#N 验收通过` 外，不关闭待验收工单。 +- Gitea 工单保留讨论过程，本地只保存 Wiki 最终任务归档镜像。 +- Harness 检查 Wiki 章节和 8 个指令名称。 +- 没有增加脚本、Skill、Slash Command 或自动编排器。 + +实施结果与已确认方案一致。 ## 修改文件 -- `<文件>`：<改动说明> +- `AGENTS.md`：增加 8 个共享自然语言快捷指令和强制边界。 +- `dev_scripts/check_harness.py`：检查 Wiki 章节和快捷指令名称。 +- `tests/test_harness_docs.py`：调整 Agent 规则测试名称以覆盖全部必需规则。 +- `docs/01-workflow.md`：Development-Workflow Wiki 的只读镜像。 +- `wiki-docs.json`：登记本任务 Wiki 归档镜像。 +- `docs/task/9-Agent自然语言快捷指令.md`：本页的自动导出镜像。 ## 验收结果 | 验收标准 | 结果 | |---|---| -| | 通过 / 未通过 | +| 8 个指令有明确语义和停止位置 | 通过 | +| 建工单并做及逗号变体停在待验收 | 通过 | +| 只有明确验收指令会关闭工单 | 通过 | +| 只分析和检查工单默认只读 | 通过 | +| 同步文档不修改 Wiki、不自动提交 | 通过 | +| 不绕过确认、依赖、安全和验收 | 通过 | +| 未新增平台专用命令或脚本 | 通过 | +| Wiki 先更新并确认再导出 | 通过 | +| Harness、测试和镜像检查 | 通过 | +| 实现和归档提交分离 | 通过 | ## 测试 -- 执行命令：`<命令>` -- 结果： -- **未验证部分**： - -## 遗留问题 - - +- 执行命令：`python -m unittest discover -s tests -v` +- 结果：20/20 通过。 +- 执行命令：`python dev_scripts/check_harness.py --strict` +- 结果：通过。 +- 执行命令：`python dev_scripts/sync_wiki_docs.py --check` +- 结果：归档前 18/18 映射一致；归档后重新检查 19/19。 +- 执行命令：`python -m compileall -q dev_scripts tests` +- 结果：通过。 +- 执行命令：`git diff --check` +- 结果：通过。 +- **未验证部分**：没有实现或运行平台专用 Slash Command、Skill 或自动编排器，这些是已确认的非目标。 ## 相关提交 -- `<提交哈希>` <提交说明> +- `10e82d6` `feat: 定义 Agent 快捷指令 (#9)` +- 归档提交哈希在提交后回写 Gitea 工单，避免归档自引用。