Agent Skills
返回列表
Spec Grill 规格拷问流

Spec Grill 规格拷问流

开发编程 更新于 2026.08.29

将以下提示词粘贴到你的 AI 对话框中:

请根据 https://skillhub.cn/install/skillhub.md,安装 @user_eebfe12e/spec-grill。

技能介绍

要解决什么问题

很多团队在「看需求」和「直接写代码」之间缺一层:意图、权衡和边界还没问透,就已经产出 proposal.md 或改仓库了。OpenSpec 这类规格驱动流程能规范产物,但若跳过探索阶段,规格往往和真实决策脱节;同时让工程师背 openspec new change、openspec instructions 等命令,也会把对话式协作打断。

技能如何工作

spec-grill 以 OpenSpec CLI 为内核,固定走 Init → Grill → Propose → Apply → Archive。与标准 OpenSpec 的最大差异是:在 Propose 之前强制插入 Grill——四阶段结构化面试(目标对齐 → 架构决策 → 边界与风险 → 实现细节),沿决策树逐条追问;澄清结论作为 proposal / design / tasks 的种子,而不是事后补丁。

Grill 阶段只读代码、只问澄清、不写产物;支持从 TAPD 链接、Figma/墨刀/摹客/Axure、Markdown 需求文档、Swagger 等经 requirement-intake 统一接入。确认目标端与技术栈后,Apply 按项目既有约定与当前端已装技能实现,并按 tasks.md 逐项真实改代码再勾选。用户侧只需像和同事聊需求一样说话,AI 在后台执行对应 CLI 并完成校验与归档。

适用边界与注意点

  • 围绕业务需求的分析或实现应走主流程;不可在未 Grill(或用户未明确跳过)时直接生成 Propose 产物。
  • TAPD 缺陷修复、开发计划活文档、纯接口契约生成 等走独立 reference 分支,不替代主流程铁律。
  • tasks.md 中的 [x] 必须对应已落盘的代码;规划完成不等于需求完成,未实现任务应保持未勾选。
  • 敏感操作(提交、推送、删除、TAPD 写回等)需先说明影响并取得确认。

使用场景

  • 收到 TAPD 需求链接,需要先拆解范围、成功标准和 non-goal,再决定是否进入规格与实现
  • 产品给了 Figma/墨刀原型,要在不写代码的前提下先把架构选型与接口边界问清楚
  • 方案已有草案,希望用四阶段结构化面试做设计评审或压力测试,再生成 OpenSpec 变更产物
  • 需求已跑完 Grill,需要按 `tasks.md` 在现有前端/后端/小程序仓库里逐项落地并校验归档

适合人员

  • 负责把 TAPD/文档需求转成可执行变更的后端工程师,希望先拷问边界再动 Java/Go 等服务代码
  • 全栈或前端负责人,拿到原型链接后需要对话式走完 Grill 再产出 proposal 与增量 specs
  • 技术负责人做需求评审,需要 AI 沿决策树追问架构与风险而不是直接生成 tasks
  • 已采用 OpenSpec 的团队成员,想聊天完成 init/instructions/apply 而不用自己敲 CLI