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

T41 升级 GoAuto 的 DevHarness 文档基线 #43

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

基本信息

  • 类型：文档 / DevHarness 基线升级
  • 所属 Epic：无（开发治理）
  • 所属 MVP / 版本：当前仓库文档体系
  • 阶段：已完成（2026-08-17 实施，2026-08-19 归档关闭）；基线已由 #47 取代

依赖与并行

  • 前置工单：无
  • 是否允许并行：是，仅修改开发规则、工单模板和长期文档
  • 原因：不改变服务端、Web、Android、数据库或共享 API 行为

子项目影响

  • 仅影响的交付单元：shared-docs / 根开发规则 / Gitea 工单模板
  • 是否跨子项目：否
  • 是否修改共享接口或契约：否；docs/08-agent-api-contract.md 内容不变
  • 验证：Markdown 链接/结构检查、事实一致性检查、Git 差异检查

原始需求

  • 来源：用户对话
  • 提出时间：2026-08-17
  • 摘要：当前项目文档基于 D:\OPC\dev_harness 创建；该模板已经更新，要求参考最新版更新 GoAuto 项目文档。

要解决什么

GoAuto 仍使用旧版 DevHarness 文档结构，缺少可复现的模板基线、产品需求与原型索引、工单与设计证据双门禁、自然语言快捷指令、范围/效率控制和升级边界。最新版 DevHarness 目标提交为 b1f500128d6eb100985792d4a715db8b6b5ae203。

GoAuto Gitea Wiki 当前 API 返回 404，且仓库现有规则要求 Wiki 切换必须单独建单，因此本工单继续以 Git docs/ 为当前长期文档事实来源，不虚构 Wiki 同步已经启用。

做什么 / 不做什么

  • 做：增量合并新版开发规则；升级单元任务模板；记录 DevHarness 来源与目标基线；完善需求/原型索引、文档阅读入口、常见修改和工作流；保留 GoAuto 专用安全与业务规则。
  • 不做：不启用或创建 Gitea Wiki；不复制 DevHarness 任务归档；不复制模板项目事实；不引入 Wiki 同步/任务导出脚本；不修改产品代码、接口、数据库和运行行为；不删除现有 GoAuto 专题文档。

已确认方案

  • AGENTS.md：吸收新版工单/设计双门禁、快捷指令、范围控制和需求记录边界，同时保持 GoAuto 永久规则。
  • .gitea/issue_template/task.md：增加设计与原型门禁、交付文档影响和可复制验证要求。
  • CLAUDE.md：保留共同规则单一入口，吸收适用的模型路由和只读协作边界。
  • docs/00-project-profile.md：记录 DevHarness 目标基线、go-admin/go-admin-ui 建设基线、文档事实来源和升级日期。
  • docs/01-workflow.md：加入双门禁、需求追溯、快捷指令、范围控制；所有 Wiki 指令标为尚未启用。
  • docs/README.md、docs/05-common-changes.md：更新阅读顺序、事实来源、风险与停止条件。
  • docs/07-mvp-requirements.md：升级为兼具当前采集 MVP 详情和长期需求/原型索引的产品需求入口。
  • docs/09-delivery-issues.md：补充 #31～#42 后续商品/采购设计工单索引，不改变其实施状态。

设计与原型门禁

  • 修改类型：非 UI 文档治理
  • 所需设计证据：现有项目增量升级差异与目标提交
  • 事实来源：D:\OPC\dev_harness 提交 b1f500128d6eb100985792d4a715db8b6b5ae203
  • 状态：用户已要求执行
  • 无需 UI 原型原因：不改变产品界面或用户业务流程

文档影响

  • 更新项目档案
  • 更新开发工作流
  • 更新产品需求/原型索引
  • 更新常见修改与文档中心
  • 更新工单模板和 Agent 规则
  • 不更新 API 契约、架构与业务规则正文

交付文档影响

  • 无面向客户/采购人员的交付文档影响；本任务只更新开发治理文档

