OPC/dev_harness
2
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

增加Gitea Wiki首页初始化硬门禁 #20

New Issue
Closed
opened 2026-08-17 11:20:12 +08:00 by ila · 0 comments
ila commented 2026-08-17 11:20:12 +08:00
Owner
Copy Link
Copy Source

基本信息

  • 类型：单元任务
  • 状态：已完成
  • 所属 Epic：无
  • 所属 MVP / 版本：无

依赖与并行

  • 前置工单：无
  • 是否允许并行：是
  • 原因：独立补强新项目初始化门禁。

原始需求

  • 来源：用户与 Agent 对话
  • 提出时间：2026-08-17
  • 关键原话或脱敏摘要：“有个项目使用当前模板，但一直没有去创建 Wiki 首页，导致文档没有保存到 Wiki”；用户确认按建议建工单并实施。

要解决什么

当前文档虽然列出 Home 和核心 Wiki 页面，但没有明确要求 Agent 使用 Gitea MCP/API 在线查询、创建并回读，也没有把线上 Wiki 存在性纳入产品编码前门禁；README 的远端创建顺序还有歧义。

做什么 / 不做什么

做

  • 修正 README 初始化顺序，先建立远端，再配置访问并创建 Wiki。
  • 在 AGENTS 和新项目初始化指南中明确优先使用配置好的 Gitea MCP，MCP 不可用时允许 Gitea API 回退并记录原因。
  • 明确先查询 Wiki，Home 不存在时先创建 Home，再创建其他核心页面。
  • 要求创建或更新后回读页面并记录 revision。
  • 把所有映射页面在线存在及 sync_wiki_docs.py --check 通过设为产品编码前门禁。
  • 更新 Development-Workflow 和对应核心 Wiki 镜像。
  • 更新 Harness 文档结构检查及测试。

不做

  • 不新增 Wiki 初始化脚本或自动从本地镜像反向覆盖 Wiki。
  • 不保存 Gitea Token，不改变凭据规则。
  • 不自动创建与项目无关的交付文档。
  • 不修改产品代码。

已确认方案

使用现有 Gitea MCP/API 和同步工具形成在线初始化闭环，不增加新的框架：建立远端并启用 Wiki → 配置安全访问 → 在线查询 → 先创建 Home → 创建核心页面 → 逐页回读 revision → 导出镜像 → 严格检查与在线一致性检查 → 才允许产品编码。

文档影响

  • 更新其他 Wiki：Development-Workflow、New-Project-Documentation-Setup、Product-Requirements-Overview
  • 更新仓库入口：README.md、AGENTS.md

交付文档影响

  • 无交付文档影响，原因：仅调整内部项目初始化流程。

设计与原型门禁

  • 修改类型：非 UI 流程规则
  • 所需设计证据：已确认的初始化顺序与在线门禁
  • 无需 UI 原型原因：不涉及用户界面。

验收标准

  • README 初始化顺序不存在先填 Wiki 后建远端的矛盾。
  • 明确 Gitea MCP 优先、API 回退及原因记录。
  • 明确 Home 必须先创建并回读 revision。
  • 明确所有核心映射页面在线存在后才允许产品编码。
  • docs/ 存在不能作为 Wiki 已初始化的证据。
  • sync_wiki_docs.py --check 成为产品编码前必要检查。
  • 未新增初始化脚本或反向同步能力。
  • Wiki 回读、镜像、严格检查和测试通过。
  • 提交推送并建立在线任务归档。
  • 工单保持待验收。

验证方式

  • python dev_scripts/check_harness.py --strict
  • python -m unittest discover -s tests -v
  • python dev_scripts/sync_wiki_docs.py --check
  • git diff --check
  • 人工检查“尚无 Home”“已有 Home 但缺页”“全部页面存在”三种初始化场景。

风险和回退

  • 风险：把平台特定 MCP 写成唯一依赖；通过 API 回退避免阻塞。
  • 风险：误把本地模板文档当线上事实；明确在线回读和 revision 才是初始化证据。
  • 回退：移除本次门禁措辞和检查项，不影响产品代码或数据。

实施与验证证据

  • 实现提交：89ca159；Wiki revision 同步提交：8cc6a37；待验收镜像提交：d5f83b8，均已推送到 origin/main。
  • Development-Workflow revision：8483fab908ad0530702a4791b79e2f98725301f8。
  • New-Project-Documentation-Setup revision：69ec9144d1d97ee0964d1145059c476e84f5fd28。
  • Product-Requirements-Overview revision：ff4d1e7b59ad09fd15b4f51ca454baa481abcd13。
  • Task-20 归档 revision：5867e6fad3eec423345bce6b0ac76512614f74f4；按 #14 规则仅保留在线 Wiki。
  • 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 与镜像闭环。

当前状态：已完成。工单保持开启，等待用户明确验收。

验收关闭记录

  • 用户确认：通过验收 #20
  • 验收日期：2026-08-17
  • Product-Requirements-Overview revision：36af67197fae307430a7c65b489332608cbb5c98
  • Task-20 最终归档 revision：3d91785cc6e1984aa279b8b1c7b87c20fc3c0f58
  • 验收归档镜像提交：6f7cce2
  • 父工单：无，无需同步 MVP 或 Epic
