SuperAPI AI 工具集

grill-to-kiro

智能体与模型

查看项目

更新于 10-20 01:20

技能介绍

用途

该技能是 Kiro / SDD 新 spec 流程前的准备环节。由于 Kiro 会强力推进 requirements / design / tasks,如果输入过于模糊,模糊之处就会被固定进 spec,因此本技能在进入 Kiro 之前,先把用户要求整理到可交接的程度。

主要能力

  1. 确认既有上下文:按 AGENTS.md / CLAUDE.md 的 Project Context Sources,仅检查存在的 CONTEXT.md、CONTEXT-MAP.md、docs/adr/、docs/agents/、.kiro/steering/、.kiro/specs/、openspec/ 等,不因文件缺失而中断,此阶段不新建 Kiro 产物。
  2. 先走 grill-with-docs:一次只问一个对边界判断有效的问题,能从代码或文档确认的不问用户;明确谁面临什么问题、现状与不足、完成后应成立的条件、spec 的拥有与不拥有范围、与既有 spec / subsystem / public contract 的关系、新确定的领域术语与禁忌词及不变量、是否需要 ADR。术语写入 CONTEXT.md(仅作 glossary),ADF 仅在必要时写入 docs/adr/*。
  3. 生成 Kiro Handoff:以结构化摘要(Problem、Current State、Desired Outcome、Scope 的 In/Out、Boundary Candidates、Upstream/Downstream、Domain Context Updates、Kiro Route)代替原始对话,作为 Kiro 的输入。
  4. 接入 Kiro:边界仍待探索或可能涉及多范围拆分时,调用 $kiro-discovery "<handoff summary>";单一 spec 的边界与 feature 名已足够清晰时,调用 $kiro-spec-init "<handoff summary>";判定无需 spec 则不进 Kiro,直接建议实现或其他流程。若 kiro-discovery 生成 .kiro/specs/<feature>/brief.md 或 .kiro/steering/roadmap.md,需要回读确认术语、边界与 ADR 判断未丢失;进入 kiro-spec-init 时优先使用已有 brief.md,否则以 handoff 作为 project description。

适用场景

需要将新功能、机制或改进方案转为 spec;准备进入 kiro-discovery 或 kiro-spec-init;在进入 requirements / design / tasks 前想先固化要求;预计有需要写入 CONTEXT.md 或 ADR 的术语与判断;用户表达“先煮透再进 Kiro”或“先 grill 再 spec”的意图。

不使用的情况

仅想确认既有 spec 状态;继续已批准的 requirements / design / tasks / implementation;明显不需要 spec 的小修改、配置变更或简单重构;用户明确要求跳过 grilling 直接进入 Kiro。

限制与禁止事项

不得把模糊的初始要求直接交给 kiro-discovery / kiro-spec-init;CONTEXT.md 不得混入实现细节、任务或 spec 正文;ADR 不得当作 spec 台账使用;不得为本流程改写 kiro-* 分发技能本体;不得擅自推进到 requirements / design / tasks / implementation,只有用户明确要求才进入下游阶段。

完成条件

以下任一即视为完成:已形成反映 grill-with-docs 结果的 CONTEXT.md / docs/adr/* 与 Kiro Handoff,并接入 kiro-discovery 或 kiro-spec-init;判定无需 spec 并给出理由与后续实现方向;存在未解决的边界、术语或判断,并明确告知需用户决策后才能进入 Kiro。