验收标准

  • 明确记录 DevHarness 来源、目标完整提交和升级日期。
  • GoAuto 项目专用安全、采集和禁止支付规则未被模板覆盖。
  • [~] 文档明确 Git docs/ 仍为当前事实来源，Wiki-first 仍需独立工单。 已废止：Wiki 于 2026-08-17 完成初始化并启用 Wiki-first，本条前提被现实推翻。
  • 产品需求入口可以找到当前采集 MVP、#31/#32 原型和 #33～#42 后续工单。
  • 工单模板包含设计证据和交付文档影响字段。
  • 文档没有 DevHarness 项目占位值、任务归档或无效 Wiki 命令。
  • Markdown/链接/工作区检查通过，Git 差异只包含本工单文件。

验证方式

git diff --check
rg -n "b1f500128d6eb100985792d4a715db8b6b5ae203|工单与设计证据双门禁|自然语言快捷指令" AGENTS.md docs .gitea
rg -n "dev_harness/issues|gitea-wiki-mirror:start|python dev_scripts" AGENTS.md docs .gitea

人工核对 #31/#32 原型链接、#33～#42 工单链接和 GoAuto 永久规则。

风险和回退

风险是把尚未启用的 Wiki-first 流程写成当前事实，或用模板文字覆盖 GoAuto 专用规则。回退只恢复本工单修改的规则、模板和文档，不触碰业务代码或历史。

## 基本信息 - 类型：文档 / DevHarness 基线升级 - 所属 Epic：无（开发治理） - 所属 MVP / 版本：当前仓库文档体系 - 阶段：已完成（2026-08-17 实施，2026-08-19 归档关闭）；基线已由 #47 取代 ## 依赖与并行 - 前置工单：无 - 是否允许并行：是，仅修改开发规则、工单模板和长期文档 - 原因：不改变服务端、Web、Android、数据库或共享 API 行为 ## 子项目影响 - 仅影响的交付单元：shared-docs / 根开发规则 / Gitea 工单模板 - 是否跨子项目：否 - 是否修改共享接口或契约：否；`docs/08-agent-api-contract.md` 内容不变 - 验证：Markdown 链接/结构检查、事实一致性检查、Git 差异检查 ## 原始需求 - 来源：用户对话 - 提出时间：2026-08-17 - 摘要：当前项目文档基于 `D:\OPC\dev_harness` 创建；该模板已经更新，要求参考最新版更新 GoAuto 项目文档。 ## 要解决什么 GoAuto 仍使用旧版 DevHarness 文档结构，缺少可复现的模板基线、产品需求与原型索引、工单与设计证据双门禁、自然语言快捷指令、范围/效率控制和升级边界。最新版 DevHarness 目标提交为 `b1f500128d6eb100985792d4a715db8b6b5ae203`。 GoAuto Gitea Wiki 当前 API 返回 404，且仓库现有规则要求 Wiki 切换必须单独建单，因此本工单继续以 Git `docs/` 为当前长期文档事实来源，不虚构 Wiki 同步已经启用。 ## 做什么 / 不做什么 - 做：增量合并新版开发规则；升级单元任务模板；记录 DevHarness 来源与目标基线；完善需求/原型索引、文档阅读入口、常见修改和工作流；保留 GoAuto 专用安全与业务规则。 - 不做：不启用或创建 Gitea Wiki；不复制 DevHarness 任务归档；不复制模板项目事实；不引入 Wiki 同步/任务导出脚本；不修改产品代码、接口、数据库和运行行为；不删除现有 GoAuto 专题文档。 ## 已确认方案 - `AGENTS.md`：吸收新版工单/设计双门禁、快捷指令、范围控制和需求记录边界，同时保持 GoAuto 永久规则。 - `.gitea/issue_template/task.md`：增加设计与原型门禁、交付文档影响和可复制验证要求。 - `CLAUDE.md`：保留共同规则单一入口，吸收适用的模型路由和只读协作边界。 - `docs/00-project-profile.md`：记录 DevHarness 目标基线、go-admin/go-admin-ui 建设基线、文档事实来源和升级日期。 - `docs/01-workflow.md`：加入双门禁、需求追溯、快捷指令、范围控制；所有 Wiki 指令标为尚未启用。 - `docs/README.md`、`docs/05-common-changes.md`：更新阅读顺序、事实来源、风险与停止条件。 - `docs/07-mvp-requirements.md`：升级为兼具当前采集 MVP 详情和长期需求/原型索引的产品需求入口。 - `docs/09-delivery-issues.md`：补充 #31～#42 后续商品/采购设计工单索引，不改变其实施状态。 ## 设计与原型门禁 - 修改类型：非 UI 文档治理 - 所需设计证据：现有项目增量升级差异与目标提交 - 事实来源：`D:\OPC\dev_harness` 提交 `b1f500128d6eb100985792d4a715db8b6b5ae203` - 状态：用户已要求执行 - 无需 UI 原型原因：不改变产品界面或用户业务流程 ## 文档影响 - [x] 更新项目档案 - [x] 更新开发工作流 - [x] 更新产品需求/原型索引 - [x] 更新常见修改与文档中心 - [x] 更新工单模板和 Agent 规则 - [ ] 不更新 API 契约、架构与业务规则正文 ## 交付文档影响 - [x] 无面向客户/采购人员的交付文档影响；本任务只更新开发治理文档 ## 验收标准 - [x] 明确记录 DevHarness 来源、目标完整提交和升级日期。 - [x] GoAuto 项目专用安全、采集和禁止支付规则未被模板覆盖。 - [~] ~~文档明确 Git `docs/` 仍为当前事实来源，Wiki-first 仍需独立工单。~~ **已废止**：Wiki 于 2026-08-17 完成初始化并启用 Wiki-first，本条前提被现实推翻。 - [x] 产品需求入口可以找到当前采集 MVP、#31/#32 原型和 #33～#42 后续工单。 - [x] 工单模板包含设计证据和交付文档影响字段。 - [x] 文档没有 DevHarness 项目占位值、任务归档或无效 Wiki 命令。 - [x] Markdown/链接/工作区检查通过，Git 差异只包含本工单文件。 ## 验证方式 ```powershell git diff --check rg -n "b1f500128d6eb100985792d4a715db8b6b5ae203|工单与设计证据双门禁|自然语言快捷指令" AGENTS.md docs .gitea rg -n "dev_harness/issues|gitea-wiki-mirror:start|python dev_scripts" AGENTS.md docs .gitea ``` 人工核对 #31/#32 原型链接、#33～#42 工单链接和 GoAuto 永久规则。 ## 风险和回退 风险是把尚未启用的 Wiki-first 流程写成当前事实，或用模板文字覆盖 GoAuto 专用规则。回退只恢复本工单修改的规则、模板和文档，不触碰业务代码或历史。
ila commented 2026-08-17 11:17:21 +08:00
Author
Owner
Copy Link
Copy Source

