规范三项目并行建单与协同工单顺序 #1

Closed
opened 2026-08-11 18:57:34 +08:00 by ila · 2 comments
Owner

基本信息

  • 类型:需求
  • 所属 Epic:无
  • 所属 MVP / 版本:流程初始化
  • 阶段:仓库与契约基线

依赖与并行

  • 前置工单:无
  • 是否允许与前置工单并行:否
  • 原因:先冻结协作规则,后续三个项目才能按一致方式建立产品工单。

子项目影响

  • 仅影响的子项目 / 交付单元:根协作规则、Sense/Brain/Bell 目录规则、工单模板
  • 是否跨子项目:是
  • 是否修改共享接口或契约:否;唯一事实来源:不适用
  • 各子项目需要执行的验证:检查各目录 AGENTS 规则、Harness 严格检查与文档测试

原始需求

  • 来源:用户对话
  • 提出时间:2026-08-11
  • 脱敏摘要:客户交期紧,先由三个 agent 并行建立 Sense、Brain、Bell 独立功能工单,再由主 agent 汇总并建立需要协同的工单;按建议更新规则文档。

要解决什么

现有规则限制了默认写路径,但没有固定独立建单、汇总去重、协同建单的顺序,工单模板也缺少任务类型、主 agent、生产者和消费者字段。

做什么 / 不做什么

  • 做:更新根 AGENTS、CLAUDE、三个子项目 AGENTS、工单模板和 Multi-Agent-Collaboration Wiki。
  • 不做:不创建产品功能工单,不启动三个产品开发 agent,不修改业务代码或共享契约。

已确认方案

  1. 三个项目 agent 先并行建立各自独立功能工单。
  2. 主 agent 汇总、去重、检查依赖和写路径。
  3. 再创建共享契约、根级配置和端到端协同工单。
  4. 明确建单顺序不等于实施顺序,实施按依赖推进。
  5. CLAUDE 只保存 Claude 专用角色路由,共享规则以 AGENTS 为准。

预计修改文件:AGENTS.md、CLAUDE.md、Sense/AGENTS.md、Brain/AGENTS.md、Bell/AGENTS.md、.gitea/issue_template/task.md、Multi-Agent-Collaboration Wiki 及 docs 镜像。

验收标准

  • 根规则明确建单顺序、主 agent 汇总责任和实施依赖原则。
  • CLAUDE 明确三项目角色启动与协调 agent 触发条件,不复制公共规则全文。
  • 三个子项目 AGENTS 明确各自建单范围、默认写路径和协同升级条件。
  • 工单模板包含任务类型、主项目、主 agent、写路径、生产者、消费者和跨端验证。
  • Wiki 镜像一致,Harness 严格检查和测试通过。

验证方式

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

风险和回退

风险是规则重复或职责冲突。公共流程只写根 AGENTS,CLAUDE 和子目录只写平台/目录专用补充;回退本工单提交即可。

