设计与规划工具（流程 D）

流程 D 工具将已批准的规格转化为可执行的实现工件 — 数据库设计、UI 契约、架构决策、执行计划、事件契约等。

快速参考

工具	描述	可用性
`generate_adr`	为重大技术决策生成架构决策记录	已包含
`log_decision`	注册、列出、搜索或取代架构和流程决策	已包含
`design_schema`	为应用程序设计和验证数据模式	已包含
`define_ui_contract`	为设计到代码工作流定义和管理 UI 组件契约	已包含
`event_contracts`	定义和管理事件驱动架构契约	已包含
`generate_execution_plan`	创建实现规格的逐步执行计划	已包含
`generate_orchestration_script`	生成用于编排多代理执行的脚本	已包含
`recommend_model`	为给定任务推荐最佳 AI 模型级别	已包含
`plan_team_distribution`	规划如何将已批准的规格分配给 Claude Code 代理团队	已包含
`generate_spec_from_design`	从 UI/UX 设计描述生成 Planu 规格	已包含
`contribute_context`	从外部来源为规格贡献额外上下文	已包含
`request_context`	从知识库请求额外上下文或专业知识	已包含
`generate_proposal`	生成带 KPI 网格和甘特图的独立 HTML 项目提案	已包含
`generate_docs_site`	从项目规格生成静态 HTML 文档站点	已包含
`data_governance`	设置数据治理策略和数据分类规则	已包含
`legal_compliance_report`	为法律和监管要求生成合规报告	已包含
`federate_specs`	将当前项目中的规格链接到另一个本地仓库中的规格	已包含
`federation_status`	显示所有跨仓库规格联邦链接及其健康状态	已包含
`discover_registry`	从本地文件路径读取和验证 `.well-known/planu.json` 清单	已包含
`publish_registry`	从项目规格生成 `.well-known/planu.json` 清单	已包含
`registry_publish`	将规格发布到 Planu 注册表	已包含
`registry_login`	使用 API 令牌向 Planu 规格注册表进行身份验证	已包含
`registry_logout`	删除存储的注册表凭据	已包含
`registry_whoami`	显示当前已认证的注册表用户	已包含
`a2a_register`	将 Planu 注册为支持 A2A（代理到代理）的代理	已包含
`a2a_delegate`	将规格相关任务委托给另一个 A2A 代理端点	已包含

架构决策

`generate_adr`

为重大技术决策生成架构决策记录（ADR）。

输出内容： 结构化的 ADR 文档，涵盖决策背景、考虑的选项、所做的决策和后果。格式遵循 MADR（Markdown 架构决策记录）。

适用场景： 当规格涉及重大技术选择、架构模式或未来开发者需要理解的权衡取舍时。

提示词："Generate ADRs for spec SPEC-004 in project proj_abc123"

示例输出：

markdown

# ADR-001: Use Redis for session storage

## Status: Accepted

## Context
The authentication spec requires session persistence across multiple server instances...

## Decision
Use Redis as the session store...

## Consequences
- Positive: Horizontal scaling without sticky sessions
- Negative: Adds Redis as a required infrastructure dependency

`log_decision`

在项目决策日志中注册、列出、搜索或取代架构和流程决策。

可用操作： log（记录）、list（列出）、search（搜索）、supersede（取代）

适用场景： 维护项目期间所做决策的可搜索记录 — 谁决定了什么、为什么决定以及何时决定。当团队改变方向时取代之前的决策。

提示词："Log a decision: we will use PostgreSQL instead of MongoDB for project proj_abc123"
提示词："List all decisions for project proj_abc123"
提示词："Supersede decision DEC-003 with the new approach in project proj_abc123"

`design_schema`

为应用程序设计和验证数据模式。

输出内容：

带列、类型和约束的表定义
主键和外键关系
查询性能的索引建议
迁移提示
多种方言的模式（SQL、Prisma、SQLAlchemy、GORM 等）

适用场景： 当规格涉及数据持久化，需要数据库层的具体起始点时。

提示词："Design the database schema for spec SPEC-002 in project proj_abc123"

`define_ui_contract`

为设计到代码工作流定义和管理 UI 组件契约。

输出内容：

组件接口定义（props、事件、插槽）
数据流图（哪些组件拥有哪些状态）
状态管理方式（本地、上下文、store）
前端和后端之间的 API 契约
无障碍需求

适用场景： 对于任何包含前端组件、表单或用户交互的规格。

提示词："Define the UI contract for the login flow in spec SPEC-001 for project proj_abc123"

`event_contracts`

定义和管理事件驱动架构契约 — 为生产者/消费者验证生成 JSON Schema 事件契约。

输出内容：

每种事件类型的 JSON Schema 定义
生产者契约（发布者的保证）
消费者契约（订阅者的预期）
版本控制策略
向后兼容性说明

适用场景： 对于任何涉及消息队列、事件总线（Kafka、RabbitMQ、AWS SQS/SNS、NATS）或 Webhook 集成的规格。

提示词："Define event contracts for the order processing flow in spec SPEC-008 for project proj_abc123"