????(??? 2026-08-17 ????):??? GoAuto Gitea Wiki ??,????? Wiki Git ?????????????????????,???????;??????Wiki?????????????????,??????????????

????(??? 2026-08-17 ????):??? GoAuto Gitea Wiki ??,????? Wiki Git ?????????????????????,???????;??????Wiki?????????????????,??????????????
ila commented 2026-08-17 11:20:45 +08:00
Author
Owner
Copy Link
Copy Source

Wiki ??????????:

  • ??:https://git.ilapage.cn/OPC/goauto/wiki/Home
  • API ??????:d63c5b4b85f8ece15c868715cfb3cd7bc7fcb9f6
  • API ???? Wiki Git ?????????:ffff37bea10003e55548e74d76dd2929dab9ed18
  • ?? Wiki Git ??? push ??:aa2d74543ee4c89a7ff36d3706c49ecace4d5481
  • ????:?? API ??????? ls-remote/clone ???pull ????? git push ????? HEAD ????????
  • ??:?? Token ?????Wiki??????;????????

????? Home ????????????,???? docs/ ??????????;Wiki-first ??????????????????????

Wiki ??????????: - ??:https://git.ilapage.cn/OPC/goauto/wiki/Home - API ??????:`d63c5b4b85f8ece15c868715cfb3cd7bc7fcb9f6` - API ???? Wiki Git ?????????:`ffff37bea10003e55548e74d76dd2929dab9ed18` - ?? Wiki Git ??? `push` ??:`aa2d74543ee4c89a7ff36d3706c49ecace4d5481` - ????:?? API ??????? `ls-remote`/`clone` ???`pull` ????? `git push` ????? HEAD ???????? - ??:?? Token ?????Wiki??????;???????? ????? `Home` ????????????,???? `docs/` ??????????;Wiki-first ??????????????????????
ila commented 2026-08-17 11:25:49 +08:00
Author
Owner
Copy Link
Copy Source

