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

chore: 升级 DevHarness 工作流基线至 0b6ec76 #70

New Issue
Closed
opened 2026-08-26 20:31:01 +08:00 by ila · 3 comments
ila commented 2026-08-26 20:31:01 +08:00
Owner
Copy Link
Copy Source

基本信息

  • 类型：维护 / 开发流程升级
  • 所属 Epic：#3
  • 所属 MVP / 版本：项目工程基线（不改变产品 MVP 范围）
  • 阶段：已完成

依赖与并行

  • 前置工单：无
  • 是否允许与 #66 并行：是
  • 原因：只修改 DevHarness 规则、模板、工具、测试和长期开发文档，不修改业务代码、数据库或运行配置。

子项目影响

  • 仅影响的子项目 / 交付单元：仓库级 DevHarness
  • 是否跨子项目：否
  • 是否修改共享接口或契约：修改开发工作流契约；事实来源为本工单、根 AGENTS.md 与 Development-Workflow Wiki
  • 各子项目需要执行的验证：不需要产品端构建；执行 Harness 严格检查、Harness 单元测试和 Wiki 镜像检查

原始需求

  • 来源：用户对话
  • 提出时间：2026-08-26
  • 关键原话或脱敏摘要：项目工作流程和文档参考本机 D:\OPC\dev_harness；来源项目更新后，要求 Chorus 参考最新版本更新文档和工作流。

要解决什么

Chorus 项目档案记录的 DevHarness 基线仍为 3696663781c569c57f47bb26e3b5b6369180fdaa。来源仓库当前已前进到 0b6ec7675dfc2d930a30527eddac83f4302d0879，新增了单次任务事实来源简化、Gitea MCP 与工单最小读取、线上原型审核与按需导出等规则；Chorus 只吸收了其中一部分，规则、工单模板、Harness 校验和核心 Wiki 存在不一致。

做什么 / 不做什么

  • 做：增量合并旧基线到目标基线的通用 DevHarness 变化；更新项目档案基线；更新 Chorus 长期 Wiki 并同步核心镜像；适配 Harness 工具和自动测试。
  • 做：保留 Chorus 的项目专用红线、单人开发低风险直接提交边界、项目事实、命令和目录。
  • 不做：不复制 DevHarness 工单、任务归档、Wiki URL 或模板项目事实。
  • 不做：不删除或重命名既有 Wiki、docs/task/、prototypes/；不修改业务代码、接口、数据库、权限或运行配置。

已确认方案

目标基线：0b6ec7675dfc2d930a30527eddac83f4302d0879。

  • 直接采用 Gitea MCP 优先与工单最小读取规则。
  • 单次任务确认基线保存在工单正文，重要变化、最终证据和验收结论以评论追加；默认不创建任务归档。
  • 原型默认使用可访问且版本明确的线上设计审核；本地 HTML 仅在 导出原型 #N、导出全部原型 或项目专用规则明确要求时生成。
  • 更新单元工单模板、Harness 校验字符串和测试。
  • Wiki-first 页面先更新 Chorus Wiki、回读 revision，再同步本地 docs/。
  • 保留 Chorus 已确认的低风险直接提交豁免及全部安全红线，不整文件覆盖。

