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

增加最小工单依赖与并行规则 #8

New Issue
Closed
opened 2026-08-16 23:06:14 +08:00 by ila · 3 comments
ila commented 2026-08-16 23:06:14 +08:00
Owner
Copy Link
Copy Source

基本信息

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

要解决什么

当前允许建立后续工单，也定义了“待实施”和“阻塞”状态，但单元任务模板没有前置工单和并行信息，Agent 实施前也没有明确的依赖检查步骤，容易遗漏任务之间的真实依赖。

目标是采用最小实现：由工单显式声明依赖，Agent 在实施前人工检查，Harness 只保证模板字段存在。

做什么 / 不做什么

  • 做：
    • 单元任务模板增加“依赖与并行”章节。
    • 明确新工单不要求前面工单全部完成。
    • 明确实施前检查已声明的前置工单。
    • 前置未完成且存在实际依赖时保持“待实施”；允许并行时写明原因。
    • 区分“待实施”和实施过程中出现的“阻塞”。
    • Harness 检查模板必需字段。
    • 更新对应 Wiki，再导出本地镜像。
  • 不做：
    • 不开发自动依赖图。
    • 不连接 Gitea 自动查询前置工单状态。
    • 不自动切换或阻止工单状态。
    • 不要求按工单编号顺序实施。
    • 不修改现有历史工单。

已确认方案

单元任务模板增加：

## 依赖与并行

- 前置工单：无 / #编号
- 是否允许与前置工单并行：是 / 否
- 原因：

Agent 规则和开发工作流规定：

  1. 建单不要求其他工单全部完成。
  2. 实施前检查声明的前置工单。
  3. 前置未完成且存在实际依赖时不得实施，状态保持“待实施”。
  4. 允许并行时必须在工单写明原因。
  5. “阻塞”只用于实施过程中遇到计划外、当前无法解除的问题。

文档影响

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

验收标准

  • 单元任务模板包含“依赖与并行”及三个约定字段。
  • Agent 规则明确建单不受未完成工单限制。
  • Agent 实施前必须检查已声明的前置工单。
  • 未满足的真实依赖使用“待实施”，计划外无法推进使用“阻塞”。
  • 允许并行必须写明原因。
  • Harness 能检测模板字段缺失。
  • 不增加自动依赖图、Gitea 状态查询或新脚本。
  • 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

风险和回退

风险：依赖规则过重，导致独立任务也必须等待；“待实施”和“阻塞”被混用。

控制：只有工单声明真实依赖时才等待；明确允许并行及状态边界。回退时恢复本任务提交，并将 Wiki 页面恢复到前一 revision。

