From 6aaebc3bc663c235505570784089125c58c5531f Mon Sep 17 00:00:00 2001 From: QiuSW <105186638@qq.com> Date: Wed, 12 Aug 2026 08:37:50 +0800 Subject: [PATCH] docs: archive task #1 acceptance --- ...项目并行建单与协同工单顺序.md | 82 +++++++++++++++++ wiki-docs.json | 89 +++++++++++++++---- 2 files changed, 154 insertions(+), 17 deletions(-) create mode 100644 docs/task/1-三项目并行建单与协同工单顺序.md diff --git a/docs/task/1-三项目并行建单与协同工单顺序.md b/docs/task/1-三项目并行建单与协同工单顺序.md new file mode 100644 index 0000000..b9f4572 --- /dev/null +++ b/docs/task/1-三项目并行建单与协同工单顺序.md @@ -0,0 +1,82 @@ + +generated: true (请先修改 Gitea Wiki，禁止直接编辑本文件) +wiki_page: Task-1-三项目并行建单与协同工单顺序 +wiki_url: https://git.ilapage.cn/ila/yovision/wiki/Task-1-%E4%B8%89%E9%A1%B9%E7%9B%AE%E5%B9%B6%E8%A1%8C%E5%BB%BA%E5%8D%95%E4%B8%8E%E5%8D%8F%E5%90%8C%E5%B7%A5%E5%8D%95%E9%A1%BA%E5%BA%8F.- +wiki_revision: 8feb5cc67b3ebd30371250d4ffbd94d00176d347 +synchronized_at: 2026-08-12T00:37:09Z + + +# 1 三项目并行建单与协同工单顺序 + +- 类型：需求 +- 所属 Epic：无 +- 所属 MVP / 版本：流程初始化 +- 状态：已完成 +- 日期：2026-08-12 +- 验收日期：2026-08-12 +- 验收结果：用户明确验收通过 +- Gitea 工单：https://git.ilapage.cn/ila/yovision/issues/1 +- Pull Request：https://git.ilapage.cn/ila/yovision/pulls/2 +- Wiki 页面：Task-1-三项目并行建单与协同工单顺序 +- Wiki revision：见本地镜像头 + +## 背景与目标 + +客户交期紧，需要 Sense、Brain、Bell 三个项目尽量并行建立和实施独立工单。原规则已经限制各项目默认写路径，但没有固定“先三端独立建单、主 agent 汇总、再建协同工单”的顺序，任务模板也缺少主 agent、精确写路径和生产者/消费者等字段。 + +本任务把该协作方式固化为仓库规则、Claude 路由、子项目规则、工单模板和 Wiki 长期文档，并增加自动化门禁防止后续回退。 + +## 最终方案 + +1. Sense、Brain、Bell 三个项目 agent 首轮并行只读分析并创建各自独立功能工单，每个工单只有一个主项目、一个主 agent 和不重叠的 `write_paths`。 +2. 三个项目 agent 只提交协同需求摘要，不在首轮取得 `contracts/`、根级共享文件或其他项目目录的写入权。 +3. 三端工单返回后，由主 agent / dispatcher 汇总、去重，检查依赖、写路径、事实源和验收闭环。 +4. 汇总完成后再创建契约、根级编排、机器鉴权和端到端验收等协同工单，并指定单一 coordination agent。 +5. 明确建单顺序不等于实施顺序；独立骨架可以先并行，依赖契约的实现必须等待契约版本冻结。 +6. `CLAUDE.md` 只保存 Claude 专用角色路由，共享流程仍以根 `AGENTS.md` 为事实来源。 +7. 任务模板增加任务类型、主项目、主 agent、`write_paths`、生产者、消费者、契约事实源、兼容策略、适配工单和集成顺序。 +8. Harness 严格检查上述关键字段与规则，并新增回归测试。 + +与建单方案无差异；额外增加 Harness 对 Claude 三项目角色路由的检查，以确保规则不会静默丢失。 + +## 修改文件 + +- `AGENTS.md`：固定三项目并行建单和协同工单顺序。 +- `CLAUDE.md`：增加 Sense、Brain、Bell 与 coordination agent 路由。 +- `Sense/AGENTS.md`：定义 Sense 独立建单范围与协同升级条件。 +- `Brain/AGENTS.md`：定义 Brain 独立建单范围与协同升级条件。 +- `Bell/AGENTS.md`：定义 Bell 独立建单范围与协同升级条件。 +- `.gitea/issue_template/task.md`：增加单项目/协同任务必填字段。 +- `dev_scripts/check_harness.py`：增加协作规则和模板字段门禁。 +- `tests/test_harness_docs.py`：增加协同字段回归测试。 +- `docs/11-multi-agent-collaboration.md`：Wiki 长期文档镜像。 + +## 验收结果 + +| 验收标准 | 结果 | +|---|---| +| 根规则明确建单顺序、dispatcher 汇总责任和实施依赖原则 | 通过 | +| Claude 入口明确三项目角色与 coordination agent 触发条件 | 通过 | +| 三个子项目规则明确建单范围、写路径和协同升级条件 | 通过 | +| 工单模板包含主 agent、写路径、生产者、消费者和兼容字段 | 通过 | +| Wiki-first 更新并保持镜像一致 | 通过 | +| 用户明确验收 | 通过（2026-08-12） | + +## 测试 + +- 执行命令：`python dev_scripts/check_harness.py --strict` +- 结果：通过。 +- 执行命令：`python -m unittest discover -s tests -v` +- 结果：25 项测试全部通过。 +- 执行命令：`python -m compileall -q dev_scripts tests` +- 结果：通过。 +- 执行命令：`python dev_scripts/sync_wiki_docs.py --check` +- 结果：17 个 Wiki 映射全部一致。 +- 执行命令：`git diff --check` +- 结果：通过。 +- **未验证部分**：尚未用三个真实产品开发 agent 完整演练首轮并行建单与后续协同建单；该演练属于下一阶段产品规划工作，不影响本次规则和模板验收。 + +## 相关提交 + +- `579b2ec` docs: define three-project issue planning order (#1) +- `d5d0c04` Merge pull request 'docs: 规范三项目并行建单与协同工单顺序 (#1)' (#2) diff --git a/wiki-docs.json b/wiki-docs.json index f350e30..ac296de 100644 --- a/wiki-docs.json +++ b/wiki-docs.json @@ -4,22 +4,77 @@ "owner": "ila", "repository": "yovision", "mappings": [ - { "page": "Home", "path": "docs/README.md" }, - { "page": "Project-Profile", "path": "docs/00-project-profile.md" }, - { "page": "Development-Workflow", "path": "docs/01-workflow.md" }, - { "page": "Architecture-and-Code-Map", "path": "docs/02-architecture-and-code-map.md" }, - { "page": "Business-Rules-and-Glossary", "path": "docs/03-business-rules-and-glossary.md" }, - { "page": "Local-Development-and-Verification", "path": "docs/04-local-development-and-verification.md" }, - { "page": "Common-Changes", "path": "docs/05-common-changes.md" }, - { "page": "Troubleshooting", "path": "docs/06-troubleshooting.md" }, - { "page": "New-Project-Documentation-Setup", "path": "docs/07-new-project-documentation-setup.md" }, - { "page": "Existing-Project-Adoption-Guide", "path": "docs/08-existing-project-adoption.md" }, - { "page": "Product-Requirements", "path": "docs/09-product-requirements.md" }, - { "page": "Requirements-Migration-Matrix", "path": "docs/10-requirements-migration-matrix.md" }, - { "page": "Multi-Agent-Collaboration", "path": "docs/11-multi-agent-collaboration.md" }, - { "page": "Product-Roadmap", "path": "docs/12-product-roadmap.md" }, - { "page": "Delivery-Documentation-Guide", "path": "docs/delivery/README.md" }, - { "page": "Audience-Document-Template", "path": "docs/delivery/audience-document-template.md" }, - { "page": "Task-Archive-Template", "path": "docs/templates/task-archive.md" } + { + "page": "Home", + "path": "docs/README.md" + }, + { + "page": "Project-Profile", + "path": "docs/00-project-profile.md" + }, + { + "page": "Development-Workflow", + "path": "docs/01-workflow.md" + }, + { + "page": "Architecture-and-Code-Map", + "path": "docs/02-architecture-and-code-map.md" + }, + { + "page": "Business-Rules-and-Glossary", + "path": "docs/03-business-rules-and-glossary.md" + }, + { + "page": "Local-Development-and-Verification", + "path": "docs/04-local-development-and-verification.md" + }, + { + "page": "Common-Changes", + "path": "docs/05-common-changes.md" + }, + { + "page": "Troubleshooting", + "path": "docs/06-troubleshooting.md" + }, + { + "page": "New-Project-Documentation-Setup", + "path": "docs/07-new-project-documentation-setup.md" + }, + { + "page": "Existing-Project-Adoption-Guide", + "path": "docs/08-existing-project-adoption.md" + }, + { + "page": "Product-Requirements", + "path": "docs/09-product-requirements.md" + }, + { + "page": "Requirements-Migration-Matrix", + "path": "docs/10-requirements-migration-matrix.md" + }, + { + "page": "Multi-Agent-Collaboration", + "path": "docs/11-multi-agent-collaboration.md" + }, + { + "page": "Product-Roadmap", + "path": "docs/12-product-roadmap.md" + }, + { + "page": "Delivery-Documentation-Guide", + "path": "docs/delivery/README.md" + }, + { + "page": "Audience-Document-Template", + "path": "docs/delivery/audience-document-template.md" + }, + { + "page": "Task-Archive-Template", + "path": "docs/templates/task-archive.md" + }, + { + "page": "Task-1-三项目并行建单与协同工单顺序", + "path": "docs/task/1-三项目并行建单与协同工单顺序.md" + } ] }