预计修改文件：

  • AGENTS.md
  • README.md
  • .gitea/issue_template/task.md
  • dev_scripts/harness.py
  • tests/test_harness_docs.py
  • 由 Wiki 同步产生的相关 docs/*.md 核心镜像

需求变化记录

日期 变化内容 原因 用户确认
2026-08-26 从基线 3696663 升级到 0b6ec76，按 Chorus 增量适配 DevHarness 来源仓库更新 是

设计与原型门禁

  • 修改类型：非 UI
  • 所需设计证据：开发流程和文档架构设计
  • 可编辑设计源、线上原型链接和访问检查：D:\OPC\dev_harness Git 提交 0b6ec7675dfc2d930a30527eddac83f4302d0879
  • 审核版本、revision、复制版本或确认日期及识别方式：完整 Git 提交；2026-08-26 用户确认
  • 本地 HTML 导出：未要求
  • 状态：已确认
  • 确认人、确认时间和覆盖范围：用户，2026-08-26；覆盖规则、模板、Harness 工具、测试和长期开发文档
  • 无需 UI 原型或无需任何原型的原因：不改变产品界面

文档影响

  • 更新项目档案
  • 更新开发工作流
  • 更新需求与原型索引及相关通用规则页面
  • 更新 Home/README 中的事实来源和目录说明
  • 不影响产品架构、业务状态机、API、数据库和部署行为

交付文档影响

  • 无面向产品用户的交付文档影响，原因：仅改变项目开发治理流程。

任务记录与可选快照

  • 单次任务事实来源：当前 Gitea 工单正文与评论
  • 默认不创建任务快照
  • 用户明确要求专项快照
  • 项目专用规则要求任务快照

验收标准

  • Chorus 项目档案记录目标完整基线和升级日期。
  • 新增 Gitea MCP 最小读取、线上原型审核和按需导出规则，且保留 Chorus 专用规则。
  • 单元工单模板、Harness 校验与测试保持一致。
  • 相关长期 Wiki 在线更新、回读成功，本地核心镜像一致。
  • python dev_scripts/harness.py check --strict 与 Harness 单元测试通过。
  • 提交不包含 DevHarness 项目事实、历史归档、凭据或现有本机配置改动。

验证方式

  • python dev_scripts/harness.py check --strict
  • python -m unittest discover -s tests -v
  • python dev_scripts/harness.py sync --check
  • git diff --check

风险和回退

  • 风险：机械覆盖会丢失 Chorus 红线，或让 Wiki、模板和 Harness 校验互相矛盾。
  • 控制：按旧基线到目标基线逐项移植；项目专用规则和产品事实优先保留；Wiki 在线回读。
  • 回退：恢复本任务单一提交，并把 Project-Profile 基线保留为旧提交；不触碰业务数据。
## 基本信息 - 类型：维护 / 开发流程升级 - 所属 Epic：#3 - 所属 MVP / 版本：项目工程基线（不改变产品 MVP 范围） - 阶段：已完成 ## 依赖与并行 - 前置工单：无 - 是否允许与 #66 并行：是 - 原因：只修改 DevHarness 规则、模板、工具、测试和长期开发文档，不修改业务代码、数据库或运行配置。 ## 子项目影响 - 仅影响的子项目 / 交付单元：仓库级 DevHarness - 是否跨子项目：否 - 是否修改共享接口或契约：修改开发工作流契约；事实来源为本工单、根 `AGENTS.md` 与 Development-Workflow Wiki - 各子项目需要执行的验证：不需要产品端构建；执行 Harness 严格检查、Harness 单元测试和 Wiki 镜像检查 ## 原始需求 - 来源：用户对话 - 提出时间：2026-08-26 - 关键原话或脱敏摘要：项目工作流程和文档参考本机 `D:\OPC\dev_harness`；来源项目更新后，要求 Chorus 参考最新版本更新文档和工作流。 ## 要解决什么 Chorus 项目档案记录的 DevHarness 基线仍为 `3696663781c569c57f47bb26e3b5b6369180fdaa`。来源仓库当前已前进到 `0b6ec7675dfc2d930a30527eddac83f4302d0879`，新增了单次任务事实来源简化、Gitea MCP 与工单最小读取、线上原型审核与按需导出等规则；Chorus 只吸收了其中一部分，规则、工单模板、Harness 校验和核心 Wiki 存在不一致。 ## 做什么 / 不做什么 - 做：增量合并旧基线到目标基线的通用 DevHarness 变化；更新项目档案基线；更新 Chorus 长期 Wiki 并同步核心镜像；适配 Harness 工具和自动测试。 - 做：保留 Chorus 的项目专用红线、单人开发低风险直接提交边界、项目事实、命令和目录。 - 不做：不复制 DevHarness 工单、任务归档、Wiki URL 或模板项目事实。 - 不做：不删除或重命名既有 Wiki、`docs/task/`、`prototypes/`；不修改业务代码、接口、数据库、权限或运行配置。 ## 已确认方案 目标基线：`0b6ec7675dfc2d930a30527eddac83f4302d0879`。 - 直接采用 Gitea MCP 优先与工单最小读取规则。 - 单次任务确认基线保存在工单正文，重要变化、最终证据和验收结论以评论追加；默认不创建任务归档。 - 原型默认使用可访问且版本明确的线上设计审核；本地 HTML 仅在 `导出原型 #N`、`导出全部原型` 或项目专用规则明确要求时生成。 - 更新单元工单模板、Harness 校验字符串和测试。 - Wiki-first 页面先更新 Chorus Wiki、回读 revision，再同步本地 `docs/`。 - 保留 Chorus 已确认的低风险直接提交豁免及全部安全红线，不整文件覆盖。 预计修改文件： - `AGENTS.md` - `README.md` - `.gitea/issue_template/task.md` - `dev_scripts/harness.py` - `tests/test_harness_docs.py` - 由 Wiki 同步产生的相关 `docs/*.md` 核心镜像 ## 需求变化记录 | 日期 | 变化内容 | 原因 | 用户确认 | |---|---|---|---| | 2026-08-26 | 从基线 `3696663` 升级到 `0b6ec76`，按 Chorus 增量适配 | DevHarness 来源仓库更新 | 是 | ## 设计与原型门禁 - 修改类型：非 UI - 所需设计证据：开发流程和文档架构设计 - 可编辑设计源、线上原型链接和访问检查：`D:\OPC\dev_harness` Git 提交 `0b6ec7675dfc2d930a30527eddac83f4302d0879` - 审核版本、revision、复制版本或确认日期及识别方式：完整 Git 提交；2026-08-26 用户确认 - 本地 HTML 导出：未要求 - 状态：已确认 - 确认人、确认时间和覆盖范围：用户，2026-08-26；覆盖规则、模板、Harness 工具、测试和长期开发文档 - 无需 UI 原型或无需任何原型的原因：不改变产品界面 ## 文档影响 - [x] 更新项目档案 - [x] 更新开发工作流 - [x] 更新需求与原型索引及相关通用规则页面 - [x] 更新 Home/README 中的事实来源和目录说明 - [ ] 不影响产品架构、业务状态机、API、数据库和部署行为 ## 交付文档影响 - [x] 无面向产品用户的交付文档影响，原因：仅改变项目开发治理流程。 ## 任务记录与可选快照 - 单次任务事实来源：当前 Gitea 工单正文与评论 - [x] 默认不创建任务快照 - [ ] 用户明确要求专项快照 - [ ] 项目专用规则要求任务快照 ## 验收标准 - [ ] Chorus 项目档案记录目标完整基线和升级日期。 - [ ] 新增 Gitea MCP 最小读取、线上原型审核和按需导出规则，且保留 Chorus 专用规则。 - [ ] 单元工单模板、Harness 校验与测试保持一致。 - [ ] 相关长期 Wiki 在线更新、回读成功，本地核心镜像一致。 - [ ] `python dev_scripts/harness.py check --strict` 与 Harness 单元测试通过。 - [ ] 提交不包含 DevHarness 项目事实、历史归档、凭据或现有本机配置改动。 ## 验证方式 - `python dev_scripts/harness.py check --strict` - `python -m unittest discover -s tests -v` - `python dev_scripts/harness.py sync --check` - `git diff --check` ## 风险和回退 - 风险：机械覆盖会丢失 Chorus 红线，或让 Wiki、模板和 Harness 校验互相矛盾。 - 控制：按旧基线到目标基线逐项移植；项目专用规则和产品事实优先保留；Wiki 在线回读。 - 回退：恢复本任务单一提交，并把 Project-Profile 基线保留为旧提交；不触碰业务数据。
ila commented 2026-08-26 20:31:22 +08:00
Author
Owner
Copy Link
Copy Source

开始实施 #70。目标基线为 0b6ec7675dfc2d930a30527eddac83f4302d0879；按增量合并执行，保留 Chorus 全部项目专用红线、低风险直接提交边界和任务外工作区改动。长期文档只修改 Chorus Wiki，不使用 DevHarness 本地镜像覆盖。

开始实施 #70。目标基线为 `0b6ec7675dfc2d930a30527eddac83f4302d0879`；按增量合并执行，保留 Chorus 全部项目专用红线、低风险直接提交边界和任务外工作区改动。长期文档只修改 Chorus Wiki，不使用 DevHarness 本地镜像覆盖。
ila commented 2026-08-26 20:45:25 +08:00
Author
Owner
Copy Link
Copy Source

#70 已完成实现，现为待验收。

最终差异：

  • DevHarness 基线从 3696663781c569c57f47bb26e3b5b6369180fdaa 升级到 0b6ec7675dfc2d930a30527eddac83f4302d0879。
  • 新增 Gitea MCP 优先与工单最小读取规则；工单正文保存确认基线，重要变化、最终证据和验收结论通过评论追加。
  • 默认不创建任务归档；新增 导出原型 #N 和 导出全部原型，本地 HTML 改为显式按需导出。
  • 更新单元工单模板、Harness 校验和自动测试。
  • 保留 Chorus 的低风险直接提交适配和全部 12 条项目专用红线。
  • 未复制 DevHarness 项目事实、Wiki URL、工单或任务归档；未修改产品代码、数据库或运行配置。

长期 Wiki：

  • Home：07c26be93a044570206347fefe1f9a491c6a426a
  • Project-Profile：9966ce2c233336465514115adf51545dda55efb3
  • Development-Workflow：ede04012373c53ea3bee8a00ebd27ef8075bdbc4
  • New-Project-Documentation-Setup：404f507af12c9bd21272cd6446f9608a3a06a241
  • Product-Requirements-Overview：6c7e3b2aee8c0f675013cf60020243cadb566e77

验证：

  • python dev_scripts/harness.py check --strict：通过。
  • python -m unittest discover -s tests -v：45 项通过。
  • python dev_scripts/harness.py sync --check：16 个核心镜像一致。
  • git diff --check：通过。
  • 未验证部分：没有产品运行行为变化，因此未运行 Go、前端或数据库测试。

提交：

  • fb8e787 chore: 升级 DevHarness 工作流基线 (#70)
  • 82537a1 docs: 保留 Chorus 低风险建单边界 (#70)

两个提交均已推送到 origin/main。按新流程未创建或导出任务归档。

#70 已完成实现，现为待验收。 最终差异： - DevHarness 基线从 `3696663781c569c57f47bb26e3b5b6369180fdaa` 升级到 `0b6ec7675dfc2d930a30527eddac83f4302d0879`。 - 新增 Gitea MCP 优先与工单最小读取规则；工单正文保存确认基线，重要变化、最终证据和验收结论通过评论追加。 - 默认不创建任务归档；新增 `导出原型 #N` 和 `导出全部原型`，本地 HTML 改为显式按需导出。 - 更新单元工单模板、Harness 校验和自动测试。 - 保留 Chorus 的低风险直接提交适配和全部 12 条项目专用红线。 - 未复制 DevHarness 项目事实、Wiki URL、工单或任务归档；未修改产品代码、数据库或运行配置。 长期 Wiki： - Home：`07c26be93a044570206347fefe1f9a491c6a426a` - Project-Profile：`9966ce2c233336465514115adf51545dda55efb3` - Development-Workflow：`ede04012373c53ea3bee8a00ebd27ef8075bdbc4` - New-Project-Documentation-Setup：`404f507af12c9bd21272cd6446f9608a3a06a241` - Product-Requirements-Overview：`6c7e3b2aee8c0f675013cf60020243cadb566e77` 验证： - `python dev_scripts/harness.py check --strict`：通过。 - `python -m unittest discover -s tests -v`：45 项通过。 - `python dev_scripts/harness.py sync --check`：16 个核心镜像一致。 - `git diff --check`：通过。 - 未验证部分：没有产品运行行为变化，因此未运行 Go、前端或数据库测试。 提交： - `fb8e787` chore: 升级 DevHarness 工作流基线 (#70) - `82537a1` docs: 保留 Chorus 低风险建单边界 (#70) 两个提交均已推送到 `origin/main`。按新流程未创建或导出任务归档。
ila commented 2026-08-26 21:50:19 +08:00
Author
Owner
Copy Link
Copy Source

用户于 2026-08-26 明确确认 #70 验收通过。实现、测试、提交和 Wiki revision 证据沿用上一条最终证据评论；没有新的长期事实变化，不重复同步 Wiki，也不创建或导出任务归档。

用户于 2026-08-26 明确确认 #70 验收通过。实现、测试、提交和 Wiki revision 证据沿用上一条最终证据评论；没有新的长期事实变化，不重复同步 Wiki，也不创建或导出任务归档。
ila closed this issue 2026-08-26 21:50:31 +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/chorus#70