## 基本信息 - 类型:需求 - 所属 Epic:无 - 所属 MVP / 版本:流程初始化 - 阶段:仓库与契约基线 ## 依赖与并行 - 前置工单:无 - 是否允许与前置工单并行:否 - 原因:先冻结协作规则,后续三个项目才能按一致方式建立产品工单。 ## 子项目影响 - 仅影响的子项目 / 交付单元:根协作规则、Sense/Brain/Bell 目录规则、工单模板 - 是否跨子项目:是 - 是否修改共享接口或契约:否;唯一事实来源:不适用 - 各子项目需要执行的验证:检查各目录 AGENTS 规则、Harness 严格检查与文档测试 ## 原始需求 - 来源:用户对话 - 提出时间:2026-08-11 - 脱敏摘要:客户交期紧,先由三个 agent 并行建立 Sense、Brain、Bell 独立功能工单,再由主 agent 汇总并建立需要协同的工单;按建议更新规则文档。 ## 要解决什么 现有规则限制了默认写路径,但没有固定独立建单、汇总去重、协同建单的顺序,工单模板也缺少任务类型、主 agent、生产者和消费者字段。 ## 做什么 / 不做什么 - 做:更新根 AGENTS、CLAUDE、三个子项目 AGENTS、工单模板和 Multi-Agent-Collaboration Wiki。 - 不做:不创建产品功能工单,不启动三个产品开发 agent,不修改业务代码或共享契约。 ## 已确认方案 1. 三个项目 agent 先并行建立各自独立功能工单。 2. 主 agent 汇总、去重、检查依赖和写路径。 3. 再创建共享契约、根级配置和端到端协同工单。 4. 明确建单顺序不等于实施顺序,实施按依赖推进。 5. CLAUDE 只保存 Claude 专用角色路由,共享规则以 AGENTS 为准。 预计修改文件:AGENTS.md、CLAUDE.md、Sense/AGENTS.md、Brain/AGENTS.md、Bell/AGENTS.md、.gitea/issue_template/task.md、Multi-Agent-Collaboration Wiki 及 docs 镜像。 ## 验收标准 - [ ] 根规则明确建单顺序、主 agent 汇总责任和实施依赖原则。 - [ ] CLAUDE 明确三项目角色启动与协调 agent 触发条件,不复制公共规则全文。 - [ ] 三个子项目 AGENTS 明确各自建单范围、默认写路径和协同升级条件。 - [ ] 工单模板包含任务类型、主项目、主 agent、写路径、生产者、消费者和跨端验证。 - [ ] Wiki 镜像一致,Harness 严格检查和测试通过。 ## 验证方式 ```powershell 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 ``` ## 风险和回退 风险是规则重复或职责冲突。公共流程只写根 AGENTS,CLAUDE 和子目录只写平台/目录专用补充;回退本工单提交即可。
Author
Owner

状态:待验收

已完成:

  • 根 AGENTS、CLAUDE、Sense/Brain/Bell 目录规则和任务模板已更新;
  • Harness 增加协同字段与 Claude 路由门禁;
  • Multi-Agent-Collaboration Wiki 已更新,revision cc4031224ddd5855250a2441edd53d54baf73b5a;
  • 提交:579b2ec;
  • PR:#2。

验证:Harness 严格检查通过;25 项测试通过;17 个 Wiki 映射一致;git diff --check 通过。

未验证部分:尚未实际运行三 agent 建单演练,本工单只冻结规则和模板。

状态:待验收 已完成: - 根 AGENTS、CLAUDE、Sense/Brain/Bell 目录规则和任务模板已更新; - Harness 增加协同字段与 Claude 路由门禁; - Multi-Agent-Collaboration Wiki 已更新,revision `cc4031224ddd5855250a2441edd53d54baf73b5a`; - 提交:`579b2ec`; - PR:https://git.ilapage.cn/ila/yovision/pulls/2。 验证:Harness 严格检查通过;25 项测试通过;17 个 Wiki 映射一致;`git diff --check` 通过。 未验证部分:尚未实际运行三 agent 建单演练,本工单只冻结规则和模板。
Author
Owner

验收关单

用户已于 2026-08-12 明确确认“#1 验收通过”。

  • PR #2 已合并,merge commit:d5d0c04ba138e9c2fcb4d3313b5ed6a0c788f202
  • 验收归档提交:6aaebc3
  • Wiki 归档页:Task-1-三项目并行建单与协同工单顺序
  • Wiki revision:8feb5cc67b3ebd30371250d4ffbd94d00176d347
  • 本地镜像:docs/task/1-三项目并行建单与协同工单顺序.md
  • python dev_scripts/check_harness.py --strict:通过
  • python -m unittest discover -s tests -v:25 项通过
  • python dev_scripts/sync_wiki_docs.py --check:通过
  • git diff --check:通过

按验收结果关闭本工单。

## 验收关单 用户已于 2026-08-12 明确确认“#1 验收通过”。 - PR #2 已合并,merge commit:`d5d0c04ba138e9c2fcb4d3313b5ed6a0c788f202` - 验收归档提交:`6aaebc3` - Wiki 归档页:`Task-1-三项目并行建单与协同工单顺序` - Wiki revision:`8feb5cc67b3ebd30371250d4ffbd94d00176d347` - 本地镜像:`docs/task/1-三项目并行建单与协同工单顺序.md` - `python dev_scripts/check_harness.py --strict`:通过 - `python -m unittest discover -s tests -v`:25 项通过 - `python dev_scripts/sync_wiki_docs.py --check`:通过 - `git diff --check`:通过 按验收结果关闭本工单。
ila closed this issue 2026-08-12 08:38:22 +08:00
Sign in to join this conversation.
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: ila/yovision#1