SuperAPI AI 工具集

kiro-spec-requirements

写作与研究

查看项目

更新于 10-15 22:39

技能介绍

用途:为 Kiro 规格流程生成完整的需求文档(requirements.md),聚焦“做什么”而非“怎么做”,即用户可观察的行为、业务规则与边界,不涉及技术栈、架构或 API 设计。

主要能力:读取 .kiro/specs/$1/spec.json 获取语言与元数据,读取 brief.md、requirements.md 及 product.md、tech.md、structure.md 等 steering 上下文;按 rules/ears-format.md 的 EARS 语法编写验收标准;按 rules/requirements-review-gate.md 做写入前评审;按 spec.json.language 选择模板(ja 用 requirements.md,en 用 requirements.en.md),不支持的语言则停止。

使用方式:在 Kiro 中运行 $kiro-spec-requirements $1。复杂项目可派生子代理并行研究代码库、领域知识与 steering 文件;无多代理时在主上下文顺序执行。评审通过后写入 requirements.md,设置 phase 为 requirements-generated、approvals.requirements.generated 为 true 并更新时间戳。

适用场景:新功能或棕地项目的需求梳理,需要 EARS 格式、明确包含/排除边界与相邻期望时。

限制:需求标题必须带前导数字 ID,不使用字母 ID;每条需求须可测试且无歧义,存在范围歧义时须先向用户澄清而非猜测;模板或本地化术语文件缺失、语言未定义时停止;steering 目录为空会警告。评审最多两轮修复。后续可运行 $kiro-validate-gap $1 与 $kiro-spec-design $1 -y。