mcpField
P
plan-interview

plan-interview

github.com/secondsky开发240400 次安装5 周前更新
代码仓库

关于 plan-interview

Plan Interview 是一项通过自适应访谈,将初步计划和想法整理为可实施规格说明的技能。它会按计划复杂度调整提问深度,并提供 Agent,从完整性、一致性、清晰度和边缘情况等方面审查规格说明。

主要功能

  1. 01按计划复杂度调整访谈
  2. 02覆盖六个阶段的结构化提问
  3. 03生成含实施细节的规格说明
  4. 04从四个维度自动审查质量

适用场景

  1. 01将功能构想扩展为详细规格说明
  2. 02在实施前梳理需求和假设
  3. 03检查规格说明中的矛盾与遗漏
  4. 04评估风险、边缘情况和运维需求

安装

复制下面的命令,在终端中运行。

$npx skills add https://github.com/secondsky/claude-skills --skill plan-interview

安装后在 Claude Code 中输入/plan-interview确认已加载。

包含的文件

除 SKILL.md 外,安装时一起下载的参考资料和脚本。

references/
example-spec.md
interview-techniques.md
phase-1-clarifications.md
phase-2-technical.md
phase-3-ux.md
phase-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 分)- 已定义错误处理?

当你说“审核我的规格说明”或“检查规格说明质量”时触发。

访谈阶段

  1. 基础与范围 - 利益相关方、成功标准、约束条件、MVP 范围
  2. 技术深入探讨 - 架构、数据模型、可扩展性、安全性
  3. 用户体验 - 用户画像、流程、认知负荷、错误恢复
  4. 风险与权衡 - 风险分类、影响范围、应急计划
  5. 运维落地 - 测试、部署、监控
  6. 收尾(可选)- 仅适用于仍有待解决问题的复杂计划

访谈理念

核心原则:深度优先于广度。深入理解关键方面,比浅尝辄止地涵盖所有内容更好。

关键技巧:

  • 提出不显而易见的问题 - 跳过计划中已经回答的内容
  • 探查边缘情况 - 在异常情况下会发生什么?
  • 揭示假设 - 明确表达隐含的认知
  • 检测矛盾 - 指出回答之间不一致的地方
  • 调整深度 - 对复杂领域深入探查,对明确的部分加快推进

规格说明输出结构

生成的规格说明包括:

  • 概述(问题、解决方案、成功标准、利益相关方)
  • 功能性和非功能性需求
  • 技术设计(架构、数据模型、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