关于 plan-interview
Plan Interview 是一项通过自适应访谈,将初步计划和想法整理为可实施规格说明的技能。它会按计划复杂度调整提问深度,并提供 Agent,从完整性、一致性、清晰度和边缘情况等方面审查规格说明。
主要功能
- 01按计划复杂度调整访谈
- 02覆盖六个阶段的结构化提问
- 03生成含实施细节的规格说明
- 04从四个维度自动审查质量
适用场景
- 01将功能构想扩展为详细规格说明
- 02在实施前梳理需求和假设
- 03检查规格说明中的矛盾与遗漏
- 04评估风险、边缘情况和运维需求
安装
复制下面的命令,在终端中运行。
$
npx skills add https:/ / github.com/ secondsky/ claude-skills --skill plan-interview安装后在 Claude Code 中输入/plan-interview确认已加载。
包含的文件
除 SKILL.md 外,安装时一起下载的参考资料和脚本。
references/example-spec.mdinterview-techniques.mdphase-1-clarifications.mdphase-2-technical.mdphase-3-ux.mdphase-4-risks.md详细介绍
计划访谈技能
通过自适应的结构化访谈,将粗略计划转化为全面且可直接用于实现的规格说明。
适用场景
- 将计划或想法转化为详细规格说明
- 通过结构化提问收集需求
- 将粗略文档转化为可直接用于实现的规格说明
- 确保在开始实现前考虑到所有边缘情况、风险和利益相关方
可用组件
命令:/plan-interview:interview [plan-file]
自适应访谈,会根据计划的复杂度调整访谈深度:
| 复杂度 | 信号 | 问题数 |
|---|---|---|
| 简单 | 单一功能,范围明确 | 10-15 |
| 中等 | 多个组件,存在一些集成 | 18-23 |
| 复杂 | 跨系统,涉及许多利益相关方 | 22-28 |
用法:
/plan-interview:interview docs/feature-plan.md
# Output: docs/feature-plan-spec.md
Agent:spec-reviewer
从 4 个维度对规格说明进行自主质量分析:
- 完整性(25 分)- 所有章节都已填写?
- 一致性(25 分)- 没有矛盾?
- 清晰度(25 分)- 没有含糊的表述?
- 边缘情况(25 分)- 已定义错误处理?
当你说“审核我的规格说明”或“检查规格说明质量”时触发。
访谈阶段
- 基础与范围 - 利益相关方、成功标准、约束条件、MVP 范围
- 技术深入探讨 - 架构、数据模型、可扩展性、安全性
- 用户体验 - 用户画像、流程、认知负荷、错误恢复
- 风险与权衡 - 风险分类、影响范围、应急计划
- 运维落地 - 测试、部署、监控
- 收尾(可选)- 仅适用于仍有待解决问题的复杂计划
访谈理念
核心原则:深度优先于广度。深入理解关键方面,比浅尝辄止地涵盖所有内容更好。
关键技巧:
- 提出不显而易见的问题 - 跳过计划中已经回答的内容
- 探查边缘情况 - 在异常情况下会发生什么?
- 揭示假设 - 明确表达隐含的认知
- 检测矛盾 - 指出回答之间不一致的地方
- 调整深度 - 对复杂领域深入探查,对明确的部分加快推进
规格说明输出结构
生成的规格说明包括:
- 概述(问题、解决方案、成功标准、利益相关方)
- 功能性和非功能性需求
- 技术设计(架构、数据模型、API、安全性)
- 用户体验(用户画像、流程、状态、边缘情况)
- 风险与缓解措施(风险登记表、权衡、应急计划)
- 实现说明(关键决策、依赖项、迁移)
- 运维落地(测试、部署、监控)
- 未决问题和范围外事项
- 分阶段规划(MVP 与未来阶段)
参考资料
访谈期间可加载以下内容,以获取更深入的指导:
references/phase-1-clarifications.md- 基础问题与常见疏漏references/phase-2-technical.md- 架构讨论模式references/phase-3-ux.md- 用户画像开发、UX 模式references/phase-4-risks.md- 风险评估框架references/interview-techniques.md- 通用访谈技巧references/example-spec.md- 高质量规格说明示例(含注释)
评论
支持 Markdown