3

Task-8-最小工单依赖规则

ila edited this page 2026-08-10 11:59:32 +08:00

Table of Contents

• 8 最小工单依赖规则
• 背景与目标
• 最终方案
• 修改文件
• 验收结果
• 测试
• 相关提交

This file contains ambiguous Unicode characters

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.

8 最小工单依赖规则

• 类型：开发流程优化
• 所属 Epic：无
• 所属 MVP / 版本：无
• 状态：已完成
• 日期：2026-08-10
• Gitea 工单：#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：本页的自动导出镜像。

验收结果

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

验收标准	结果
模板包含依赖与并行三个字段	通过
建单不受其他未完成工单限制	通过
实施前检查声明的前置工单	通过
待实施和阻塞边界明确	通过
允许并行必须写明原因	通过
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 工单，避免归档自引用。