???????????? Wiki-first?#43 ?????:?? GoAuto ????????? Gitea Wiki;???? wiki-docs.json ???Wiki?docs ?????????????/???????????;? docs/ ???? Markdown ????????docs/rules/*.json ??????????????? Git????? DevHarness ???????????,?????????? Wiki ???

???????????? Wiki-first?#43 ?????:?? GoAuto ????????? Gitea Wiki;???? `wiki-docs.json` ???Wiki?docs ?????????????/???????????;? `docs/` ???? Markdown ????????`docs/rules/*.json` ??????????????? Git????? DevHarness ???????????,?????????? Wiki ???
ila commented 2026-08-17 11:33:33 +08:00
Author
Owner
Copy Link
Copy Source

Wiki-first 迁移已完成并停在待验收：

当前未执行 git push：本地 main 比 origin/main 多 12 个提交，其中 10 个属于 #22 到 #30；直接推送会同时发布这些旧提交，需用户明确确认。

归档更新时 PowerShell 对中文标题编码异常，额外产生了一个精确可识别的错误页面 Task-43-??-GoAuto-DevHarness-????。正确中文归档已经核对无误；按照“Wiki 页面删除需人工确认”规则，错误页面尚未删除，等待用户授权。

Wiki-first 迁移已完成并停在待验收： - 14 个核心 Wiki 页面已创建或更新并逐页回读。 - `wiki-docs.json` 显式映射 14 个页面。 - Wiki 到 `docs/` 单向导出完成，`python dev_scripts/sync_wiki_docs.py --check` 显示 14 项一致。 - Wiki 工具单元测试 16 项通过；`git diff --check` 通过。 - 本地提交：`a4ac398`、`10966c5`。 - 正确任务归档：https://git.ilapage.cn/OPC/goauto/wiki/Task-43-%E5%8D%87%E7%BA%A7-GoAuto-DevHarness-%E6%96%87%E6%A1%A3%E5%9F%BA%E7%BA%BF.- （revision `28308d77b7755ee5d55e22930f6a84ae2e3b6f3d`）。 当前未执行 `git push`：本地 `main` 比 `origin/main` 多 12 个提交，其中 10 个属于 #22 到 #30；直接推送会同时发布这些旧提交，需用户明确确认。 归档更新时 PowerShell 对中文标题编码异常，额外产生了一个精确可识别的错误页面 `Task-43-??-GoAuto-DevHarness-????`。正确中文归档已经核对无误；按照“Wiki 页面删除需人工确认”规则，错误页面尚未删除，等待用户授权。
ila commented 2026-08-17 11:36:05 +08:00
Author
Owner
Copy Link
Copy Source

用户授权后的收尾已完成：

  • 已精确删除误生成页面 Task-43-??-GoAuto-DevHarness-????，删除前核对正文和提交标记；删除后错误页面数量为 0，正确中文归档仍存在。
  • 已在确认本地不落后远端且正好领先 12 个提交后，以普通快进方式推送 main，未强推、未改写历史。
  • 远端与本地 HEAD 均为 10966c5c25ec2b01288503b34d2bd617f737a8cc。
  • 正确任务归档已更新为最终证据，revision：2362b784d4a31e17d9381ff4397ca5f539d8e609。
  • 工单继续保持待验收，未关闭。
用户授权后的收尾已完成： - 已精确删除误生成页面 `Task-43-??-GoAuto-DevHarness-????`，删除前核对正文和提交标记；删除后错误页面数量为 0，正确中文归档仍存在。 - 已在确认本地不落后远端且正好领先 12 个提交后，以普通快进方式推送 `main`，未强推、未改写历史。 - 远端与本地 HEAD 均为 `10966c5c25ec2b01288503b34d2bd617f737a8cc`。 - 正确任务归档已更新为最终证据，revision：`2362b784d4a31e17d9381ff4397ca5f539d8e609`。 - 工单继续保持待验收，未关闭。
ila commented 2026-08-19 09:29:26 +08:00
Author
Owner
Copy Link
Copy Source

关闭说明：工作已完成，基线已由 #47 取代

用户 2026-08-19 确认一并处理。本工单的实施发生在 2026-08-17，当时未走归档与关闭流程，遗留为 open。现补齐归档并关闭。

验收标准逐条核对（2026-08-19 对当前仓库状态复核）

