diff --git a/docs/task/8-最小工单依赖规则.md b/docs/task/8-最小工单依赖规则.md new file mode 100644 index 0000000..987749a --- /dev/null +++ b/docs/task/8-最小工单依赖规则.md @@ -0,0 +1,83 @@ + +generated: true (请先修改 Gitea Wiki,禁止直接编辑本文件) +wiki_page: Task-8-最小工单依赖规则 +wiki_url: 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 +synchronized_at: 2026-08-09T16:33:55Z + + +# 8 最小工单依赖规则 + +- 类型:开发流程优化 +- 所属 Epic:无 +- 所属 MVP / 版本:无 +- 状态:待验收 +- 日期:2026-08-10 +- Gitea 工单:http://ilaer.eicp.net:8418/opc/dev_harness/issues/8 +- Wiki 页面:Task-8-最小工单依赖规则 +- Wiki revision:见本地镜像头 + +## 背景与目标 + +项目已经允许建立后续工单,并定义了“待实施”和“阻塞”,但单元任务模板没有前置依赖和并行信息,Agent 实施前也没有明确的依赖检查步骤。 + +本任务采用最小实现:工单显式声明依赖,Agent 实施前人工检查,Harness 只检查模板字段存在,不把 DevHarness 扩展为自动项目管理系统。 + +## 最终方案 + +- 单元任务模板增加“依赖与并行”章节,记录前置工单、是否允许并行和原因。 +- 建立新工单不要求其他工单完成,也不按工单编号限制实施顺序。 +- Agent 开始修改前检查已声明的前置工单。 +- 没有前置工单、前置已完成或明确允许并行时,可以进入“进行中”。 +- 前置未完成且存在真实依赖时不得实施,工单保持“待实施”。 +- 允许并行必须说明不存在实施冲突的原因。 +- 已进入实施后遇到计划外、当前无法解除的问题时才使用“阻塞”。 +- 依赖满足后,任务仍须拥有独立范围、提交、测试和回退方式。 +- Harness 检查模板章节及三个字段,并增加缺失字段测试。 +- 没有增加自动依赖图、联网查询、自动状态门禁或新脚本。 + +实施结果与已确认方案一致。 + +## 修改文件 + +- `AGENTS.md`:增加实施前依赖检查及状态边界。 +- `.gitea/issue_template/task.md`:增加“依赖与并行”字段。 +- `dev_scripts/check_harness.py`:检查模板依赖字段。 +- `tests/test_harness_docs.py`:验证缺失依赖字段会被报告。 +- `docs/01-workflow.md`:Development-Workflow Wiki 的只读镜像。 +- `docs/03-business-rules-and-glossary.md`:Business-Rules-and-Glossary Wiki 的只读镜像。 +- `wiki-docs.json`:登记本任务 Wiki 归档镜像。 +- `docs/task/8-最小工单依赖规则.md`:本页的自动导出镜像。 + +## 验收结果 + +| 验收标准 | 结果 | +|---|---| +| 模板包含依赖与并行三个字段 | 通过 | +| 建单不受其他未完成工单限制 | 通过 | +| 实施前检查声明的前置工单 | 通过 | +| 待实施和阻塞边界明确 | 通过 | +| 允许并行必须写明原因 | 通过 | +| Harness 检测字段缺失 | 通过 | +| 未增加自动门禁或新脚本 | 通过 | +| Wiki 先更新、确认再导出 | 通过 | +| 测试和严格检查 | 通过 | + +## 测试 + +- 执行命令:`python -m unittest discover -s tests -v` +- 结果:20/20 通过。 +- 执行命令:`python dev_scripts/check_harness.py --strict` +- 结果:通过。 +- 执行命令:`python dev_scripts/sync_wiki_docs.py --check` +- 结果:归档前 17/17 映射一致;归档后重新检查 18/18。 +- 执行命令:`python -m compileall -q dev_scripts tests` +- 结果:通过。 +- 执行命令:`git diff --check` +- 结果:通过。 +- **未验证部分**:没有自动查询 Gitea 前置工单状态;这是已确认的非目标,依赖由 Agent 在实施前人工检查。 + +## 相关提交 + +- `a59e3b5` `feat: 增加最小工单依赖规则 (#8)` +- 归档提交哈希在提交后回写 Gitea 工单,避免归档自引用。 diff --git a/wiki-docs.json b/wiki-docs.json index 4e9b116..03edb44 100644 --- a/wiki-docs.json +++ b/wiki-docs.json @@ -71,6 +71,10 @@ { "page": "Task-7-ClaudeCode模型路由", "path": "docs/task/7-ClaudeCode模型路由.md" + }, + { + "page": "Task-8-最小工单依赖规则", + "path": "docs/task/8-最小工单依赖规则.md" } ] }