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

切换 Agent、工单与设计证据工作流 #315

New Issue
Open
opened 2026-08-26 16:26:21 +08:00 by ila · 2 comments
ila commented 2026-08-26 16:26:21 +08:00
Owner
Copy Link
Copy Source

基本信息

  • 类型：需求
  • 父级大工单：#310
  • 所属 MVP / 版本：#311
  • 阶段：阶段 4：工作流切换
  • 原始需求来源：用户在 2026-08-26 要求参考更新后的 D:\OPC\dev_harness 更新本项目文档和工作流
  • 前置工单：#314
  • 是否允许并行：否。只有 Wiki 主源稳定后才能取消强制本地任务归档。
  • 状态：待验收

要解决什么

根 AGENTS.md、CLAUDE.md 和工单模板仍使用旧的本地文档主源与每单强制归档规则，缺少 MCP 优先、最小读取、设计证据、快捷指令和依赖并行边界。

做什么 / 不做什么

  • 做：增量更新共同规则、Claude 入口、Gitea 工单模板和兼容归档模板，采用目标 DevHarness 的任务事实来源、快捷指令、设计门禁、依赖并行、效率与停止条件。
  • 不做：不削弱五条红线、Client 不可逆门禁、Admin 真实采购规则、子项目技术栈和接口契约；不删除历史 docs/task。

怎么做

根规则保留项目专用红线和多子项目边界；通用流程按目标基线改写。仓库 README 同步提供 Wiki 初始化门禁；旧 docs/templates/task.md 保留为不重复模板正文的兼容入口，Harness 将它登记为唯一允许的本地说明页。默认任务完成证据写入工单评论，只有用户明确要求才创建/导出任务快照。纯显示文案豁免严格采用参考条件。

预计修改：AGENTS.md、CLAUDE.md、README.md、.gitea/issue_template/{epic,mvp,task}.md、docs/templates/task.md、dev_scripts/harness.py、tests/test_harness_docs.py、Development-Workflow Wiki/镜像

设计证据：非 UI 工作；以 DevHarness 目标提交、事实来源迁移顺序和本工单技术方案作为设计证据。
长期文档影响：有，具体页面和镜像见预计修改。

验收标准

  • 五条红线逐字语义不弱化
  • Gitea MCP 优先和最小读取规则明确
  • 设计证据与线上原型按需导出规则明确
  • 快捷指令和停止位置完整
  • 新模板包含来源、依赖/并行、设计证据和长期文档影响
  • 默认不再创建任务归档且历史快照保留
  • 子项目规则和 Client 契约优先级不变

怎么验证

规则关键字检查；模板结构检查；python dev_scripts/harness.py check --strict；人工 diff 对照

风险和回退

这是事实来源和任务完成方式切换；回退恢复旧规则即可，Wiki 和历史快照不删除。

## 基本信息 - 类型：需求 - 父级大工单：#310 - 所属 MVP / 版本：#311 - 阶段：阶段 4：工作流切换 - 原始需求来源：用户在 2026-08-26 要求参考更新后的 `D:\OPC\dev_harness` 更新本项目文档和工作流 - 前置工单：#314 - 是否允许并行：否。只有 Wiki 主源稳定后才能取消强制本地任务归档。 - 状态：待验收 ## 要解决什么 根 `AGENTS.md`、`CLAUDE.md` 和工单模板仍使用旧的本地文档主源与每单强制归档规则，缺少 MCP 优先、最小读取、设计证据、快捷指令和依赖并行边界。 ## 做什么 / 不做什么 - 做：增量更新共同规则、Claude 入口、Gitea 工单模板和兼容归档模板，采用目标 DevHarness 的任务事实来源、快捷指令、设计门禁、依赖并行、效率与停止条件。 - 不做：不削弱五条红线、Client 不可逆门禁、Admin 真实采购规则、子项目技术栈和接口契约；不删除历史 `docs/task`。 ## 怎么做 根规则保留项目专用红线和多子项目边界；通用流程按目标基线改写。仓库 README 同步提供 Wiki 初始化门禁；旧 `docs/templates/task.md` 保留为不重复模板正文的兼容入口，Harness 将它登记为唯一允许的本地说明页。默认任务完成证据写入工单评论，只有用户明确要求才创建/导出任务快照。纯显示文案豁免严格采用参考条件。 预计修改：`AGENTS.md`、`CLAUDE.md`、`README.md`、`.gitea/issue_template/{epic,mvp,task}.md`、`docs/templates/task.md`、`dev_scripts/harness.py`、`tests/test_harness_docs.py`、Development-Workflow Wiki/镜像 设计证据：非 UI 工作；以 DevHarness 目标提交、事实来源迁移顺序和本工单技术方案作为设计证据。 长期文档影响：有，具体页面和镜像见预计修改。 ## 验收标准 - [ ] 五条红线逐字语义不弱化 - [ ] Gitea MCP 优先和最小读取规则明确 - [ ] 设计证据与线上原型按需导出规则明确 - [ ] 快捷指令和停止位置完整 - [ ] 新模板包含来源、依赖/并行、设计证据和长期文档影响 - [ ] 默认不再创建任务归档且历史快照保留 - [ ] 子项目规则和 Client 契约优先级不变 ## 怎么验证 规则关键字检查；模板结构检查；`python dev_scripts/harness.py check --strict`；人工 diff 对照 ## 风险和回退 这是事实来源和任务完成方式切换；回退恢复旧规则即可，Wiki 和历史快照不删除。
ila commented 2026-08-26 17:04:59 +08:00
Author
Owner
Copy Link
Copy Source

实施结果

  • 工作流切换提交：c63fee1
  • 模板格式修正：86b0eca
  • Development-Workflow revision：3c5c91353b36ed45008df6e4e7dd8a23f3d7e105
  • 验证：Harness/规则/模板测试 42 项通过；python dev_scripts/harness.py check --strict 通过。
  • 红线：五条产品红线、Client 不可逆门禁、Admin 真实采购（不支付）、PyQt5 和共享契约均保留。
  • 归档：按本任务正式启用的新规则，默认不创建任务快照；#312～#314 的旧流程归档保留。

状态：待验收。

## 实施结果 - 工作流切换提交：`c63fee1` - 模板格式修正：`86b0eca` - Development-Workflow revision：`3c5c91353b36ed45008df6e4e7dd8a23f3d7e105` - 验证：Harness/规则/模板测试 42 项通过；`python dev_scripts/harness.py check --strict` 通过。 - 红线：五条产品红线、Client 不可逆门禁、Admin 真实采购（不支付）、PyQt5 和共享契约均保留。 - 归档：按本任务正式启用的新规则，默认不创建任务快照；#312～#314 的旧流程归档保留。 状态：待验收。
ila commented 2026-08-26 17:11:42 +08:00
Author
Owner
Copy Link
Copy Source

补充修正文档路径提交：b7f258b（admin/deploy/）。

补充修正文档路径提交：`b7f258b`（`admin/deploy/`）。
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#315