opc/dev_harness
2
0
Fork 0
Code Issues 3 Pull Requests Actions Packages Projects Releases Wiki Activity

定义 Agent 自然语言快捷指令 #9

New Issue
Closed
opened 2026-08-10 01:05:44 +08:00 by ila · 3 comments
ila commented 2026-08-10 01:05:44 +08:00
Owner
Copy Link
Copy Source

基本信息

  • 类型：开发流程优化
  • 所属 Epic：无
  • 所属 MVP / 版本：无
  • 阶段：已完成

依赖与并行

  • 前置工单：#8
  • 是否允许与前置工单并行：是
  • 原因：#8 的实现与归档已经提交并推送，本任务只增量定义自然语言快捷指令，不修改 #8 新增的依赖字段和状态语义，不影响 #8 独立验收。

要解决什么

当前 Agent 能根据自然语言和 AGENTS.md 理解“建工单，做”等要求，但仓库没有正式定义快捷指令的名称、动作范围和停止位置，不同 Agent 或会话可能产生不同理解。

目标是在共同 Agent 规则和 Wiki 工作流中正式定义一组少而明确的自然语言快捷指令，让 Claude Code、Codex 和初级维护者使用一致语义。

做什么 / 不做什么

  • 做：
    • 定义 只分析、建工单、执行工单 #N、建工单并做、继续工单 #N、检查工单 #N、同步文档、#N 验收通过。
    • 明确每个指令的允许操作和停止位置。
    • 接受 建工单，做 和 建工单,做 作为 建工单并做 的等价表达。
    • 明确快捷指令不能绕过方案确认、依赖、安全、Wiki 主源和人工验收。
    • Harness 检查快捷指令章节和关键名称存在。
    • 先更新 Wiki，再导出本地镜像。
  • 不做：
    • 不增加 shell 脚本、Slash Command、Skill 或自动化编排器。
    • 不自动发布、关闭未验收工单或扩大工单范围。
    • 不把 Gitea 工单全文导出到本地。
    • 不修改现有历史工单。

已确认方案

使用共享的自然语言快捷指令，而不是平台专用命令：

指令 停止位置
只分析 输出方案并等待确认
建工单 工单创建完成
执行工单 #N 实施、提交、归档完成，工单待验收
建工单并做 建单并执行，工单待验收
继续工单 #N 从首个未完成步骤继续到当前任务停止条件
检查工单 #N 只读报告，不自动修复
同步文档 Wiki 镜像同步并检查，不自动提交
#N 验收通过 验收归档完成并关闭工单

文档影响

  • 不影响长期文档，原因：
  • 更新项目档案或本地开发与验证
  • 更新架构与代码地图
  • 更新业务规则与术语
  • 更新常见修改或故障排查
  • 更新其他 Wiki 页面：Development-Workflow

验收标准

  • 8 个快捷指令均有明确语义和停止位置。
  • 建工单并做 及逗号变体最终停在“待验收”。
  • #N 验收通过 是唯一会完成验收归档并关闭工单的快捷指令。
  • 只分析 和 检查工单 #N 默认只读。
  • 同步文档 不修改 Wiki、不自动提交。
  • 快捷指令不能绕过方案确认、依赖、安全和人工验收。
  • 不新增脚本、Skill、Slash Command 或自动编排器。
  • Wiki 先更新、读取确认，再导出本地镜像。
  • Harness、测试和 Wiki 镜像检查通过。
  • 实现与任务归档分别提交并推送。

验证方式

python -m unittest discover -s tests -v
python dev_scripts/check_harness.py --strict
python dev_scripts/sync_wiki_docs.py --check
python -m compileall -q dev_scripts tests
git diff --check

风险和回退

风险：快捷指令被误解为可以跳过确认或自动关闭工单；指令过多导致重叠。

控制：只定义 8 个指令，每个写明停止位置，并声明所有强制规则优先。回退时恢复本任务提交，并恢复 Development-Workflow 的前一 Wiki revision。

