feat: export task archives on demand (#14)

This commit is contained in:
QiuSW
2026-08-16 19:21:36 +08:00
parent f23c2cf81f
commit d1f55f9df3
14 changed files with 424 additions and 134 deletions
+7 -6
View File
@@ -14,7 +14,7 @@ DevHarness 是一个以 Gitea 工单管理任务过程、以 Gitea Wiki 管理
-> Agent 实现并测试
-> 提交代码并更新工单
-> 人工验收
-> 先归档 Wiki,再导出 docs/task 镜像
-> 归档 Wiki;任务快照仅在人工提出时导出
-> 关闭工单并更新父工单
```
@@ -44,17 +44,18 @@ docs/00-project-profile.md Wiki 项目档案的只读镜像
docs/01-workflow.md Wiki 开发工作流的只读镜像
docs/02-07*.md 代码地图、业务、验证、修改、排错和初始化镜像
docs/templates/task-archive.md Wiki 任务归档模板的只读镜像
docs/task/ Wiki 任务归档页的只读镜像
wiki-docs.json Wiki 页面到本地镜像的显式映射
docs/task/ 人工按需导出的 Wiki 任务归档快照
wiki-docs.json 核心 Wiki 页面到本地镜像的显式映射
dev_scripts/check_harness.py 模板和归档的最小自检
dev_scripts/sync_wiki_docs.py 单向导出或检查 Wiki 镜像
dev_scripts/new_task_archive.py 先创建 Wiki 任务归档,再导出镜像
dev_scripts/new_task_archive.py 只创建 Wiki 任务归档
dev_scripts/export_task_archives.py 人工增量或全量导出任务归档
```
## 设计原则
- 人决定目标、范围和验收结果,Agent 负责检查、实现和验证。
- 工单记录实施过程,Wiki 保存长期有效的最终事实,`docs/` 只保存可审查的镜像。
- 工单记录实施过程,Wiki 保存长期有效的最终事实,`docs/` 默认保存核心镜像;任务归档快照按需导出。
- 一个单元工单只解决一个可独立测试和回退的问题。
- 实现提交与归档提交分开,便于审查与追溯。
- 实现提交与必要的核心文档镜像提交分开,便于审查与追溯。
- 凭据、个人数据和生产数据不得进入代码、工单或归档。