跳到正文

高级功能

这些功能支持协作式、大规模和并行的 SDD 工作流。它们建立在核心生命周期之上 — 在使用之前,请确保您已熟悉 SDD 工作流

1. 规格分支

工具: branch_specmerge_spec_branch

将规格分支视为 Git 分支 — 但用于您的计划。在做出决定之前,创建 A/B 变体来探索不同的实现方案。

适用场景:

  • 具有多种有效方案的架构决策
  • UI 实验(重新设计规格 A vs. 增量规格 B)
  • 当利益相关者要求提供替代估算时

不适用场景

不要为微小的措辞更改或错别字修正创建规格分支。分支用于根本不同的实现策略 — 如果两种方案触及相同的文件,请先做出决定,然后再实现。

工作原理:

  1. 对现有规格进行分支以创建变体:
"将规格 SPEC-042 分支为 variant-B,采用微服务方案"
→ branch_spec(specId: "SPEC-042", branchName: "variant-b", description: "...")
  1. 独立开发两个变体。每个分支都有自己的验收标准和 PLAN.md。

  2. 比较估算并选择优胜者,然后合并:

"将规格 SPEC-042 的 variant-b 分支合并"
→ merge_spec_branch(specId: "SPEC-042", branchName: "variant-b")

Planu 在合并前检测变体之间的冲突,并标记相互矛盾的标准。


2. 规格联邦

工具: federate_specsfederation_status

在多个代码库之间共享和同步规格。对于单体仓库、微服务和平台团队至关重要。

适用场景:

  • 平台团队拥有共享规格(认证、支付、日志记录)
  • 具有共享需求的多服务单体仓库
  • 前端和后端代码库之间共享的 API 契约规格

不适用场景

不要联邦与单个服务内部细节紧密耦合的规格。联邦用于共享契约 — 而不是在代码库之间复制实现细节。

工作原理:

  1. 在源代码库中,将规格发布到下游目标:
"将规格 SPEC-010 联邦到 team/payments-service"
→ federate_specs(...)
  1. 在目标代码库中,规格以只读方式显示,并带有上游链接。下游团队可以引用但不能直接修改它。

  2. 更改自动同步或按需同步。随时检查同步状态:

"检查联邦状态"
→ federation_status()

状态报告显示哪些规格相对于其上游源是超前、落后或冲突的。


3. 智能体团队编排

工具: plan_team_distributionorchestrate_runtimeorchestrate_agents

将大型规格分配给多个并行 AI 智能体,每个智能体对特定文件拥有独占所有权。

适用场景:

  • 涉及 5 个以上独立模块的规格
  • 具有清晰文件边界的大型重构
  • 可以并行化的时间敏感功能

不适用场景

不要编排小型规格(少于 3 个文件)。协调开销超过节省的时间。当模块紧密耦合时也应避免编排 — 智能体无法在运行中解决跨文件冲突。

工作原理:

  1. 规划分配 — Planu 分析规格并提出智能体分配方案:
"为 SPEC-099 规划团队分配"
→ plan_team_distribution(specId: "SPEC-099")
→ 返回:3 个智能体、文件分配、预估时间
  1. 启动编排 — 智能体并行工作,每个智能体负责其分配的文件:
"使用 3 个智能体编排 SPEC-099"
→ orchestrate_runtime(specId: "SPEC-099", agentCount: 3)
→ 智能体并行工作,Planu 监控进度
  1. 监控并完成:
"检查编排状态"
→ orchestrate_agents(action: "status")

Planu 强制执行的规则:

  • 每个智能体拥有独占文件 — 无并发编辑
  • 所有智能体完成后运行集成测试
  • 冲突被标记,而非自动解决

后续步骤

加入社区提问、分享反馈,与其他使用 Planu 的开发者交流。
加入 Discord