docs: archive task #1 acceptance

2026-08-12 08:37:50 +08:00
parent d5d0c04ba1
commit 6aaebc3bc6
2 changed files with 154 additions and 17 deletions
@@ -0,0 +1,82 @@
+<!-- gitea-wiki-mirror:start -->
+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
+<!-- gitea-wiki-mirror:end -->
+
+# 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)
@@ -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"
+    }
  ]
 }