SuperAPI AI 工具集

kiro-review

编程与开发

查看项目

更新于 10-16 11:32

技能介绍

用途

kiro-review 执行任务局部(task-local)的对抗式审查,目标是验证某项任务实现是否真实、完整、受限、与已批准的需求和设计保持一致,并有机械验证证据支撑。其核心问题不仅是“它能工作吗”,还包括“它是否停留在获批的职责边界内、没有隐藏新的耦合”。

在以下时机使用:

  • 实现者报告 READY_FOR_REVIEW 之后
  • 审查被拒后进行整改之后
  • 将任务标记为 [x] 之前
  • 接受任务进入功能级验证之前

不应使用该技能编造缺失的需求,或静默地重新解释规格。

边界术语的连贯性

  • discovery 识别 Boundary Candidates(边界候选)
  • design 确定 Boundary Commitments(边界承诺)
  • tasks 以 Boundary: 约束执行
  • review 拒绝具体的 Boundary Violations(边界违规)

主要能力

机械检查(作为主要信号)

  1. 回归安全:使用控制器发现的验证命令运行项目规范测试套件;测试失败则拒绝。
  2. 无残留占位标记:检查改动文件中是否出现 TBD、TODO、FIXME、HACK、XXX;若在没有明确任务理由的情况下引入新的占位标记,则拒绝。
  3. 无硬编码密钥:检查改动文件中是否存在硬编码密钥或凭据;若引入具体的密钥模式,则拒绝。
  4. 边界遵守:将改动文件与任务 Boundary: 范围比对;若无明确理由越出获批边界,则拒绝。若在应为局部任务的实现中引入隐藏的跨边界协调,也拒绝。
  5. RED 阶段证据:对行为类任务,验证实现者状态报告是否包含 RED_PHASE_OUTPUT;若 RED 证据缺失、为空或与任务验收标准无关,则拒绝。
  6. 运行时敏感的静态检查:若项目已对相关技术栈有 lint 或等价静态分析,则针对任务边界运行相关命令。关注那些能通过类型检查/构建但在运行时失败的模式:被当作值使用的类型专用导入、通过限定名访问却缺少命名空间值导入、未解析的全局变量,以及新引入的运行时敏感依赖却没有对应的启动/运行时处理。若项目没有 lint 命令,则在改动文件中针对这些模式做基于 diff 的定点抽查。对会造成现实的启动期或模块加载失败的确定性问题,予以拒绝。

判断性检查

  1. 真实性检查:确认实现是真实的生产代码,而不是占位、桩、伪路径或延后工作的空壳。
  2. 验收标准覆盖:阅读任务描述,确认所有方面都已实现,而不只是主要顺利路径。
  3. 需求对齐:阅读 requirements.md 中被引用的章节,确认每条需求都由具体的可观察行为满足;只使用原始章节编号。
  4. 设计对齐:阅读 design.md 中被引用的章节,确认实现使用了规定的结构、接口与依赖方向;拒绝以静默替换的方式偏离设计强制选择。 10.5 边界审计:将实现与设计的边界承诺及越界声明比对。若为图方便把下游特有的行为推到上游边界,拒绝;若实现跨相邻边界制造了新的隐藏依赖、共享所有权或未声明耦合,拒绝;若本不是显式集成任务的实现现在表现出集成任务的行为,拒绝。
  5. 测试质量:确认测试证明的是所需行为,而不只是脚手架;确认若移除或破坏实现,测试会失败。
  6. 错误处理:确认相关失败路径已被处理,而不是被静默吞掉。

使用方式

输入

需要提供:

  • tasks.md 中的任务 ID 与任务原文
  • 相关需求章节编号
  • 相关设计章节编号
  • 规格文件路径(requirements.md、design.md,可选 tasks.md)
  • 实现者的状态报告
  • 任务 Boundary: 范围约束
  • 控制器发现的验证命令
  • 适用时的相关 steering 摘录
  • 适用时的相关 ## Implementation Notes 条目

输出

返回以下之一:APPROVED 或 REJECTED。同时返回:机械检查结果、带严重度的问题发现、必要的整改要求、一句话总结。输出语言使用 spec.json 中指定的语言。

第一步操作

运行 git diff 检查实际代码改动。若 diff 很大或含义不清,直接阅读改动文件。不要将实现者报告当作事实来源。

核心原则

自己读规格,自己读 diff,尽可能做机械验证。基于具体失败而非乐观解释来拒绝。

严重度模型

  • Critical:功能损坏、验证无效、数据丢失、安全风险或重大范围违规
  • Important:验收前必须修复
  • Suggestion:非阻塞改进
  • FYI:信息性说明

停止/升级

在以下情况应升级而非掩盖问题:

  • 获批规格在正确性关键处存在歧义
  • 设计与技术可行性冲突
  • 无法收集所需证据
  • 实现只有在静默偏离获批范围的情况下才能工作
  • 无法从需求、设计与任务范围清晰判定边界归属

常见合理化及其现实

  • “测试通过,所以批准”:测试通过并不能证明规格一致或边界遵守。
  • “额外行为很有用”:获批范围之外的额外行为仍是漂移。
  • “实现者说做过 RED”:RED 必须有证据,而不是口头断言。
  • “这个缺口小到可以放过”:真实缺口必须拒绝或升级。

输出格式

Review Verdict

  • VERDICT: APPROVED | REJECTED
  • TASK: <task-id>
  • MECHANICAL_RESULTS:
    • Tests: PASS | FAIL (command and exit code)
    • TBD/TODO grep: CLEAN | <count> matches
    • Secrets grep: CLEAN | <count> matches
    • Static checks: PASS | FAIL | SPOT_CHECKED
    • Boundary: WITHIN | <files outside boundary>
    • Boundary audit: CLEAN | <spillover / hidden dependency findings>
    • RED phase: VERIFIED | MISSING | N/A
  • FINDINGS:
    1. <specific finding with exact files/spec refs>
  • REMEDIATION: <mandatory if REJECTED>
  • SUMMARY: <one sentence>

适用场景

适用于 AI 编码代理或人类开发者完成某个具体任务后、需要对照已批准规格做任务级审查的场景,尤其适合规格驱动开发(spec-driven development)流程中任务验收前的门禁环节。

限制

本说明未提供该技能的收费、价格、支持平台或安装方式等信息,暂未提供。