规格生命周期工具（流程 B）
流程 B 包含所有管理完整规格生命周期的工具 — 从第一个澄清问题到将生产就绪的规格交接给 AI 代理。
快速参考
| 工具 | 描述 | 可用性 |
|---|---|---|
facilitate | 零知识入口点 — 描述你想构建的内容 | 已包含 |
clarify_requirements | 在创建规格之前以交互方式澄清需求 | 已包含 |
elicit_requirements | 高级交互式需求引导 | 已包含 |
create_spec | 从描述创建完整 SDD 规格 | 已包含 |
list_specs | 列出项目中的所有规格，可按状态筛选 | 已包含 |
update_status | 将规格推进到不同的生命周期阶段 | 已包含 |
summarize_spec | 生成规格的简短可读摘要 | 已包含 |
spec_history | 查看规格的变更日志历史 | 已包含 |
reconcile_spec | 更新规格以匹配实际构建内容 | 已包含 |
branch_spec | 为实验性探索创建规格分支 | 已包含 |
merge_spec_branch | 将实验性规格分支合并回主规格 | 已包含 |
version_spec | 创建规格的标记版本快照 | 已包含 |
spec_diff | 比较两个规格版本并显示差异 | 已包含 |
export_spec | 将规格导出为外部格式（spec-kit） | 已包含 |
check_readiness | 检查规格是否有足够细节可以开始构建 | 已包含 |
challenge_spec | 通过模拟故障和边缘情况对规格进行压力测试 | 已包含 |
red_team | 对抗性审查 — 从第一原则反对规格 | 已包含 |
detect_contradictions | 检测规格内部或规格间的矛盾和不一致 | 已包含 |
manage_scope | 管理和控制范围以防止范围蔓延 | 已包含 |
package_handoff | 为代理或团队交接打包规格及其依赖 | 已包含 |
decompose_spec | 自动将规格分解为独立的代理任务 | 已包含 |
analyze_spec_dependencies | 分析依赖图：关键路径、循环依赖、执行波次 | 已包含 |
generate_checklist | 从规格生成实现检查列表 | 已包含 |
check_spec_accuracy | 根据实际代码库实现验证规格 | 已包含 |
spec_coverage | 生成显示规格与实现对比的覆盖率报告 | 已包含 |
spec_usage_report | 显示代理正在活跃使用哪些规格的报告 | 已包含 |
semantic_search | 按含义搜索规格和项目知识 | 已包含 |
list_templates | 浏览内置和自定义规格模板目录 | 已包含 |
apply_template | 从规格模板创建规格文件 | 已包含 |
capture_idea | 捕获轻量级想法，无需创建完整规格 | 已包含 |
list_backlog | 列出项目待办事项中的所有想法 | 已包含 |
promote_idea | 将待办事项中的想法提升为完整规格 | 已包含 |
discard_idea | 将待办事项中的想法标记为已丢弃 | 已包含 |
session_checkpoint | 保存包含当前上下文的会话检查点 | 已包含 |
planu_status | 获取当前项目状态的紧凑世界快照 | 已包含 |
log_lesson | 记录从规格或项目经验中学到的教训 | 已包含 |
list_lessons | 列出项目的所有经验教训 | 已包含 |
delete_spec | 从项目中删除一个或多个规格 | 已包含 |
delete_project | 删除项目的所有数据 | 已包含 |
delete_pattern | 删除一个或多个已学习的模式 | 已包含 |
delete_decision | 删除一个或多个决策/架构决策记录 | 已包含 |
manage_trash | 管理回收站：列出、恢复或清空 | 已包含 |
generate_spec_dashboard | 重新生成 planu/index.html 仪表板 | 已包含 |
核心工作流
facilitate
零知识入口点 — 描述你想构建的内容，Planu 确定下一步操作。
适用场景： 当你不确定从哪里开始时。用自然语言描述你的想法或目标，facilitate 会决定是澄清需求、创建规格还是建议下一步行动。
提示词："I want to add Stripe payments to my app"
提示词："Help me plan a multi-tenant permission system"TIP
facilitate 是新用户最好的起点。它无需知道任何工具名称 — 只需描述你想构建的内容即可。
clarify_requirements
在创建规格之前生成有针对性的澄清问题。
适用场景： 在 create_spec 之前，当需求模糊、来自简短的口头交流或涉及多个系统时使用。
输出内容： 一份按优先级排列的问题清单，涵盖范围边界、边缘情况、非功能性需求、错误处理和外部依赖。
提示词："Use planu to clarify requirements for adding Stripe payments to project proj_abc123"TIP
先运行 clarify_requirements 会产生更完整的验收标准，减少规格修订次数。这是 30 秒的投入，能节省数小时的时间。
elicit_requirements 专业版
高级交互式需求引导 — 结构化访谈模式，比 clarify_requirements 更深入。
适用场景： 对于复杂功能、平台迁移或涉及多个利益相关者的集成。该工具根据你的回答生成后续问题，而不是呈现一个固定列表。
提示词："Elicit requirements for the new reporting module in project proj_abc123"create_spec
创建带有自动生成章节的完整 SDD 规格。
生成内容：
| 章节 | 描述 |
|---|---|
| 用户故事 | 标准格式的谁、什么、为什么 |
| 验收标准 | 可测试、无歧义的标准，带编号便于追溯 |
| DoR 检查列表 | 准备就绪定义关卡 |
| 数据库架构提示 | 表、列、关系、索引 |
| UI 契约 | 组件契约、数据流、状态管理 |
| 架构决策记录提示 | Architecture Decision Records |
| PLAN.md | 逐步 RED/GREEN/VERIFY 执行计划 |
AI 原生附加内容（检测到 AI 架构时）：
- 延迟预算和回退链
- 提示词版本控制标准
- LLM 可观测性需求
前端附加内容（检测到性能设置时）：
- Core Web Vitals 标准
- SSR 水合需求
- 微前端边界定义
提示词："Create a spec for adding Google OAuth authentication to my project proj_abc123"list_specs
列出项目的所有规格，可选择按状态筛选。
适用场景： 查看待办事项、进行中的项目或需要审查的内容。
提示词："List all specs for project proj_abc123"
提示词："Show me specs in progress for project proj_abc123"
提示词："What specs are blocked in project proj_abc123?"update_status
通过 DoR/DoD 验证将规格在生命周期中推进。
状态流程： draft → ready → in_progress → review → done
每次状态转换都会验证相应的检查列表。在满足 DoD 标准之前，无法将规格标记为 done。
提示词："Update status of spec SPEC-003 to in_progress in project proj_abc123"
提示词："Mark spec SPEC-007 as done in project proj_abc123"summarize_spec
生成规格的简洁摘要 — 适用于团队更新、PR 描述或站立会议笔记。
提示词："Summarize spec SPEC-005 for project proj_abc123"规格生命周期管理
spec_history 专业版
查看规格的变更历史 — 谁更改了什么、何时更改以及为什么更改。
适用场景： 在调查规格变更原因、进行审计或解决规格争议时。
提示词："Show history for spec SPEC-003 in project proj_abc123"reconcile_spec 专业版
将规格与实现变更协调，逐项变更审批并检查章程合规性。
适用场景： 当实现有意偏离规格，需要更新规格以匹配实际情况时。
该工具会逐项呈现变更供你审批 — 由你决定什么成为新的规格真相。
提示词："Reconcile spec SPEC-004 with the implementation changes in project proj_abc123"branch_spec 专业版
为实验性探索创建规格分支 — 让你在不修改主规格的情况下探索重大规格变更。
适用场景： 当你想在提交之前原型化某个规格的替代方法（不同架构、不同范围）时。
提示词："Create a branch of spec SPEC-012 called 'microservices-approach' in project proj_abc123"merge_spec_branch 专业版
验证后将实验性规格分支合并回主规格。
提示词："Merge the 'microservices-approach' branch of spec SPEC-012 into main in project proj_abc123"version_spec 专业版
创建规格的标记版本快照 — 适用于里程碑跟踪和外部交接。
适用场景： 在重大发布之前、向外部团队交接之前，或在大型重构之前锁定基线时。
提示词："Create version v1.0 snapshot of spec SPEC-008 in project proj_abc123"spec_diff 专业版
比较两个规格版本并显示变更内容的结构化差异。
提示词："Show the diff between v1.0 and v2.0 of spec SPEC-008 in project proj_abc123"export_spec 专业版
将规格导出为外部格式（spec-kit），以便在 Planu 之外共享。
提示词："Export spec SPEC-010 to spec-kit format for project proj_abc123"质量门
check_readiness 专业版
评估规格是否准备好实现 — 完整性、标准质量和依赖状态。
执行的检查：
- 所有验收标准是否可测试且无歧义？
- 所有阻塞依赖是否已解决？
- DoR 检查列表是否完整？
- 规格是否通过章程合规性检查？
提示词："Check if spec SPEC-006 is ready for implementation in project proj_abc123"challenge_spec 专业版
通过模拟故障、高流量、边缘情况和对抗性条件对规格进行压力测试。
适用场景： 在批准关键系统规格之前，或在重大规格修订之后。
提示词："Challenge spec SPEC-009 in project proj_abc123"red_team 专业版
对抗性审查 — 在批准之前从第一原则反对规格。
适用场景： 对于高风险规格（计费、身份验证、数据迁移），在锁定设计之前需要魔鬼代言人审查时。
提示词："Red team spec SPEC-011 in project proj_abc123"detect_contradictions 专业版
分析项目中所有规格的语义矛盾。
适用场景： 在开始冲刺之前、重大产品调整之后，或不同团队成员独立更新规格之后。
提示词："Detect contradictions in the specs for project proj_abc123"示例输出："SPEC-002 说用户可以删除账号。SPEC-008 说账号数据因审计目的不可更改。"
范围与打包
manage_scope 专业版
管理项目范围定义和待办事项 — 添加项目、删除、重新排优先级，或导出为结构化待办清单。
提示词："Add 'dark mode support' to the backlog for project proj_abc123 with priority high"
提示词："Show the current backlog for project proj_abc123"package_handoff 专业版
为 AI 代理生成实现规格的结构化交接包。
输出内容：
- 实现目标
- 编号的验收标准
- 带归属的文件列表
- 约束和保护措施
- 为 Claude 或任何 AI 代理准备好的可直接粘贴的提示词
适用场景： 将实现委托给自主 AI 代理会话或未参与规格创建的团队成员时。
提示词："Package spec SPEC-009 for handoff in project proj_abc123"decompose_spec 专业版
自动将规格分解为具有非重叠文件归属的独立代理任务 — 可立即并行运行。
适用场景： 对于可以跨多个代理或团队成员拆分的大型规格。该工具为每个任务强制执行独占文件归属以防止冲突。
提示词："Decompose spec SPEC-015 into parallel agent tasks in project proj_abc123"analyze_spec_dependencies 专业版
分析规格依赖图：找到关键路径、检测循环依赖并计算执行波次。
提示词："Analyze spec dependencies for project proj_abc123"
提示词："What is the critical path to ship SPEC-020 in project proj_abc123?"质量与覆盖率
generate_checklist 专业版
为规格生成质量检查列表 — 涵盖实现就绪度、测试覆盖率、文档、安全性和性能。
提示词："Generate a quality checklist for spec SPEC-002 in project proj_abc123"check_spec_accuracy 专业版
根据实现现实验证规格的准确性 — 检查验收标准、文件引用和技术细节是否仍然正确。
适用场景： 在重大代码变更之后、发布之前，或规格很长时间未审查时。
提示词："Check accuracy of spec SPEC-005 for project proj_abc123"spec_coverage 专业版
分析项目中的规格覆盖率 — 识别代码库中没有规格的区域和没有对应实现的规格。
适用场景： 在冲刺规划、季度审查期间，或在入职时了解文档差距。
提示词："Show spec coverage for project proj_abc123"spec_usage_report 专业版
生成规格可观测性报告，显示代理正在活跃使用哪些规格、哪些已过时以及哪些被引用最频繁。
提示词："Show spec usage report for project proj_abc123"semantic_search 专业版
按含义搜索你的项目知识（规格、模式、决策、已学知识）— 而不仅仅是关键词匹配。
适用场景： 当你记得某件事已被决定但无法通过关键词找到时，或在大型项目中查找与某个主题相关的规格时。
提示词："Search for anything related to rate limiting in project proj_abc123"
提示词："Find specs about user permissions in project proj_abc123"模板
list_templates
列出所有可用的规格模板及其描述和用例。
提示词："List available spec templates"apply_template 专业版
应用规格模板，快速创建常见模式（CRUD、认证、集成等）的规格。
适用场景： 在创建遵循已知模式的规格时，希望从预填充的章节快速开始。
提示词："Apply the CRUD template for a users resource in project proj_abc123"待办事项管理
capture_idea
捕获轻量级想法或未来可能性，无需创建完整规格。想法存储在待办事项中，直到被提升或丢弃。
提示词："Capture idea: add offline mode support to project proj_abc123"list_backlog
列出项目待办事项中的所有捕获想法。
提示词："Show backlog for project proj_abc123"promote_idea
将待办事项中的想法提升为完整规格，触发正常的规格创建流程。
提示词："Promote idea IDEA-003 to a spec in project proj_abc123"discard_idea
将待办事项中的想法标记为已丢弃，可附上可选原因。
提示词："Discard idea IDEA-005 in project proj_abc123 — not aligned with roadmap"会话与经验教训
session_checkpoint
保存包含当前上下文、进度和未解决问题的会话检查点 — 适用于恢复长时间会话。
提示词："Save a session checkpoint for project proj_abc123"planu_status
获取当前 Planu 项目状态的紧凑世界快照 — 活跃规格、Git 状态、队列和最近活动。设计为约 150 个词元以内。
提示词："What's the current status of project proj_abc123?"log_lesson
记录从规格或项目经验中学到的教训 — 存储为可搜索的项目知识。
提示词："Log lesson: always run detect_contradictions before sprint planning in project proj_abc123"list_lessons
列出项目的所有经验教训。
提示词："Show lessons learned for project proj_abc123"清理
delete_spec
从项目中删除一个或多个规格。已删除的规格移至回收站，可以恢复。
提示词："Delete spec SPEC-017 from project proj_abc123"delete_project
删除项目的所有数据。此操作在永久删除之前将所有数据移至回收站。
提示词："Delete project proj_abc123"delete_pattern
从项目中删除一个或多个已学习的模式。
提示词："Delete pattern PAT-002 from project proj_abc123"delete_decision
从项目中删除一个或多个决策/架构决策记录。
提示词："Delete decision DEC-005 from project proj_abc123"manage_trash
管理回收站：列出已删除项目、恢复特定项目或永久清空回收站。
提示词："List trash for project proj_abc123"
提示词："Restore spec SPEC-017 from trash in project proj_abc123"
提示词："Purge trash for project proj_abc123"generate_spec_dashboard
重新生成 planu/index.html 仪表板 — 项目所有规格、其状态和关键指标的 HTML 概览。
提示词："Regenerate the spec dashboard for project proj_abc123"另请参阅
- 分析与估算工具（流程 C） — 估算、模式检测、验证、推荐模型
- 设计与规划工具（流程 D） — 架构决策、数据库设计、执行计划
- 平台与运维工具（流程 E–I） — 技术栈、代理、Git、治理