高级功能
这些功能支持协作式、大规模和并行的 SDD 工作流。它们建立在核心生命周期之上 — 在使用之前,请确保您已熟悉 SDD 工作流。
1. 规格分支
工具: branch_spec、merge_spec_branch
将规格分支视为 Git 分支 — 但用于您的计划。在做出决定之前,创建 A/B 变体来探索不同的实现方案。
适用场景:
- 具有多种有效方案的架构决策
- UI 实验(重新设计规格 A vs. 增量规格 B)
- 当利益相关者要求提供替代估算时
不适用场景
不要为微小的措辞更改或错别字修正创建规格分支。分支用于根本不同的实现策略 — 如果两种方案触及相同的文件,请先做出决定,然后再实现。
工作原理:
- 对现有规格进行分支以创建变体:
"将规格 SPEC-042 分支为 variant-B,采用微服务方案"
→ branch_spec(specId: "SPEC-042", branchName: "variant-b", description: "...")独立开发两个变体。每个分支都有自己的验收标准和 PLAN.md。
比较估算并选择优胜者,然后合并:
"将规格 SPEC-042 的 variant-b 分支合并"
→ merge_spec_branch(specId: "SPEC-042", branchName: "variant-b")Planu 在合并前检测变体之间的冲突,并标记相互矛盾的标准。
2. 规格联邦
工具: federate_specs、federation_status
在多个代码库之间共享和同步规格。对于单体仓库、微服务和平台团队至关重要。
适用场景:
- 平台团队拥有共享规格(认证、支付、日志记录)
- 具有共享需求的多服务单体仓库
- 前端和后端代码库之间共享的 API 契约规格
不适用场景
不要联邦与单个服务内部细节紧密耦合的规格。联邦用于共享契约 — 而不是在代码库之间复制实现细节。
工作原理:
- 在源代码库中,将规格发布到下游目标:
"将规格 SPEC-010 联邦到 team/payments-service"
→ federate_specs(...)在目标代码库中,规格以只读方式显示,并带有上游链接。下游团队可以引用但不能直接修改它。
更改自动同步或按需同步。随时检查同步状态:
"检查联邦状态"
→ federation_status()状态报告显示哪些规格相对于其上游源是超前、落后或冲突的。
3. 智能体团队编排
工具: plan_team_distribution、orchestrate_runtime、orchestrate_agents
将大型规格分配给多个并行 AI 智能体,每个智能体对特定文件拥有独占所有权。
适用场景:
- 涉及 5 个以上独立模块的规格
- 具有清晰文件边界的大型重构
- 可以并行化的时间敏感功能
不适用场景
不要编排小型规格(少于 3 个文件)。协调开销超过节省的时间。当模块紧密耦合时也应避免编排 — 智能体无法在运行中解决跨文件冲突。
工作原理:
- 规划分配 — Planu 分析规格并提出智能体分配方案:
"为 SPEC-099 规划团队分配"
→ plan_team_distribution(specId: "SPEC-099")
→ 返回:3 个智能体、文件分配、预估时间- 启动编排 — 智能体并行工作,每个智能体负责其分配的文件:
"使用 3 个智能体编排 SPEC-099"
→ orchestrate_runtime(specId: "SPEC-099", agentCount: 3)
→ 智能体并行工作,Planu 监控进度- 监控并完成:
"检查编排状态"
→ orchestrate_agents(action: "status")Planu 强制执行的规则:
- 每个智能体拥有独占文件 — 无并发编辑
- 所有智能体完成后运行集成测试
- 冲突被标记,而非自动解决