2026-08-10 00:36:37 +08:00
|
|
|
|
<!-- gitea-wiki-mirror:start -->
|
|
|
|
|
|
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.-
|
2026-08-10 12:01:19 +08:00
|
|
|
|
wiki_revision: e9a890b18380bfbc02b7a292b8bed95cba8468a0
|
|
|
|
|
|
synchronized_at: 2026-08-10T04:00:14Z
|
2026-08-10 00:36:37 +08:00
|
|
|
|
<!-- gitea-wiki-mirror:end -->
|
|
|
|
|
|
|
|
|
|
|
|
# 8 最小工单依赖规则
|
|
|
|
|
|
|
|
|
|
|
|
- 类型：开发流程优化
|
|
|
|
|
|
- 所属 Epic：无
|
|
|
|
|
|
- 所属 MVP / 版本：无
|
2026-08-10 12:01:19 +08:00
|
|
|
|
- 状态：已完成
|
2026-08-10 00:36:37 +08:00
|
|
|
|
- 日期：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`：本页的自动导出镜像。
|
|
|
|
|
|
|
|
|
|
|
|
## 验收结果
|
|
|
|
|
|
|
2026-08-10 12:01:19 +08:00
|
|
|
|
用户于 2026-08-10 明确验收通过。
|
|
|
|
|
|
|
2026-08-10 00:36:37 +08:00
|
|
|
|
| 验收标准 | 结果 |
|
|
|
|
|
|
|---|---|
|
|
|
|
|
|
| 模板包含依赖与并行三个字段 | 通过 |
|
|
|
|
|
|
| 建单不受其他未完成工单限制 | 通过 |
|
|
|
|
|
|
| 实施前检查声明的前置工单 | 通过 |
|
|
|
|
|
|
| 待实施和阻塞边界明确 | 通过 |
|
|
|
|
|
|
| 允许并行必须写明原因 | 通过 |
|
|
|
|
|
|
| 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 工单，避免归档自引用。
|