## 基本信息 - 类型：开发流程优化 - 所属 Epic：无 - 所属 MVP / 版本：无 - 阶段：已完成 ## 依赖与并行 - 前置工单：#8 - 是否允许与前置工单并行：是 - 原因：#8 的实现与归档已经提交并推送，本任务只增量定义自然语言快捷指令，不修改 #8 新增的依赖字段和状态语义，不影响 #8 独立验收。 ## 要解决什么 当前 Agent 能根据自然语言和 `AGENTS.md` 理解“建工单，做”等要求，但仓库没有正式定义快捷指令的名称、动作范围和停止位置，不同 Agent 或会话可能产生不同理解。 目标是在共同 Agent 规则和 Wiki 工作流中正式定义一组少而明确的自然语言快捷指令，让 Claude Code、Codex 和初级维护者使用一致语义。 ## 做什么 / 不做什么 - 做： - 定义 `只分析`、`建工单`、`执行工单 #N`、`建工单并做`、`继续工单 #N`、`检查工单 #N`、`同步文档`、`#N 验收通过`。 - 明确每个指令的允许操作和停止位置。 - 接受 `建工单，做` 和 `建工单,做` 作为 `建工单并做` 的等价表达。 - 明确快捷指令不能绕过方案确认、依赖、安全、Wiki 主源和人工验收。 - Harness 检查快捷指令章节和关键名称存在。 - 先更新 Wiki，再导出本地镜像。 - 不做： - 不增加 shell 脚本、Slash Command、Skill 或自动化编排器。 - 不自动发布、关闭未验收工单或扩大工单范围。 - 不把 Gitea 工单全文导出到本地。 - 不修改现有历史工单。 ## 已确认方案 使用共享的自然语言快捷指令，而不是平台专用命令： | 指令 | 停止位置 | |---|---| | `只分析` | 输出方案并等待确认 | | `建工单` | 工单创建完成 | | `执行工单 #N` | 实施、提交、归档完成，工单待验收 | | `建工单并做` | 建单并执行，工单待验收 | | `继续工单 #N` | 从首个未完成步骤继续到当前任务停止条件 | | `检查工单 #N` | 只读报告，不自动修复 | | `同步文档` | Wiki 镜像同步并检查，不自动提交 | | `#N 验收通过` | 验收归档完成并关闭工单 | ## 文档影响 - [ ] 不影响长期文档，原因： - [ ] 更新项目档案或本地开发与验证 - [ ] 更新架构与代码地图 - [ ] 更新业务规则与术语 - [ ] 更新常见修改或故障排查 - [x] 更新其他 Wiki 页面：Development-Workflow ## 验收标准 - [x] 8 个快捷指令均有明确语义和停止位置。 - [x] `建工单并做` 及逗号变体最终停在“待验收”。 - [x] `#N 验收通过` 是唯一会完成验收归档并关闭工单的快捷指令。 - [x] `只分析` 和 `检查工单 #N` 默认只读。 - [x] `同步文档` 不修改 Wiki、不自动提交。 - [x] 快捷指令不能绕过方案确认、依赖、安全和人工验收。 - [x] 不新增脚本、Skill、Slash Command 或自动编排器。 - [x] Wiki 先更新、读取确认，再导出本地镜像。 - [x] Harness、测试和 Wiki 镜像检查通过。 - [x] 实现与任务归档分别提交并推送。 ## 验证方式 ```powershell python -m unittest discover -s tests -v python dev_scripts/check_harness.py --strict python dev_scripts/sync_wiki_docs.py --check python -m compileall -q dev_scripts tests git diff --check ``` ## 风险和回退 风险：快捷指令被误解为可以跳过确认或自动关闭工单；指令过多导致重叠。 控制：只定义 8 个指令，每个写明停止位置，并声明所有强制规则优先。回退时恢复本任务提交，并恢复 Development-Workflow 的前一 Wiki revision。
ila commented 2026-08-10 01:09:22 +08:00
Author
Owner
Copy Link
Copy Source

实现完成，进入归档阶段

  • 共同 Agent 规则已定义 8 个自然语言快捷指令及停止位置。
  • 建工单，做、建工单,做 已定义为 建工单并做 的等价表达，最终停在“待验收”。
  • #N 验收通过 是唯一执行验收归档并关闭工单的快捷指令。
  • 只分析、检查工单 #N 默认只读；同步文档 不修改 Wiki、不自动提交。
  • 所有快捷指令都受方案确认、依赖、安全、范围、Wiki 主源和人工验收约束。
  • Development-Workflow Wiki 已先更新并读取确认：fff33e44e1ffe39681ff42e4ac05529e973d1cd6。
  • Harness 已检查 Wiki 章节和 8 个指令名称。
  • 未增加脚本、Skill、Slash Command 或自动编排器。

实现提交：10e82d6

首轮验证：

  • 单元测试：20/20 通过
  • Harness 严格检查：通过
  • Wiki 镜像检查：18/18 一致
  • Python 编译检查：通过
  • git diff --check：通过

下一步创建 Wiki 任务归档。

