docs: 同步任务事实来源最终措辞 (#25)

2026-08-25 08:41:11 +08:00
parent 5821ea0d08
commit 3b707a0a9a
6 changed files with 19 additions and 19 deletions
@@ -2,8 +2,8 @@
 generated: true (请先修改 Gitea Wiki，禁止直接编辑本文件)
 wiki_page: Project-Profile
 wiki_url: https://git.ilapage.cn/OPC/dev_harness/wiki/Project-Profile.-
-wiki_revision: 5a9d3e4ffa72ef7f10ee3480fbbf3820cbfce1c7
-synchronized_at: 2026-08-24T08:55:19Z
+wiki_revision: 76d42d222f6ab3aa0836cc2d036f81344049a470
+synchronized_at: 2026-08-25T00:40:26Z
 <!-- gitea-wiki-mirror:end -->

 # 项目档案
@@ -87,7 +87,7 @@ synchronized_at: 2026-08-24T08:55:19Z

 | 目录 | 职责 | 不应放入 |
 |---|---|---|
-| `.gitea/issue_template/` | Gitea 工单模板 | 凭据、任务最终归档 |
+| `.gitea/issue_template/` | Gitea 工单模板 | 凭据、单次任务证据 |
 | `docs/` | Wiki 自动导出的只读镜像 | 人工直接维护的长期文档 |
 | `docs/task/` | 人工明确要求后导出的专项或历史兼容快照，可能不是完整历史 | 默认任务记录、讨论过程和临时方案 |
 | `dev_scripts/` | Harness 检查、Wiki 同步和归档工具 | 产品功能代码 |
@@ -2,8 +2,8 @@
 generated: true (请先修改 Gitea Wiki，禁止直接编辑本文件)
 wiki_page: Development-Workflow
 wiki_url: https://git.ilapage.cn/OPC/dev_harness/wiki/Development-Workflow.-
-wiki_revision: 5a79c3a71235e802484c8f5bd19bda37ccde8e46
-synchronized_at: 2026-08-24T08:55:25Z
+wiki_revision: 3dbe6af1ab5eceb269f68c662e16065dbd6de0cb
+synchronized_at: 2026-08-25T00:40:28Z
 <!-- gitea-wiki-mirror:end -->

 # 开发工作流
@@ -141,7 +141,7 @@ Agent 检查分支和工作区，只修改工单范围内的文件。发现新
 修改 Wiki → 读取确认 → 导出核心 docs → 校验差异 → 提交镜像
 ```

-没有长期文档影响时，在工单写明原因并跳过 Wiki 更新、核心镜像同步和任务归档。长期文档仍不得先编辑本地镜像再反向覆盖 Wiki。
+没有长期文档影响时，在工单写明原因并跳过 Wiki 更新和核心镜像同步；默认任务流程不创建任务归档。长期文档仍不得先编辑本地镜像再反向覆盖 Wiki。

 ### 4. 待验收

@@ -2,8 +2,8 @@
 generated: true (请先修改 Gitea Wiki，禁止直接编辑本文件)
 wiki_page: Architecture-and-Code-Map
 wiki_url: https://git.ilapage.cn/OPC/dev_harness/wiki/Architecture-and-Code-Map.-
-wiki_revision: ee55cd9499b6210b533f149b3eaf220903fa8045
-synchronized_at: 2026-08-24T08:55:28Z
+wiki_revision: 06542b54af9954c186b10ba8cd5f923d501c6018
+synchronized_at: 2026-08-25T00:40:31Z
 <!-- gitea-wiki-mirror:end -->

 # 架构与代码地图
@@ -20,7 +20,7 @@ synchronized_at: 2026-08-24T08:55:28Z

 ## 项目定位

-DevHarness 不是业务应用，而是一套开发工作流模板。它约束 Agent 和维护者如何讨论需求、建立工单、修改代码、更新 Wiki、测试、提交、验收和归档。
+DevHarness 不是业务应用，而是一套开发工作流模板。它约束 Agent 和维护者如何讨论需求、建立工单、修改代码、更新 Wiki、测试、提交和验收，并在明确需要时创建专项快照。

 ```text
 用户确认方案
@@ -42,7 +42,7 @@ DevHarness 不是业务应用，而是一套开发工作流模板。它约束 Ag
 | Wiki API 和镜像生成 | `dev_scripts/wiki_docs.py` | `WikiClient`、`sync_all` | 配置、页面、镜像元数据 | `tests/test_wiki_docs.py` | 中 |
 | 同步与校验 | `dev_scripts/harness.py` | `run_sync()` | `sync [--check] [--verify]` | 线上 Wiki 对照检查 | 低 |
 | 可选任务快照 | `dev_scripts/harness.py` | `run_archive()` | `archive <编号> <短标题>` | 单元测试和显式专项归档 | 中 |
-| Harness 结构检查 | `dev_scripts/harness.py` | `run_check()` | 必需文件、镜像、归档检查 | `check --strict` | 中 |
+| Harness 结构检查 | `dev_scripts/harness.py` | `run_check()` | 必需文件、镜像和已有快照检查 | `check --strict` | 中 |
 | 本地文档镜像 | `docs/` | `docs/README.md` | 生成元数据和 Wiki 正文 | 同步检查 | 低 |
 | 自动化测试 | `tests/` | `test_wiki_docs.py` | 映射、同步和安全边界 | `unittest discover` | 低 |

@@ -2,8 +2,8 @@
 generated: true (请先修改 Gitea Wiki，禁止直接编辑本文件)
 wiki_page: Business-Rules-and-Glossary
 wiki_url: https://git.ilapage.cn/OPC/dev_harness/wiki/Business-Rules-and-Glossary.-
-wiki_revision: b03332bbf337d58428c2b9617a954c421a454882
-synchronized_at: 2026-08-24T08:55:34Z
+wiki_revision: f94f1f8020f1059aff2d69e1ca86e048f47c8f9b
+synchronized_at: 2026-08-25T00:40:33Z
 <!-- gitea-wiki-mirror:end -->

 # 业务规则与术语
@@ -36,7 +36,7 @@ synchronized_at: 2026-08-24T08:55:34Z
 | 待实施 | 方案已确认但尚未修改，或真实前置依赖尚未满足 | 前置依赖已满足或明确允许并行，且工作区和范围检查完成 |
 | 进行中 | 正在实现、测试或同步文档 | 验收标准逐项检查完成 |
 | 阻塞 | 实施过程中出现计划外、当前无法解除的问题 | 阻塞解除并更新工单 |
-| 待验收 | 代码、测试、归档和证据已完成 | 用户明确验收 |
+| 待验收 | 实现、必要测试、提交和最终证据已完成 | 用户明确验收 |
 | 已完成 | 用户已验收并完成父任务同步 | 无 |

 ## 稳定业务规则
@@ -2,8 +2,8 @@
 generated: true (请先修改 Gitea Wiki，禁止直接编辑本文件)
 wiki_page: Existing-Project-Adoption-Guide
 wiki_url: https://git.ilapage.cn/OPC/dev_harness/wiki/Existing-Project-Adoption-Guide.-
-wiki_revision: 3575ecb437d5a7eac4073b0ad3e162da8b5c1100
-synchronized_at: 2026-08-24T08:55:55Z
+wiki_revision: a3c9c0892eeeafeec162a50c1cdfbc15d003897d
+synchronized_at: 2026-08-25T00:40:47Z
 <!-- gitea-wiki-mirror:end -->

 # 已有项目接入 DevHarness 指南
@@ -227,7 +227,7 @@ Agent 在提出方案前只读检查：
 - [ ] 已为每类长期文档明确事实来源和迁移状态。
 - [ ] Wiki-first 页面已经读取确认并具有显式镜像映射。
 - [ ] Harness 检查已按目标项目调整并通过。
- [ ] 必要测试、未验证部分、提交和归档证据已记录。
+- [ ] 必要测试、未验证部分、提交和最终证据已记录。
 - [ ] 工单处于待验收，未提前关闭。

 ## 回退原则
@@ -2,8 +2,8 @@
 generated: true (请先修改 Gitea Wiki，禁止直接编辑本文件)
 wiki_page: Home
 wiki_url: https://git.ilapage.cn/OPC/dev_harness/wiki/Home
-wiki_revision: 4f5f2282034c784d0cc23fe3eb37f28815139612
-synchronized_at: 2026-08-24T08:55:15Z
+wiki_revision: e78a0eb55ce09d400e5e54f17ae96cc43c8694fc
+synchronized_at: 2026-08-25T00:40:23Z
 <!-- gitea-wiki-mirror:end -->

 # DevHarness 文档中心
@@ -21,7 +21,7 @@ DevHarness 是一个以 Gitea 工单管理开发任务、以 Wiki 管理长期
 5. [本地开发与验证](Local-Development-and-Verification.-)：怎样运行、测试和排错。
 6. [常见修改指南](Common-Changes.-)：简单修改的步骤和停止条件。
 7. [故障排查](Troubleshooting)：遇到错误时按什么顺序检查。
-8. [开发工作流](Development-Workflow.-)：完整建单、实施、验收和归档流程。
+8. [开发工作流](Development-Workflow.-)：完整建单、实施、验收和可选快照流程。

 从模板创建新项目时先阅读[新项目文档初始化](New-Project-Documentation-Setup.-)；向已有项目增量接入本流程时阅读[已有项目接入 DevHarness 指南](Existing-Project-Adoption-Guide.-)。需要为客户或其他岗位准备说明时，阅读[交付文档指南](Delivery-Documentation-Guide.-)，再按需使用[岗位文档模板](Audience-Document-Template.-)。