用途
kiro-spec-init 是规格驱动开发流程中的初始化步骤,用于为一个新功能建立规格目录,并生成两个初始文件:spec.json 与 requirements.md。它不产出完整的需求、设计或任务文档,只负责把规格的“起点”搭好,后续步骤由面向需求、设计与任务的技能继续推进。
主要能力
- 读取发现简报:如果 {{KIRO_DIR}}/specs/{feature-name}/brief.md 存在(由 $kiro-discovery 创建),技能会读取其中的问题、方法、范围与约束,用于预填项目描述,并跳过简报已覆盖的澄清问题。
- 澄清意图:requirements.md 的项目描述需包含三要素——谁遇到问题、当前状况、期望发生什么改变。若 brief.md 已覆盖这些内容则直接进入下一步;否则向用户提问,直到信息明确,不自行假设补齐。
- 检查命名唯一性:核查 {{KIRO_DIR}}/specs/ 下是否存在命名冲突。若目录已存在但仅含 brief.md(无 spec.json),则复用该目录。
- 创建目录:{{KIRO_DIR}}/specs/[feature-name]/,若已由发现流程创建则跳过。
- 基于模板初始化文件:读取 {{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)并告知用户。
- 写入失败时,报告具体路径并建议检查权限或磁盘空间。