## 基本信息 - 类型：单元任务 - 状态：已完成 - 所属 Epic：无 - 所属 MVP / 版本：无 ## 依赖与并行 - 前置工单：无 - 是否允许并行：是 - 原因：独立补强新项目初始化门禁。 ## 原始需求 - 来源：用户与 Agent 对话 - 提出时间：2026-08-17 - 关键原话或脱敏摘要：“有个项目使用当前模板，但一直没有去创建 Wiki 首页，导致文档没有保存到 Wiki”；用户确认按建议建工单并实施。 ## 要解决什么 当前文档虽然列出 Home 和核心 Wiki 页面，但没有明确要求 Agent 使用 Gitea MCP/API 在线查询、创建并回读，也没有把线上 Wiki 存在性纳入产品编码前门禁；README 的远端创建顺序还有歧义。 ## 做什么 / 不做什么 ### 做 - 修正 README 初始化顺序，先建立远端，再配置访问并创建 Wiki。 - 在 AGENTS 和新项目初始化指南中明确优先使用配置好的 Gitea MCP，MCP 不可用时允许 Gitea API 回退并记录原因。 - 明确先查询 Wiki，Home 不存在时先创建 Home，再创建其他核心页面。 - 要求创建或更新后回读页面并记录 revision。 - 把所有映射页面在线存在及 `sync_wiki_docs.py --check` 通过设为产品编码前门禁。 - 更新 Development-Workflow 和对应核心 Wiki 镜像。 - 更新 Harness 文档结构检查及测试。 ### 不做 - 不新增 Wiki 初始化脚本或自动从本地镜像反向覆盖 Wiki。 - 不保存 Gitea Token，不改变凭据规则。 - 不自动创建与项目无关的交付文档。 - 不修改产品代码。 ## 已确认方案 使用现有 Gitea MCP/API 和同步工具形成在线初始化闭环，不增加新的框架：建立远端并启用 Wiki → 配置安全访问 → 在线查询 → 先创建 Home → 创建核心页面 → 逐页回读 revision → 导出镜像 → 严格检查与在线一致性检查 → 才允许产品编码。 ## 文档影响 - [x] 更新其他 Wiki：Development-Workflow、New-Project-Documentation-Setup、Product-Requirements-Overview - [x] 更新仓库入口：README.md、AGENTS.md ## 交付文档影响 - [x] 无交付文档影响，原因：仅调整内部项目初始化流程。 ## 设计与原型门禁 - 修改类型：非 UI 流程规则 - 所需设计证据：已确认的初始化顺序与在线门禁 - 无需 UI 原型原因：不涉及用户界面。 ## 验收标准 - [x] README 初始化顺序不存在先填 Wiki 后建远端的矛盾。 - [x] 明确 Gitea MCP 优先、API 回退及原因记录。 - [x] 明确 Home 必须先创建并回读 revision。 - [x] 明确所有核心映射页面在线存在后才允许产品编码。 - [x] `docs/` 存在不能作为 Wiki 已初始化的证据。 - [x] `sync_wiki_docs.py --check` 成为产品编码前必要检查。 - [x] 未新增初始化脚本或反向同步能力。 - [x] Wiki 回读、镜像、严格检查和测试通过。 - [x] 提交推送并建立在线任务归档。 - [x] 工单保持待验收。 ## 验证方式 - `python dev_scripts/check_harness.py --strict` - `python -m unittest discover -s tests -v` - `python dev_scripts/sync_wiki_docs.py --check` - `git diff --check` - 人工检查“尚无 Home”“已有 Home 但缺页”“全部页面存在”三种初始化场景。 ## 风险和回退 - 风险：把平台特定 MCP 写成唯一依赖；通过 API 回退避免阻塞。 - 风险：误把本地模板文档当线上事实；明确在线回读和 revision 才是初始化证据。 - 回退：移除本次门禁措辞和检查项，不影响产品代码或数据。 ## 实施与验证证据 - 实现提交：`89ca159`；Wiki revision 同步提交：`8cc6a37`；待验收镜像提交：`d5f83b8`，均已推送到 `origin/main`。 - Development-Workflow revision：`8483fab908ad0530702a4791b79e2f98725301f8`。 - New-Project-Documentation-Setup revision：`69ec9144d1d97ee0964d1145059c476e84f5fd28`。 - Product-Requirements-Overview revision：`ff4d1e7b59ad09fd15b4f51ca454baa481abcd13`。 - Task-20 归档 revision：`5867e6fad3eec423345bce6b0ac76512614f74f4`；按 #14 规则仅保留在线 Wiki。 - `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 与镜像闭环。 当前状态：已完成。工单保持开启，等待用户明确验收。 ## 验收关闭记录 - 用户确认：通过验收 #20 - 验收日期：2026-08-17 - Product-Requirements-Overview revision：`36af67197fae307430a7c65b489332608cbb5c98` - Task-20 最终归档 revision：`3d91785cc6e1984aa279b8b1c7b87c20fc3c0f58` - 验收归档镜像提交：`6f7cce2` - 父工单：无，无需同步 MVP 或 Epic
ila closed this issue 2026-08-17 11:34:36 +08:00
Sign in to join this conversation.
No Branch/Tag Specified
Branches Tags
Labels
No items
No labels
Milestone
No items
No Milestone
Projects
Clear projects
No projects
Assignees
Clear assignees
admin ila
No Assignees
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: OPC/dev_harness#20