docs: 命令入口改为 harness.py 子命令 (#23)

ila
2026-08-18 21:33:26 +08:00
parent dae88cec81
commit d6afa1cba5
+4 -4
@@ -15,7 +15,7 @@
2. 优先使用项目已配置的 Gitea MCP 查询 Wiki 页面;MCP 不可用或不支持所需写操作时,才使用 Gitea API,并在初始化工单记录回退原因。凭据只从环境或 MCP 安全配置读取。
3. 查询线上页面列表;没有 `Home` 时先创建 `Home`,回读正文并记录 revision,然后再创建或更新其他核心映射页面。
4. 每个核心页面写入后都要在线回读;页面可读取且取得 revision 才算创建成功,不能用本地 `docs/` 文件替代这项证据。
5. 运行 `python dev_scripts/sync_wiki_docs.py`、`python dev_scripts/check_harness.py --strict` 和 `python dev_scripts/sync_wiki_docs.py --check`。任一映射页面不存在、无法回读或镜像不一致时,停止产品编码并完成初始化。
5. 运行 `python dev_scripts/harness.py sync --verify`。任一映射页面不存在、无法回读或镜像不一致时,停止产品编码并完成初始化。
Gitea 暂时不可用时可以准备工单和 Wiki 草稿,但不得把本地草稿宣称为线上事实,也不得绕过此门禁开始产品功能开发。
@@ -142,7 +142,7 @@ Agent 检查分支和工作区,只修改工单范围内的文件。发现新
使用以下命令只在 Wiki 创建任务归档页:
```powershell
python dev_scripts/new_task_archive.py 123 "修复登录超时"
python dev_scripts/harness.py archive 123 "修复登录超时"
```
归档内容以 Wiki 页面为事实来源。默认不修改 `wiki-docs.json`,也不写入 `docs/task/`。把 Wiki 页面、revision 和实现提交哈希写回工单;用户明确验收通过后,关闭单元工单并勾选父工单中的任务。
@@ -150,8 +150,8 @@ python dev_scripts/new_task_archive.py 123 "修复登录超时"
只有用户明确提出时才导出任务归档:
```powershell
python dev_scripts/export_task_archives.py # 增量:新增或 revision 变化
python dev_scripts/export_task_archives.py --all # 全量:读取全部线上任务归档
python dev_scripts/harness.py export # 增量:新增或 revision 变化
python dev_scripts/harness.py export --all # 全量:读取全部线上任务归档
```
导出不得自动删除本地文件。`docs/task/` 只是人工按需生成的只读快照,可能不是完整或最新的任务历史。