## 实现完成，进入归档阶段 - 共同 Agent 规则已定义 8 个自然语言快捷指令及停止位置。 - `建工单，做`、`建工单,做` 已定义为 `建工单并做` 的等价表达，最终停在“待验收”。 - `#N 验收通过` 是唯一执行验收归档并关闭工单的快捷指令。 - `只分析`、`检查工单 #N` 默认只读；`同步文档` 不修改 Wiki、不自动提交。 - 所有快捷指令都受方案确认、依赖、安全、范围、Wiki 主源和人工验收约束。 - Development-Workflow Wiki 已先更新并读取确认：`fff33e44e1ffe39681ff42e4ac05529e973d1cd6`。 - Harness 已检查 Wiki 章节和 8 个指令名称。 - 未增加脚本、Skill、Slash Command 或自动编排器。 实现提交：`10e82d6` 首轮验证： - 单元测试：20/20 通过 - Harness 严格检查：通过 - Wiki 镜像检查：18/18 一致 - Python 编译检查：通过 - `git diff --check`：通过 下一步创建 Wiki 任务归档。
ila referenced this issue from a commit 2026-08-10 01:14:34 +08:00
docs: 归档任务 #9
ila commented 2026-08-10 01:14:53 +08:00
Author
Owner
Copy Link
Copy Source

最终实施与归档证据

  • 状态：待验收（未关闭）
  • 实现提交：10e82d6（feat: 定义 Agent 快捷指令 (#9)）
  • 归档提交：4840407（docs: 归档任务 #9）
  • 远端 main：已推送至 4840407
  • Development-Workflow Wiki：fff33e44e1ffe39681ff42e4ac05529e973d1cd6
  • Wiki 归档：Task-9-Agent自然语言快捷指令
  • Wiki revision：c76cdb6317870365bea190c775bfa51451a19025
  • 本地只读镜像：docs/task/9-Agent自然语言快捷指令.md

最终验证

  • 单元测试：20/20 通过
  • Harness 严格检查：通过
  • Wiki 镜像检查：19/19 一致
  • Python 编译检查：通过
  • git diff --check：通过
  • 工作区：干净
  • 未验证部分：未实现或运行 Slash Command、Skill 或自动编排器，这些是已确认的非目标。

过程记录

首次归档时 Gitea 读取 Task-Archive-Template 返回 502。检查确认 #9 Wiki 页面和映射已创建、本地镜像未生成；随后从失败点补全现有 Wiki 页面并导出，没有重复建页。最终检查全部通过。

请按验收标准检查；收到明确“#9 验收通过”后再关闭工单。

## 最终实施与归档证据 - 状态：待验收（未关闭） - 实现提交：`10e82d6`（`feat: 定义 Agent 快捷指令 (#9)`） - 归档提交：`4840407`（`docs: 归档任务 #9`） - 远端 `main`：已推送至 `4840407` - Development-Workflow Wiki：`fff33e44e1ffe39681ff42e4ac05529e973d1cd6` - Wiki 归档：[Task-9-Agent自然语言快捷指令](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` - 本地只读镜像：`docs/task/9-Agent自然语言快捷指令.md` ### 最终验证 - 单元测试：20/20 通过 - Harness 严格检查：通过 - Wiki 镜像检查：19/19 一致 - Python 编译检查：通过 - `git diff --check`：通过 - 工作区：干净 - 未验证部分：未实现或运行 Slash Command、Skill 或自动编排器，这些是已确认的非目标。 ### 过程记录 首次归档时 Gitea 读取 `Task-Archive-Template` 返回 502。检查确认 #9 Wiki 页面和映射已创建、本地镜像未生成；随后从失败点补全现有 Wiki 页面并导出，没有重复建页。最终检查全部通过。 请按验收标准检查；收到明确“#9 验收通过”后再关闭工单。
ila closed this issue 2026-08-10 12:01:42 +08:00
ila commented 2026-08-10 12:02:01 +08:00
Author
Owner
Copy Link
Copy Source

验收完成

用户已明确确认 #9 验收通过，工单已关闭。

  • 验收归档提交：4e9f2e1（已推送至远端 main）
  • Wiki 归档：任务 #9
  • Wiki revision：6aedbcf63ad86892681c5f9226c4679dbbe16646
  • 本地只读镜像：docs/task/9-Agent自然语言快捷指令.md
  • 最终验证：21/21 单元测试通过、Harness 严格检查通过、20/20 Wiki 镜像一致
## 验收完成 用户已明确确认 #9 验收通过，工单已关闭。 - 验收归档提交：`4e9f2e1`（已推送至远端 `main`） - Wiki 归档：[任务 #9](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：`6aedbcf63ad86892681c5f9226c4679dbbe16646` - 本地只读镜像：`docs/task/9-Agent自然语言快捷指令.md` - 最终验证：21/21 单元测试通过、Harness 严格检查通过、20/20 Wiki 镜像一致
Sign in to join this conversation.
No Branch/Tag Specified
Branches Tags
Labels
No items
No labels
Milestone
No items
No Milestone
Projects
Clear projects
No projects
Assignees
Clear assignees
admin ila
No Assignees
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: opc/dev_harness#9