SuperAPI AI 工具集

kiro-spec-init

编程与开发

查看项目

更新于 11-09 09:54

技能介绍

用途

kiro-spec-init 是规格驱动开发流程中的初始化步骤,用于为一个新功能建立规格目录,并生成两个初始文件:spec.json 与 requirements.md。它不产出完整的需求、设计或任务文档,只负责把规格的“起点”搭好,后续步骤由面向需求、设计与任务的技能继续推进。

主要能力

  1. 读取发现简报:如果 {{KIRO_DIR}}/specs/{feature-name}/brief.md 存在(由 $kiro-discovery 创建),技能会读取其中的问题、方法、范围与约束,用于预填项目描述,并跳过简报已覆盖的澄清问题。
  2. 澄清意图:requirements.md 的项目描述需包含三要素——谁遇到问题、当前状况、期望发生什么改变。若 brief.md 已覆盖这些内容则直接进入下一步;否则向用户提问,直到信息明确,不自行假设补齐。
  3. 检查命名唯一性:核查 {{KIRO_DIR}}/specs/ 下是否存在命名冲突。若目录已存在但仅含 brief.md(无 spec.json),则复用该目录。
  4. 创建目录:{{KIRO_DIR}}/specs/[feature-name]/,若已由发现流程创建则跳过。
  5. 基于模板初始化文件:读取 {{KIRO_DIR}}/settings/templates/specs/init.json 与 requirements-init.md,替换占位符 {{FEATURE_NAME}}、{{TIMESTAMP}}、{{PROJECT_DESCRIPTION}}、{{LANG_CODE}},然后写入 spec.json 与 requirements.md。语言代码根据用户输入语言检测,默认 en。

使用方式

调用该技能并给出功能名称或项目描述参数;技能按上述步骤检查简报、澄清意图、检查目录、创建目录、套用模板并写出文件。完成后输出以下内容:生成的功能名(feature-name 格式及 1-2 句理由)、一句话项目摘要、创建文件的完整路径列表,以及下一步命令提示:

$kiro-spec-requirements <feature-name>

输出使用 Markdown 标题、代码块包裹命令,整体控制在 250 词以内,语言遵循 spec.json 中的 language 设置。

适用场景

适用于需要在编码或设计之前先建立规格基线的功能开发流程,尤其是已通过发现阶段产出 brief.md、希望快速进入需求编写的情形。

限制与异常处理

  • 不生成需求、设计或任务内容,仅创建 spec.json 与 requirements.md。
  • 功能名称不明确时,提出 2-3 个候选让用户选择。
  • 模板文件缺失时,报告具体缺失路径并建议检查仓库配置。
  • 功能名已存在时,自动追加数字后缀(如 feature-name-2)并告知用户。
  • 写入失败时,报告具体路径并建议检查权限或磁盘空间。