SuperAPI AI 工具集

grill-workflow

通用与其它

查看项目

更新于 10-19 16:19

技能介绍

Grill Workflow 是一个专注于需求澄清阶段的工作流技能,旨在将模糊的想法或需求转化为清晰、可评审的决策。它不会直接进入实现,而是通过系统化的提问和决策记录,帮助团队在开发前达成共识。

用途

该技能的核心用途是消除产品、领域、范围、约束、业务规则和技术决策中的高影响歧义。它适用于项目初期或需求不明确时,通过结构化的问题集引导用户明确关键决策。

主要能力

  • 依赖感知的提问:每轮提出一组相关问题,这些问题基于已解决的前置条件,确保用户能够独立回答。问题按产品、范围、领域行为、约束和技术等维度组织。
  • 决策状态管理:将信息分类为事实、提案、已同意和开放问题,确保未经确认的提案不会被误当作已同意决策。
  • 避免过度工程:对于中小型 Web 项目,主动挑战不必要的复杂性,如微服务、消息队列、Kubernetes 等,除非有明确需求。
  • 决策记录:在用户明确确认决策后,更新现有项目上下文文档(如 docs/requirement.md、CONTEXT.md、docs/adr/ 等),或维护临时决策摘要。
  • 停止条件:当所有初始规格所需的高影响决策稳定后,停止提问,总结已确认决策和剩余开放问题,并推荐下一个技能。

使用方式

  1. 阅读现有上下文:首先阅读 AGENTS.md(如果存在),然后检查 CONTEXT.md、docs/requirement.md、docs/adr/、现有规格、原型页面、项目清单、配置、相关源代码和测试。只读取相关部分,避免过度阅读。
  2. 识别已知事实和未解决决策:根据阅读内容,区分事实、提案、已同意和开放问题。
  3. 提问:每轮提出一组相关问题,每个问题有稳定 ID(如 P1、S2),并提供清晰选项或直接问题。优先询问能消除分支的高影响问题。
  4. 记录决策:用户回答后,记录每个确认的决策,更新相关文档或维护决策摘要。
  5. 重复:仅当重要歧义仍存在时继续提问。
  6. 总结和推荐:满足停止条件后,总结已确认决策,列出非阻塞开放问题,并推荐恰好一个下一个技能(如 $grill-design、$setup-project、$to-prototype 或 $write-spec),然后停止并等待用户调用。

适用场景

  • 新项目启动,需要明确产品目标、用户、范围、业务规则和技术选型。
  • 现有项目需求模糊,需要澄清和记录关键决策。
  • 需要避免过度工程,确保技术方案与需求匹配。
  • 团队需要结构化的需求澄清流程,确保决策可追溯。

限制

  • 该技能仅负责需求澄清阶段,不实现功能、不生成实现代码、不创建实现任务。
  • 不绕过行为规格,原型优先路线必须通过 $spec-with-prototype 返回。
  • 推荐下一个技能只是交接,不意味着自动执行。用户必须在后续轮次显式调用。
  • 对于需要当前生态研究的技术决策,标记为“需要研究”,除非实际使用了可用的研究流程,否则不声称已进行外部研究。
  • 不强制使用固定阶段边界,但需确保问题在前提条件解决后提出。