refactor: 合并 dev_scripts 入口为单一 harness.py (#23)

原有 4 个命令行入口(check_harness、sync_wiki_docs、new_task_archive、
export_task_archives)需要在多处文档分别描述,同步核心镜像还要按顺序跑 3 条命令。

合并为 dev_scripts/harness.py,提供 check / sync / archive / export 四个子命令,
各命令实现逻辑逐字取自原脚本,行为未改变;新增 sync --verify 一次完成
导出 → check --strict → 一致性校验。wiki_docs.py 作为库保持不变。

破坏性变更:4 个旧入口已删除,不保留兼容转发。已采用 DevHarness 的业务项目
升级基线时必须同步修改自己的命令与文档。

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
This commit is contained in:
ila
2026-08-18 21:36:15 +08:00
co-authored by Claude Opus 5
parent 65ead42f36
commit bfc0726c33
8 changed files with 295 additions and 296 deletions
+3 -7
View File
@@ -29,9 +29,7 @@ DevHarness 是一个以 Gitea 工单管理任务过程、以 Gitea Wiki 管理
7. 开始产品代码前运行:
```powershell
python dev_scripts/sync_wiki_docs.py
python dev_scripts/check_harness.py --strict
python dev_scripts/sync_wiki_docs.py --check
python dev_scripts/harness.py sync --verify
```
新仓库在 Gitea 尚未建立前允许一次不关联工单的引导提交。远端和工单系统配置完成后,所有改变程序行为的工作都必须先有单元任务工单。
@@ -48,10 +46,8 @@ docs/02-07*.md 代码地图、业务、验证、修改、排
docs/templates/task-archive.md 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/export_task_archives.py 人工增量或全量导出任务归档
dev_scripts/harness.py check / sync / archive / export 单一入口
dev_scripts/wiki_docs.py Gitea Wiki 客户端与镜像生成库
```
## 设计原则