Table of Contents

9 Agent 自然语言快捷指令

背景与目标
最终方案
修改文件
验收结果
测试
相关提交

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

9 Agent 自然语言快捷指令

类型：开发流程优化
所属 Epic：无
所属 MVP / 版本：无
状态：已完成
日期：2026-08-10
Gitea 工单：http://ilaer.eicp.net:8418/opc/dev_harness/issues/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：本页的自动导出镜像。

验收结果

用户于 2026-08-10 明确验收通过。

验收标准	结果
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 或自动编排器，这些是已确认的非目标。

9 Agent 自然语言快捷指令

背景与目标

最终方案

修改文件

验收结果

测试

相关提交