示例输出：

json

{
  "$schema": "http://json-schema.org/draft-07/schema#",
  "title": "OrderPlaced",
  "version": "1.0.0",
  "type": "object",
  "required": ["orderId", "customerId", "items", "total", "placedAt"],
  "properties": {
    "orderId": { "type": "string", "format": "uuid" },
    "customerId": { "type": "string", "format": "uuid" },
    "items": { "type": "array", "items": { "$ref": "#/definitions/OrderItem" } },
    "total": { "type": "number", "minimum": 0 },
    "placedAt": { "type": "string", "format": "date-time" }
  }
}

执行规划

`generate_execution_plan`

创建实现规格的详细逐步执行计划 — RED/GREEN/VERIFY 循环，带可并行步骤标识。

输出内容：

markdown

## Phase 1: Foundation (parallel)
- [ ] Step 1a: Create database migration
- [ ] Step 1b: Define TypeScript interfaces
- [ ] Step 1c: Write failing tests (RED)

## Phase 2: Implementation (sequential)
- [ ] Step 2a: Implement repository layer (GREEN)
- [ ] Step 2b: Implement service layer

## Phase 3: Verification
- [ ] Step 3a: Run full test suite (VERIFY)
- [ ] Step 3b: Update spec status to review

适用场景： 在实现开始之前。PLAN.md 成为 AI 代理或开发者的实现契约。

提示词："Generate an execution plan for spec SPEC-005 in project proj_abc123"

`generate_orchestration_script`

生成用于编排多代理执行的脚本 — 使用 worktree 和 claude -p 创建 3 层并行自动化脚本。

输出内容： 一个 shell 脚本，用于：

每个规格创建隔离的 Git worktree
并行启动 claude -p 工作进程
根据可用 CPU 和 RAM 管理资源分配
监控工作进程健康状态并处理故障

适用场景： 当你需要同时实现多个独立规格并希望最大化并行度时。

提示词："Generate an orchestration script for specs SPEC-010, SPEC-011, SPEC-012 in project proj_abc123"

`recommend_model`

根据复杂度、成本和能力需求，推荐最佳 AI 模型级别（haiku、sonnet 或 opus）。

评估内容：

任务复杂度（简单代码生成 vs. 架构决策）
成本约束
速度要求
所需推理深度

适用场景： 在选择用于实现、代码审查或规格生成的 AI 模型时。

提示词："Recommend a model for implementing spec SPEC-005 in project proj_abc123"

`plan_team_distribution`

规划如何将已批准的规格分配给 Claude Code 代理团队 — 根据依赖关系、文件归属和并行约束分配规格给代理。

输出内容：

代理分配表（哪个代理处理哪些规格）
确定排序的依赖图
防止冲突的文件归属映射
可直接使用的代理启动提示词

适用场景： 在与代理团队并行实现多个规格时。防止文件冲突和浪费的工作。

TIP

在启动任何代理团队之前运行 plan_team_distribution。它会捕获否则会导致合并噩梦的文件归属冲突。

提示词："Plan team distribution for approved specs in project proj_abc123"

从输入设计

`generate_spec_from_design`

从 UI/UX 设计描述生成 Planu 规格 — 将线框图、模型描述或设计说明转换为结构化的验收标准。

适用场景： 当设计师交付 UI 的描述或图像，需要在实现之前将其转化为可构建的规格时。

提示词："Generate a spec from this design: a dashboard with a sidebar nav, main content area, and a collapsing filters panel, for project proj_abc123"

`contribute_context`

从外部来源或领域专业知识为规格贡献额外上下文 — 将结构化知识附加到现有规格。

适用场景： 当主题专家（法律、安全、合规）需要向规格添加原作者没有的约束时。

提示词："Contribute context to spec SPEC-003: GDPR requires data deletion within 30 days for project proj_abc123"

`request_context`

从知识库请求额外上下文或专业知识 — 查询与规格相关的已学习模式、过去决策和领域知识。

适用场景： 在不熟悉的领域编写规格之前，从过去项目中提取相关约束和模式。

提示词："Request context for a payments integration spec in project proj_abc123"

导出与文档

`generate_proposal`

生成带 KPI 网格、甘特图、规格细分表、风险分析、预算摘要和架构概述的独立 HTML 项目提案。

输出内容： 一个可随时与客户或利益相关者共享的可移植 HTML 文件 — 无需服务器。

适用场景： 向非技术利益相关者或潜在客户展示项目计划时。

提示词："Generate a project proposal for project proj_abc123"

`generate_docs_site`

从项目规格、工具目录、架构图和指标生成静态 HTML 文档站点。

输出内容：

涵盖所有规格、其状态和验收标准的可浏览 HTML 站点
从规格图派生的架构图
可搜索的工具目录
可在任何静态服务器上托管

适用场景： 当项目需要与规格保持同步的活态文档时。

提示词："Generate a documentation site for project proj_abc123"

治理与合规

`data_governance`

为项目设置数据治理策略和数据分类规则。

