Table of Contents

20 Gitea Wiki首页初始化硬门禁

背景与目标
最终方案
修改文件
验收结果
测试
Wiki 证据
遗留问题
相关提交
人工验收

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

20 Gitea Wiki首页初始化硬门禁

类型：流程文档
状态：已完成
日期：2026-08-17
Gitea 工单：#20
Wiki 页面：Task-20-Gitea-Wiki首页初始化硬门禁
本地镜像：按 #14 规则不自动导出

背景与目标

修复新项目可能只保留模板 docs/、却没有创建线上 Wiki 首页和核心页面的问题。让线上 Wiki 初始化成为产品编码前的硬门禁。

最终方案

先创建 Gitea 远端并启用工单和 Wiki，再配置映射和访问。
优先使用已配置的 Gitea MCP；MCP 不可用或缺少所需写能力时使用 Gitea API，并记录回退原因。
先查询在线页面；缺少 Home 时必须先创建、回读正文并取得 revision，再处理其他核心页面。
所有 wiki-docs.json 核心映射页面都必须在线存在、可回读且具有 revision。
本地 docs/ 或仅通过本地严格检查不能证明线上 Wiki 已初始化。
产品编码前必须完成 Wiki 导出、Harness 严格检查和在线一致性检查。
不新增初始化脚本，不提供本地文档反向覆盖 Wiki 的能力。

修改文件

AGENTS.md：增加新项目 Wiki 初始化门禁。
README.md：修正快速开始顺序并增加编码前在线检查。
dev_scripts/check_harness.py：检查初始化指南、Agent 规则和 README 门禁。
tests/test_harness_docs.py：增加初始化门禁测试。
docs/01-workflow.md：镜像线上开发工作流。
docs/07-new-project-documentation-setup.md：镜像线上初始化步骤。
docs/09-product-requirements-overview.md：登记 #20 状态与入口。

验收结果

验收标准	结果
README 先建远端再创建 Wiki	通过
Gitea MCP 优先、API 回退并记录原因	通过
Home 必须先创建并回读 revision	通过
所有核心映射页面在线存在后才允许编码	通过
本地 docs 不能作为在线初始化证据	通过
在线一致性检查属于编码前门禁	通过
未新增初始化脚本或反向同步	通过
工单保持待验收	通过

测试

python dev_scripts/check_harness.py --strict：通过。
python -m unittest discover -s tests -v：40 项全部通过。
python dev_scripts/sync_wiki_docs.py --check：14 个核心页面一致。
git diff --check：通过。
人工场景：没有 Home 时先创建并回读；已有 Home 但缺页时继续逐页创建且未完成前禁止编码；全部映射页可回读并通过一致性检查后才放行。
未验证部分：没有在一个全新的外部业务仓库完整执行初始化；本任务验证当前仓库的在线读取、revision 和镜像闭环。

Wiki 证据

Development-Workflow revision：8483fab908ad0530702a4791b79e2f98725301f8
New-Project-Documentation-Setup revision：69ec9144d1d97ee0964d1145059c476e84f5fd28
Product-Requirements-Overview 待验收 revision：ff4d1e7b59ad09fd15b4f51ca454baa481abcd13

遗留问题

无。

人工验收

结果：通过
日期：2026-08-17
确认来源：用户明确回复“通过验收 #20”
6f7cce2 docs: archive acceptance for Wiki initialization gate (#20)