标准 结果
记录 DevHarness 来源、完整提交和升级日期 通过
GoAuto 专用安全、采集和禁止支付规则未被覆盖 通过
文档明确 Git docs/ 仍为事实来源，Wiki-first 仍需独立工单 已废止
产品需求入口可找到采集 MVP、#31/#32 原型和 #33～#42 工单 通过
工单模板包含设计证据和交付文档影响字段 通过
无 DevHarness 占位值、任务归档或无效 Wiki 命令 通过（残留 0 处）
Markdown/链接/工作区检查通过 通过（git diff --check 无错误，工作区干净）

关于那条已废止的标准

本工单正文写有「GoAuto Gitea Wiki 当前 API 返回 404」，据此把「Git docs/ 仍为当前事实来源、Wiki-first 仍需独立工单」列为验收标准。该前提此后被推翻：Wiki 于 2026-08-17 完成核心页面迁移、显式映射和单向同步验证，长期文档已采用 Wiki-first（见 Project-Profile）。因此该条不再适用，不作为未通过项处理。

工单正文中相应的过时表述保持归档原样不修改，当前事实以 Project-Profile 与 AGENTS.md 为准。

基线取代关系

本工单确立的 b1f500128d6eb100985792d4a715db8b6b5ae203 已由 #47 T45 升级 DevHarness 文档基线至 bfdf648 取代，升级区间 12 个提交。后续 DevHarness 基线以 #47 为准。

任务归档

Task 43 升级 DevHarness 文档基线（使用新的 harness.py archive 命令创建，同时验证了 #47 的工具改造）

未验证部分

本工单实施于 2026-08-17，当时未留下逐条验证记录。以上核对为关闭前对当前仓库状态的补充确认，不代表当时的即时验证结果。

## 关闭说明：工作已完成，基线已由 #47 取代 用户 2026-08-19 确认一并处理。本工单的实施发生在 2026-08-17，当时未走归档与关闭流程，遗留为 open。现补齐归档并关闭。 ### 验收标准逐条核对（2026-08-19 对当前仓库状态复核） | 标准 | 结果 | |---|---| | 记录 DevHarness 来源、完整提交和升级日期 | 通过 | | GoAuto 专用安全、采集和禁止支付规则未被覆盖 | 通过 | | 文档明确 Git `docs/` 仍为事实来源，Wiki-first 仍需独立工单 | **已废止** | | 产品需求入口可找到采集 MVP、#31/#32 原型和 #33～#42 工单 | 通过 | | 工单模板包含设计证据和交付文档影响字段 | 通过 | | 无 DevHarness 占位值、任务归档或无效 Wiki 命令 | 通过（残留 0 处） | | Markdown/链接/工作区检查通过 | 通过（`git diff --check` 无错误，工作区干净） | ### 关于那条已废止的标准 本工单正文写有「GoAuto Gitea Wiki 当前 API 返回 404」，据此把「Git `docs/` 仍为当前事实来源、Wiki-first 仍需独立工单」列为验收标准。该前提此后被推翻：**Wiki 于 2026-08-17 完成核心页面迁移、显式映射和单向同步验证，长期文档已采用 Wiki-first**（见 `Project-Profile`）。因此该条不再适用，不作为未通过项处理。 工单正文中相应的过时表述**保持归档原样不修改**，当前事实以 `Project-Profile` 与 `AGENTS.md` 为准。 ### 基线取代关系 本工单确立的 `b1f500128d6eb100985792d4a715db8b6b5ae203` 已由 [#47 T45 升级 DevHarness 文档基线至 bfdf648](https://git.ilapage.cn/OPC/goauto/issues/47) 取代，升级区间 12 个提交。后续 DevHarness 基线以 #47 为准。 ### 任务归档 [Task 43 升级 DevHarness 文档基线](https://git.ilapage.cn/OPC/goauto/wiki/Task-43-%E5%8D%87%E7%BA%A7-DevHarness-%E6%96%87%E6%A1%A3%E5%9F%BA%E7%BA%BF.-)（使用新的 `harness.py archive` 命令创建，同时验证了 #47 的工具改造） ### 未验证部分 本工单实施于 2026-08-17，当时未留下逐条验证记录。以上核对为关闭前对当前仓库状态的补充确认，不代表当时的即时验证结果。
ila closed this issue 2026-08-19 09:29:27 +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/goauto#43