输出内容：

数据分类分类法（公开、内部、机密、受限）
每个数据类别的治理策略
数据处理需求的规格级标记
未来规格和代码中的违规检测

适用场景： 对于处理敏感数据的项目 — 医疗、金融、法律或任何受监管行业。

提示词："Set up data governance for project proj_abc123 under HIPAA"

`legal_compliance_report`

为法律和监管要求生成合规报告 — 将规格和实现映射到具体的法规条款。

输出内容：

每项法规的覆盖率报告（GDPR、HIPAA、SOC 2、PCI DSS 等）
需要修复的未解决差距
规格和审计追踪事件的证据链接
可导出用于法律审查

适用场景： 在合规审计之前或准备认证证据包时。

提示词："Generate a GDPR compliance report for project proj_abc123"

联邦与注册表

联邦允许你跨仓库链接规格。注册表允许发布和发现规格，以便跨团队和组织复用。

`federate_specs`

将当前项目中的规格链接到另一个本地仓库中的规格 — 创建跨仓库依赖链接。

适用场景： 在单体仓库或多仓库设置中，一个项目的规格依赖于另一个项目的规格时。

提示词："Federate spec SPEC-005 in project proj_abc123 to spec SPEC-012 in project proj_xyz789"

`federation_status`

显示所有跨仓库规格联邦链接及其健康状态 — 检查链接的规格是否仍然存在且处于同步状态。

提示词："Show federation status for project proj_abc123"

`discover_registry`

从本地文件路径读取和验证 .well-known/planu.json 清单 — 显示项目公开的可复用规格。

提示词："Discover registry manifest at /workspace/shared-lib"

`publish_registry`

从项目规格生成 .well-known/planu.json 清单 — 使你的规格可被其他项目发现。

提示词："Publish registry manifest for project proj_abc123"

`registry_publish`

将规格发布到 Planu 注册表，以便其他团队可以发现和复用它。

提示词："Publish spec SPEC-007 to the Planu registry from project proj_abc123"

`registry_login`

使用 API 令牌向 Planu 规格注册表进行身份验证。

提示词："Log in to the Planu registry with my API token"

`registry_logout`

从本地计算机删除存储的注册表凭据。

提示词："Log out of the Planu registry"

`registry_whoami`

显示当前已认证的注册表用户。

提示词："Who am I logged in as in the Planu registry?"

代理到代理（A2A）

A2A 使 Planu 能够参与多代理生态系统 — 注册为有能力的代理并将任务委托给其他专业代理。

`a2a_register`

将 Planu 注册为支持 A2A（代理到代理）的代理 — 将 Planu 的能力发布到 A2A 端点，以便其他代理可以发现并委托给它。

适用场景： 在将 Planu 集成到其他编排器需要知道 Planu 可以做什么的多代理流水线时。

提示词："Register Planu as an A2A agent for project proj_abc123"

`a2a_delegate`

将规格相关任务委托给另一个 A2A 代理端点 — 向外部代理发送结构化任务请求并接收结果。

适用场景： 当另一个专业代理（例如代码审查代理、部署代理）应该处理 Planu 工作流中的某个步骤时。

提示词："Delegate the code review for spec SPEC-009 to the review agent at http://localhost:8080 in project proj_abc123"

另请参阅

规格生命周期工具（流程 B） — 创建、更新和管理规格
分析与估算工具（流程 C） — 验证、审计和从代码库学习
平台与运维工具（流程 E–I） — 技术栈、代理、Git、治理

设计与规划工具（流程 D） ​

快速参考 ​

架构决策 ​

generate_adr ​

log_decision ​

design_schema ​

define_ui_contract ​

event_contracts ​

执行规划 ​

generate_execution_plan ​

generate_orchestration_script ​

recommend_model ​

plan_team_distribution ​

从输入设计 ​

generate_spec_from_design ​

contribute_context ​

request_context ​

导出与文档 ​

generate_proposal ​

generate_docs_site ​

治理与合规 ​

data_governance ​

legal_compliance_report ​

联邦与注册表 ​

federate_specs ​

federation_status ​

discover_registry ​

publish_registry ​

registry_publish ​

registry_login ​

registry_logout ​

registry_whoami ​

代理到代理（A2A） ​

a2a_register ​

a2a_delegate ​

另请参阅 ​

设计与规划工具（流程 D）

快速参考

架构决策

`generate_adr`

`log_decision`

`design_schema`

`define_ui_contract`

`event_contracts`

执行规划

`generate_execution_plan`

`generate_orchestration_script`

`recommend_model`

`plan_team_distribution`

从输入设计

`generate_spec_from_design`

`contribute_context`

`request_context`

导出与文档

`generate_proposal`

`generate_docs_site`

治理与合规

`data_governance`

`legal_compliance_report`

联邦与注册表

`federate_specs`

`federation_status`

`discover_registry`

`publish_registry`

`registry_publish`

`registry_login`

`registry_logout`

`registry_whoami`

代理到代理（A2A）

`a2a_register`

`a2a_delegate`

另请参阅