mcpField
S
spec-plan

spec-plan

github.com/fellowship-dev开发3177 次安装2 周前更新
代码仓库

关于 spec-plan

spec-plan 是面向复杂计划或设计梳理的访谈技能，供需要逐步明确决策的团队使用。它先检查已有背景，再逐项处理相互依赖的问题，并可将结果交给 issue-to-prd。

主要功能

  1. 01检查现有议题或项目背景
  2. 02一次提出一个访谈问题
  3. 03按顺序解决相互依赖的决策
  4. 04可将结果交给 issue-to-prd

适用场景

  1. 01检验功能计划中的不足
  2. 02在使用 issue-to-prd 前厘清决策

安装

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

$npx skills add https://github.com/fellowship-dev/dogfooded-skills --skill spec-plan

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

详细介绍

spec-plan

针对计划的每个方面，持续深入地采访用户，直到双方达成共识。逐一梳理设计树的每个分支，依次解决决策之间的依赖关系。

适用场景

  • 用户希望对计划或设计进行压力测试
  • 用户说“尽管问我”或“找找这里面的漏洞”
  • 运行 issue-to-prd 之前——spec-plan 消除歧义，issue-to-prd 梳理输出结构
  • 涉及多个相互影响的决策、需要按顺序逐一解决的复杂功能

不适用场景

  • 需求已经明确记录——直接使用 issue-to-prd
  • 用户只想快速听取意见，而不是进行深入访谈
  • 已经开始实施

工作流

1. 阅读现有上下文

如果计划源自 GitHub issue：

gh issue view ISSUE_NUMBER --repo ORG/REPO --json body,title,comments

还要阅读所有评论——将已有的问题和答案视为已经解决的分支。不要重复询问已经回答的问题。

如果没有 issue，则阅读项目上下文：

cat project-instructions.md  # or equivalent project instructions file
cat README.md
2. 访谈——每次只问一个问题

针对设计树的每个分支：

  • 提出一个问题
  • 给出你的建议答案及理由
  • 等待用户回复
  • 纳入用户的答案，然后继续下一个分支

警告： 一次只问一个问题。这不是 issue-to-prd 的批量 Q1-Qn 格式。深入探讨每个分支后，再继续下一个。

如果可以通过探索代码库来回答问题，就探索代码库，而不是提问。

3. 解决依赖关系

当决策相互依赖时，先解决依赖项：

  • 确认哪些决策会阻碍其他决策
  • 先询问阻碍项
  • 然后再继续处理依赖这些决策的事项
4. 移交给 issue-to-prd（可选）

解决所有分支后，提出：

All branches resolved. Want me to run issue-to-prd to structure this into a PRD?

如果用户同意，则将本次访谈达成的共识作为输入；issue-to-prd 可以跳过清晰度评估，直接起草。

关键规则

  • 一次只问一个问题——重深度，不求广度
  • 始终给出你的建议答案——不要只提问，也要提出方案
  • 绝不重复询问已解决的问题——先阅读 issue 评论
  • 提问前先探索代码——如果代码库中已有答案，就直接使用
  • 从对话中断处继续——尊重之前的讨论

评论

支持 Markdown