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

[Epic] cmautobuy 接入最新版 DevHarness 工作流 #310

New Issue
Open
opened 2026-08-26 16:24:50 +08:00 by ila · 1 comment
ila commented 2026-08-26 16:24:50 +08:00
Owner
Copy Link
Copy Source

背景与目标

cmautobuy 的现有协作规则由早期 DevHarness 思路演化而来，但没有记录可复现的上游基线，也尚未建立 Gitea Wiki。目标是增量接入 DevHarness 提交 �b6ec7675dfc2d930a30527eddac83f4302d0879 的当前工作流：Gitea 工单保存单次任务事实，Wiki 保存长期文档，Git 保存代码与 Wiki 镜像，同时保留本项目全部业务红线、子项目边界和历史。

当前状态：MVP #311 的全部 6 个单元任务已实施并保持打开，等待用户验收。

范围与非目标

  • 建立项目档案、Wiki 主源、镜像配置和检查工具。
  • 迁移并保留现有 Admin/Client 长期文档，建立首页、需求总览、代码地图、开发验证、排错和部署运维入口。
  • 切换 Gitea MCP 优先、最小工单读取、设计证据双门禁、自然语言快捷指令、依赖并行和按需任务快照流程。
  • 保留现有 docs/task 历史快照，不删除、不重命名、不批量重写。
  • 不改变 Admin/Client 产品行为、接口、数据库、采购安全红线或部署状态。
  • 不复制 DevHarness 的项目事实、工单、任务历史或通用 Python 部署示例。

总体架构决策

  1. 目标上游基线固定为完整提交 0b6ec7675dfc2d930a30527eddac83f4302d0879，升级日期 2026-08-26。
  2. 先初始化并在线回读 Wiki，再把本地长期文档切换为带来源头的只读镜像；不得先改镜像反推 Wiki。
  3. 当前详细 Admin/Client 文档继续保留并逐页迁移，不用通用模板覆盖项目事实。
  4. docs/task 从“每单强制归档”切换为历史兼容与人工明确要求的专项快照；切换只在 Wiki 闭环可用后生效。
  5. 根规则只放共同流程和五条红线；技术栈规则继续由 admin/AGENTS.md 与 client/AGENTS.md 管理。
  6. Gitea 操作优先 MCP；本地镜像同步使用仓库内 Harness，凭据只从安全环境取得。

阶段路线

  1. 项目档案与升级边界。
  2. Wiki/Harness 基础设施。
  3. 长期文档在线初始化与镜像。
  4. Agent、工单、设计证据和按需归档工作流切换。
  5. Admin 部署运维长期文档。
  6. 集成与严格验收。

子工单

  • #311 [MVP] Wiki 主源与 DevHarness 新工作流切换
    • #312 接入 Wiki 镜像工具与项目映射骨架（待验收）
    • #313 建立项目档案与核心导航 Wiki（待验收）
    • #314 迁移 Admin 与 Client 长期文档为 Wiki 镜像（待验收）
    • #315 切换 Agent、工单与设计证据工作流（待验收）
    • #316 建立 Admin 部署与运维长期 Wiki 文档（待验收）
    • #317 完成 DevHarness 升级集成验证与证据回写（待验收）

依赖、风险与回退

  • Wiki 当前为空；任何页面创建或回读失败都停止事实源切换。
  • 现有本地长期文档规模较大，迁移必须逐页核对，不删除旧内容。
  • 新旧流程切换期间以本 Epic 和实施工单标记阶段，不允许同时把两套规则都宣称为主源。
  • 回退时恢复本次规则、配置、工具和镜像头；不删除线上 Wiki、历史 docs/task 或业务提交。

最终验收

  • Wiki 核心页面和项目详细页面可在线读取并有 revision。
  • wiki-docs.json、同步检查和结构检查通过。
  • 本地 docs/ 与线上 Wiki 一致且镜像头完整。
  • 根/子项目规则无冲突，五条红线与 Client 契约边界未削弱。
  • 新工单模板和快捷指令可执行，默认不再制造第二份任务事实来源。
  • 用户完成 MVP 集成验收后才能关闭本 Epic。
