4.2 KiB
4.2 KiB
generated: true (请先修改 Gitea Wiki，禁止直接编辑本文件) wiki_page: Task-9-Agent自然语言快捷指令 wiki_url: http://ilaer.eicp.net:8418/opc/dev_harness/wiki/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.- wiki_revision: c76cdb6317870365bea190c775bfa51451a19025 synchronized_at: 2026-08-09T17:12:07Z
9 Agent 自然语言快捷指令
- 类型：开发流程优化
- 所属 Epic：无
- 所属 MVP / 版本：无
- 状态：待验收
- 日期：2026-08-10
- Gitea 工单：#9
- Wiki 页面：Task-9-Agent自然语言快捷指令
- Wiki revision：见本地镜像头
背景与目标
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 或自动编排器，这些是已确认的非目标。
相关提交
10e82d6feat: 定义 Agent 快捷指令 (#9)- 归档提交哈希在提交后回写 Gitea 工单，避免归档自引用。