feat: 引入 Wiki 文档镜像流程 (#1)

AGENTS.md

@@ -1,12 +1,12 @@
 # Agent 开发规则
 
-本仓库采用 DevHarness 工作流：Gitea 工单是实施期间的事实来源，Git 是代码变更记录，`docs/task` 是完成后的最终归档。人负责确认方案与验收，Agent 负责检查、实现、测试和留下证据。
+本仓库采用 DevHarness 工作流：Gitea 工单是任务过程的事实来源，Gitea Wiki 是长期开发文档和任务归档的事实来源，Git 是代码与版本绑定资料的变更记录，`docs/` 只保存 Wiki 的只读镜像。人负责确认方案与验收，Agent 负责检查、实现、测试和留下证据。
 
 开始工作前先阅读 [项目档案](docs/00-project-profile.md) 和任务涉及目录中的 `AGENTS.md`。目录越深的规则越具体，但不得削弱上级安全规则。
 
 ## 1. 永久规则
 
-- 不把密码、令牌、Cookie、私钥、个人数据或生产数据写入代码、日志、工单和文档。
+- 不把密码、令牌、Cookie、私钥、个人数据或生产数据写入代码、日志、工单、Wiki 和文档。
 - 不执行未经用户明确授权的发布、付款、删除数据、破坏性迁移或其他不可逆操作。
 - 保留用户已有和任务无关的工作区改动，不擅自重置、覆盖或混入提交。
 - 发现需求与安全规则、已确认方案或现有数据冲突时，先停止实施并说明影响。
@@ -36,6 +36,7 @@
 5. 开始实施前检查分支和工作区，明确哪些现有改动不属于本任务。
 6. 严格按工单范围实现；新发现的问题先记录，不顺手混入当前任务。
 7. 执行与风险相称的测试，把关键结果和未验证部分更新到工单。
+8. 长期文档必须先修改 Wiki、读取确认，再运行 `python scripts/sync_wiki_docs.py` 导出本地镜像；不得直接编辑 `docs/` 后反向覆盖 Wiki。
 
 Gitea 不可用时，输出完整工单草稿并说明阻塞。未经用户明确授权，不得默认绕过建单。
 
@@ -61,6 +62,7 @@ Epic：完整产品目标和长期路线
 - 变化影响 MVP 或 Epic 时，同时更新父工单。
 - 会改变用户已确认结果的变化，更新工单后必须再次等待用户确认。
 - 阻塞、失败方案和新发现根因不能只留在聊天或代码注释中。
+- Wiki 页面删除、重命名或事实源边界变化时，必须先更新工单并等待用户确认；同步工具不得自动传播删除或重命名。
 - 工单状态应使用：待确认、待实施、进行中、阻塞、待验收、已完成。
 
 ## 6. Git 与验证
@@ -76,10 +78,11 @@ Epic：完整产品目标和长期路线
 1. 实现完成后逐项检查验收标准，并提交代码。
 2. 更新单元工单：最终方案、方案差异、测试结果、提交哈希和遗留问题。
 3. 工单保持“待验收”，用户没有明确验收通过前不得关闭。
-4. 按 `docs/templates/task-archive.md` 创建 `docs/task/<编号>-<短标题>.md`。
-5. 归档文档单独提交，例如：`docs: 归档任务 #123`。
-6. 把归档路径和提交哈希回写工单。
-7. 用户验收通过后关闭单元工单，并同步更新 MVP 和 Epic。
+4. 运行 `python scripts/new_task_archive.py <编号> "<短标题>"`，先在 Wiki 创建任务归档，再登记映射并导出 `docs/task/<编号>-<短标题>.md` 镜像。
+5. 读取确认 Wiki 页面，运行 `python scripts/sync_wiki_docs.py --check` 校验镜像。
+6. 归档镜像单独提交，例如：`docs: 归档任务 #123`。
+7. 把 Wiki 页面、revision、镜像路径和提交哈希回写工单。
+8. 用户验收通过后关闭单元工单，并同步更新 MVP 和 Epic。
 
 MVP 内所有单元任务通过后才能做 MVP 集成验收；MVP 通过后才能关闭 MVP。Epic 的全部范围完成后才能关闭 Epic。
 
@@ -89,7 +92,7 @@ MVP 内所有单元任务通过后才能做 MVP 集成验收；MVP 通过后才
 - 类和函数保持单一职责，名称表达业务含义。
 - 注释解释原因、边界和风险，不逐行翻译代码。
 - 错误必须可定位，不静默吞掉失败。
-- 文档先写结论和用途，再写步骤；示例命令应可直接复制。
+- Wiki 文档先写结论和用途，再写步骤；示例命令应可直接复制，本地 `docs/` 由同步工具生成。
 - 面向初级维护者说明从哪里开始读、怎样运行和怎样验证。
 
 ## 9. 引导提交例外
@@ -102,4 +105,7 @@ MVP 内所有单元任务通过后才能做 MVP 集成验收；MVP 通过后才
 
 <!-- 在项目初始化时填写不可违反的技术、安全和业务约束。复杂子项目请在其目录中增加 AGENTS.md。 -->
 
-- 尚未配置。开始产品开发前必须填写项目档案，并删除本行。
+- 长期开发文档以 Gitea Wiki 为事实来源，`docs/` 是显式映射生成的只读镜像。
+- Wiki 与镜像的固定顺序是：修改 Wiki → 读取确认 → 导出 `docs` → 校验差异 → 提交镜像。
+- 同步配置只允许写入 `docs/` 下的 Markdown；发现镜像有未提交修改时必须停止。
+- Gitea 凭据只通过进程环境或 MCP 安全配置提供，不得写入仓库。