## 背景与目标 cmautobuy 的现有协作规则由早期 DevHarness 思路演化而来，但没有记录可复现的上游基线，也尚未建立 Gitea Wiki。目标是增量接入 DevHarness 提交 �b6ec7675dfc2d930a30527eddac83f4302d0879 的当前工作流：Gitea 工单保存单次任务事实，Wiki 保存长期文档，Git 保存代码与 Wiki 镜像，同时保留本项目全部业务红线、子项目边界和历史。 当前状态：MVP #311 的全部 6 个单元任务已实施并保持打开，等待用户验收。 ## 范围与非目标 - 建立项目档案、Wiki 主源、镜像配置和检查工具。 - 迁移并保留现有 Admin/Client 长期文档，建立首页、需求总览、代码地图、开发验证、排错和部署运维入口。 - 切换 Gitea MCP 优先、最小工单读取、设计证据双门禁、自然语言快捷指令、依赖并行和按需任务快照流程。 - 保留现有 `docs/task` 历史快照，不删除、不重命名、不批量重写。 - 不改变 Admin/Client 产品行为、接口、数据库、采购安全红线或部署状态。 - 不复制 DevHarness 的项目事实、工单、任务历史或通用 Python 部署示例。 ## 总体架构决策 1. 目标上游基线固定为完整提交 `0b6ec7675dfc2d930a30527eddac83f4302d0879`，升级日期 2026-08-26。 2. 先初始化并在线回读 Wiki，再把本地长期文档切换为带来源头的只读镜像；不得先改镜像反推 Wiki。 3. 当前详细 Admin/Client 文档继续保留并逐页迁移，不用通用模板覆盖项目事实。 4. `docs/task` 从“每单强制归档”切换为历史兼容与人工明确要求的专项快照；切换只在 Wiki 闭环可用后生效。 5. 根规则只放共同流程和五条红线；技术栈规则继续由 `admin/AGENTS.md` 与 `client/AGENTS.md` 管理。 6. Gitea 操作优先 MCP；本地镜像同步使用仓库内 Harness，凭据只从安全环境取得。 ## 阶段路线 1. 项目档案与升级边界。 2. Wiki/Harness 基础设施。 3. 长期文档在线初始化与镜像。 4. Agent、工单、设计证据和按需归档工作流切换。 5. Admin 部署运维长期文档。 6. 集成与严格验收。 ## 子工单 - [ ] #311 [MVP] Wiki 主源与 DevHarness 新工作流切换 - [ ] #312 接入 Wiki 镜像工具与项目映射骨架（待验收） - [ ] #313 建立项目档案与核心导航 Wiki（待验收） - [ ] #314 迁移 Admin 与 Client 长期文档为 Wiki 镜像（待验收） - [ ] #315 切换 Agent、工单与设计证据工作流（待验收） - [ ] #316 建立 Admin 部署与运维长期 Wiki 文档（待验收） - [ ] #317 完成 DevHarness 升级集成验证与证据回写（待验收） ## 依赖、风险与回退 - Wiki 当前为空；任何页面创建或回读失败都停止事实源切换。 - 现有本地长期文档规模较大，迁移必须逐页核对，不删除旧内容。 - 新旧流程切换期间以本 Epic 和实施工单标记阶段，不允许同时把两套规则都宣称为主源。 - 回退时恢复本次规则、配置、工具和镜像头；不删除线上 Wiki、历史 `docs/task` 或业务提交。 ## 最终验收 - Wiki 核心页面和项目详细页面可在线读取并有 revision。 - `wiki-docs.json`、同步检查和结构检查通过。 - 本地 `docs/` 与线上 Wiki 一致且镜像头完整。 - 根/子项目规则无冲突，五条红线与 Client 契约边界未削弱。 - 新工单模板和快捷指令可执行，默认不再制造第二份任务事实来源。 - 用户完成 MVP 集成验收后才能关闭本 Epic。
ila commented 2026-08-26 17:25:31 +08:00
Author
Owner
Copy Link
Copy Source

#312～#317 已全部完成实施并各自保留最终证据，当前统一处于“待验收”且保持打开。#317 已完成 Wiki 34 页同步回读、Harness 严格检查、Admin Go 验证、Client 542 项隔离回归、历史归档与敏感信息核对。未执行生产部署或产品行为变更。父工单清单仍保留未勾选，等待用户验收并关闭对应单元任务后再同步完成状态。

#312～#317 已全部完成实施并各自保留最终证据，当前统一处于“待验收”且保持打开。#317 已完成 Wiki 34 页同步回读、Harness 严格检查、Admin Go 验证、Client 542 项隔离回归、历史归档与敏感信息核对。未执行生产部署或产品行为变更。父工单清单仍保留未勾选，等待用户验收并关闭对应单元任务后再同步完成状态。
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/cmautobuy#310