docs: 明确 Home 在线创建与回读顺序 (#20)

New-Project-Documentation-Setup.-.md

@@ -94,7 +94,9 @@
 
 ### 4. 建立 Gitea
 
-创建远端仓库并完成允许的初始引导提交。开启工单和 Wiki。任何产品功能开发在引导提交后都必须先有单元任务工单。
+创建远端仓库并完成允许的初始引导提交，开启工单和 Wiki；必须先有远端仓库，才能填写该仓库的线上 Wiki。配置项目已有的 Gitea MCP 和安全凭据；优先使用 MCP，MCP 不可用或不支持所需写操作时才回退到 Gitea API，并在初始化工单记录原因。凭据只通过环境或 MCP 安全配置提供。
+
+任何产品功能开发在引导提交后都必须先有单元任务工单，并且必须通过第 8 步的线上 Wiki 初始化门禁。
 
 ### 5. 修改镜像配置
 
@@ -131,6 +133,13 @@ Agent 只读检查：
 
 ### 8. 先创建线上 Wiki
 
+#### 在线创建与回读门禁
+
+1. 使用配置好的 Gitea MCP 查询目标仓库的 Wiki 页面列表；MCP 不可用时使用 Gitea API，并记录回退原因。
+2. 如果 `Home` 不存在，先创建 `Home`。创建后立即在线回读正文并记录 revision；`Home` 可读取后才能继续。
+3. 依照 `wiki-docs.json` 逐页创建或更新其他核心页面。每页写入后在线回读正文，记录页面名和 revision。
+4. 本地 `docs/` 是模板或 Wiki 镜像；本地文件存在、标题完整或 `check_harness.py --strict` 通过，都不能单独证明线上 Wiki 已初始化。
+5. 页面缺失、回读失败或没有 revision 时停止初始化，不得开始产品代码；Gitea 恢复后从首个失败页面继续。
 至少创建或填写：
 
 1. Home；
@@ -170,6 +179,8 @@ python -m unittest discover -s tests -v
 
 只有线上 Wiki 确认后才导出核心 `docs/`。任务归档默认不导出；用户明确要求时再运行 `python dev_scripts/export_task_archives.py` 或加 `--all`。旧项目的任务归档快照不能带入新项目历史。
 
+`sync_wiki_docs.py --check` 会在线读取全部显式映射页面；任一页面不存在、无法读取或 revision 与镜像不一致时，初始化不通过。只有上述命令全部成功后才允许开始产品代码。
+
 ## 完成标准
 
 初级程序员应能仅依靠 Home 和链接页面回答：