用途
kiro-review 执行任务局部(task-local)的对抗式审查,目标是验证某项任务实现是否真实、完整、受限、与已批准的需求和设计保持一致,并有机械验证证据支撑。其核心问题不仅是“它能工作吗”,还包括“它是否停留在获批的职责边界内、没有隐藏新的耦合”。
在以下时机使用:
- 实现者报告 READY_FOR_REVIEW 之后
- 审查被拒后进行整改之后
- 将任务标记为 [x] 之前
- 接受任务进入功能级验证之前
不应使用该技能编造缺失的需求,或静默地重新解释规格。
边界术语的连贯性
- discovery 识别 Boundary Candidates(边界候选)
- design 确定 Boundary Commitments(边界承诺)
- tasks 以 Boundary: 约束执行
- review 拒绝具体的 Boundary Violations(边界违规)
主要能力
机械检查(作为主要信号)
- 回归安全:使用控制器发现的验证命令运行项目规范测试套件;测试失败则拒绝。
- 无残留占位标记:检查改动文件中是否出现 TBD、TODO、FIXME、HACK、XXX;若在没有明确任务理由的情况下引入新的占位标记,则拒绝。
- 无硬编码密钥:检查改动文件中是否存在硬编码密钥或凭据;若引入具体的密钥模式,则拒绝。
- 边界遵守:将改动文件与任务 Boundary: 范围比对;若无明确理由越出获批边界,则拒绝。若在应为局部任务的实现中引入隐藏的跨边界协调,也拒绝。
- RED 阶段证据:对行为类任务,验证实现者状态报告是否包含 RED_PHASE_OUTPUT;若 RED 证据缺失、为空或与任务验收标准无关,则拒绝。
- 运行时敏感的静态检查:若项目已对相关技术栈有 lint 或等价静态分析,则针对任务边界运行相关命令。关注那些能通过类型检查/构建但在运行时失败的模式:被当作值使用的类型专用导入、通过限定名访问却缺少命名空间值导入、未解析的全局变量,以及新引入的运行时敏感依赖却没有对应的启动/运行时处理。若项目没有 lint 命令,则在改动文件中针对这些模式做基于 diff 的定点抽查。对会造成现实的启动期或模块加载失败的确定性问题,予以拒绝。
判断性检查
- 真实性检查:确认实现是真实的生产代码,而不是占位、桩、伪路径或延后工作的空壳。
- 验收标准覆盖:阅读任务描述,确认所有方面都已实现,而不只是主要顺利路径。
- 需求对齐:阅读 requirements.md 中被引用的章节,确认每条需求都由具体的可观察行为满足;只使用原始章节编号。
- 设计对齐:阅读 design.md 中被引用的章节,确认实现使用了规定的结构、接口与依赖方向;拒绝以静默替换的方式偏离设计强制选择。 10.5 边界审计:将实现与设计的边界承诺及越界声明比对。若为图方便把下游特有的行为推到上游边界,拒绝;若实现跨相邻边界制造了新的隐藏依赖、共享所有权或未声明耦合,拒绝;若本不是显式集成任务的实现现在表现出集成任务的行为,拒绝。
- 测试质量:确认测试证明的是所需行为,而不只是脚手架;确认若移除或破坏实现,测试会失败。
- 错误处理:确认相关失败路径已被处理,而不是被静默吞掉。
使用方式
输入
需要提供:
- 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:
- <specific finding with exact files/spec refs>
- REMEDIATION: <mandatory if REJECTED>
- SUMMARY: <one sentence>
适用场景
适用于 AI 编码代理或人类开发者完成某个具体任务后、需要对照已批准规格做任务级审查的场景,尤其适合规格驱动开发(spec-driven development)流程中任务验收前的门禁环节。
限制
本说明未提供该技能的收费、价格、支持平台或安装方式等信息,暂未提供。