## 基本信息 - 类型：开发流程优化 - 所属 Epic：无 - 所属 MVP / 版本：无 - 阶段：已完成 ## 要解决什么 当前允许建立后续工单，也定义了“待实施”和“阻塞”状态，但单元任务模板没有前置工单和并行信息，Agent 实施前也没有明确的依赖检查步骤，容易遗漏任务之间的真实依赖。 目标是采用最小实现：由工单显式声明依赖，Agent 在实施前人工检查，Harness 只保证模板字段存在。 ## 做什么 / 不做什么 - 做： - 单元任务模板增加“依赖与并行”章节。 - 明确新工单不要求前面工单全部完成。 - 明确实施前检查已声明的前置工单。 - 前置未完成且存在实际依赖时保持“待实施”；允许并行时写明原因。 - 区分“待实施”和实施过程中出现的“阻塞”。 - Harness 检查模板必需字段。 - 更新对应 Wiki，再导出本地镜像。 - 不做： - 不开发自动依赖图。 - 不连接 Gitea 自动查询前置工单状态。 - 不自动切换或阻止工单状态。 - 不要求按工单编号顺序实施。 - 不修改现有历史工单。 ## 已确认方案 单元任务模板增加： ```markdown ## 依赖与并行 - 前置工单：无 / #编号 - 是否允许与前置工单并行：是 / 否 - 原因： ``` Agent 规则和开发工作流规定： 1. 建单不要求其他工单全部完成。 2. 实施前检查声明的前置工单。 3. 前置未完成且存在实际依赖时不得实施，状态保持“待实施”。 4. 允许并行时必须在工单写明原因。 5. “阻塞”只用于实施过程中遇到计划外、当前无法解除的问题。 ## 文档影响 - [ ] 不影响长期文档，原因： - [ ] 更新项目档案或本地开发与验证 - [ ] 更新架构与代码地图 - [x] 更新业务规则与术语 - [ ] 更新常见修改或故障排查 - [x] 更新其他 Wiki 页面：Development-Workflow ## 验收标准 - [x] 单元任务模板包含“依赖与并行”及三个约定字段。 - [x] Agent 规则明确建单不受未完成工单限制。 - [x] Agent 实施前必须检查已声明的前置工单。 - [x] 未满足的真实依赖使用“待实施”，计划外无法推进使用“阻塞”。 - [x] 允许并行必须写明原因。 - [x] Harness 能检测模板字段缺失。 - [x] 不增加自动依赖图、Gitea 状态查询或新脚本。 - [x] 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 ``` ## 风险和回退 风险：依赖规则过重，导致独立任务也必须等待；“待实施”和“阻塞”被混用。 控制：只有工单声明真实依赖时才等待；明确允许并行及状态边界。回退时恢复本任务提交，并将 Wiki 页面恢复到前一 revision。
ila closed this issue 2026-08-16 23:06:14 +08:00
ila commented 2026-08-16 23:06:17 +08:00
Author
Owner
Copy Link
Copy Source

实现完成，进入归档阶段

最终方案

  • 单元任务模板新增“依赖与并行”：前置工单、是否允许并行、原因。
  • 建立后续工单不要求已有工单完成，也不按编号限制顺序。
  • Agent 实施前检查已声明的前置工单；真实依赖未满足时保持“待实施”。
  • 允许并行必须写明原因；实施后出现计划外、当前无法解除的问题才使用“阻塞”。
  • Wiki 已先更新并读取确认：
    • Development-Workflow：dcef8c85c6c99d4ff2ce4678736092479b505794
    • Business-Rules-and-Glossary：82bb04c1bf6a703568218664a652b5192055f072
  • Harness 只检查模板字段，没有增加自动依赖图、Gitea 状态查询或新脚本。

实现提交：a59e3b5

首轮验证

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

下一步创建 Wiki 任务归档并同步本地镜像。

## 实现完成，进入归档阶段 ### 最终方案 - 单元任务模板新增“依赖与并行”：前置工单、是否允许并行、原因。 - 建立后续工单不要求已有工单完成，也不按编号限制顺序。 - Agent 实施前检查已声明的前置工单；真实依赖未满足时保持“待实施”。 - 允许并行必须写明原因；实施后出现计划外、当前无法解除的问题才使用“阻塞”。 - Wiki 已先更新并读取确认： - Development-Workflow：`dcef8c85c6c99d4ff2ce4678736092479b505794` - Business-Rules-and-Glossary：`82bb04c1bf6a703568218664a652b5192055f072` - Harness 只检查模板字段，没有增加自动依赖图、Gitea 状态查询或新脚本。 实现提交：`a59e3b5` ### 首轮验证 - 单元测试：20/20 通过 - Harness 严格检查：通过 - Wiki 镜像检查：17/17 一致 - Python 编译检查：通过 - `git diff --check`：通过 下一步创建 Wiki 任务归档并同步本地镜像。
ila commented 2026-08-16 23:06:19 +08:00
Author
Owner
Copy Link
Copy Source

最终实施与归档证据

  • 状态：待验收（未关闭）
  • 实现提交：a59e3b5（feat: 增加最小工单依赖规则 (#8)）
  • 归档提交：f652cbd（docs: 归档任务 #8）
  • 远端 main：已推送至 f652cbd
  • Wiki 归档：Task-8-最小工单依赖规则
  • Wiki revision：b043f3438b0e49c6fcea18cdfe0596df73196971
  • 本地只读镜像：docs/task/8-最小工单依赖规则.md
  • 稳定 Wiki：
    • Development-Workflow：dcef8c85c6c99d4ff2ce4678736092479b505794
    • Business-Rules-and-Glossary：82bb04c1bf6a703568218664a652b5192055f072

最终验证

  • 单元测试：20/20 通过
  • Harness 严格检查：通过
  • Wiki 镜像检查：18/18 一致
  • Python 编译检查：通过
  • git diff --check：通过
  • 工作区：干净
  • 未验证部分：没有自动查询 Gitea 前置工单状态，这是已确认的非目标。

过程记录

首次“同步 + 检查”组合命令在 120 秒超时。检查发现 Wiki 导出已完成且 revision 正确，随后从失败点单独重跑 sync_wiki_docs.py --check，18/18 通过；最终闭环再次完整验证通过。

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

## 最终实施与归档证据 - 状态：待验收（未关闭） - 实现提交：`a59e3b5`（`feat: 增加最小工单依赖规则 (#8)`） - 归档提交：`f652cbd`（`docs: 归档任务 #8`） - 远端 `main`：已推送至 `f652cbd` - Wiki 归档：[Task-8-最小工单依赖规则](http://ilaer.eicp.net:8418/opc/dev_harness/wiki/Task-8-%E6%9C%80%E5%B0%8F%E5%B7%A5%E5%8D%95%E4%BE%9D%E8%B5%96%E8%A7%84%E5%88%99.-) - Wiki revision：`b043f3438b0e49c6fcea18cdfe0596df73196971` - 本地只读镜像：`docs/task/8-最小工单依赖规则.md` - 稳定 Wiki： - Development-Workflow：`dcef8c85c6c99d4ff2ce4678736092479b505794` - Business-Rules-and-Glossary：`82bb04c1bf6a703568218664a652b5192055f072` ### 最终验证 - 单元测试：20/20 通过 - Harness 严格检查：通过 - Wiki 镜像检查：18/18 一致 - Python 编译检查：通过 - `git diff --check`：通过 - 工作区：干净 - 未验证部分：没有自动查询 Gitea 前置工单状态，这是已确认的非目标。 ### 过程记录 首次“同步 + 检查”组合命令在 120 秒超时。检查发现 Wiki 导出已完成且 revision 正确，随后从失败点单独重跑 `sync_wiki_docs.py --check`，18/18 通过；最终闭环再次完整验证通过。 请按验收标准检查；收到明确“#8 验收通过”后再关闭工单。
ila commented 2026-08-16 23:06:20 +08:00
Author
Owner
Copy Link
Copy Source

验收完成

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

  • 验收归档提交：4e9f2e1（已推送至远端 main）
  • Wiki 归档：任务 #8
  • Wiki revision：e9a890b18380bfbc02b7a292b8bed95cba8468a0
  • 本地只读镜像：docs/task/8-最小工单依赖规则.md
  • 最终验证：21/21 单元测试通过、Harness 严格检查通过、20/20 Wiki 镜像一致
## 验收完成 用户已明确确认 #8 验收通过，工单已关闭。 - 验收归档提交：`4e9f2e1`（已推送至远端 `main`） - Wiki 归档：[任务 #8](http://ilaer.eicp.net:8418/opc/dev_harness/wiki/Task-8-%E6%9C%80%E5%B0%8F%E5%B7%A5%E5%8D%95%E4%BE%9D%E8%B5%96%E8%A7%84%E5%88%99.-) - Wiki revision：`e9a890b18380bfbc02b7a292b8bed95cba8468a0` - 本地只读镜像：`docs/task/8-最小工单依赖规则.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#8