SuperAPI AI 工具集

kiro-debug

编程与开发

查看项目

更新于 10-15 22:39

技能介绍

用途:kiro-debug 是一个面向“全新上下文根因调查”的调试技能,用于在实现者报告 BLOCKED、评审驳回在修复后重复出现、验证意外失败、任务与运行时或平台现实冲突、同一失败在多次尝试修复后仍存在时,先收集证据再定位根因,而不是猜测式打补丁。

主要能力:读取错误信息、堆栈与失败命令输出,判断失败是确定性还是间歇性;检查仓库本地证据,如 package.json、pyproject.toml、go.mod、Makefile、README、构建配置、tsconfig 或等价语言/运行时配置、依赖版本与脚本、git diff 中相关改动;在可用时检索网络,优先官方文档、官方仓库/issue、版本相关参考与运行时文档;将根因归类为 MISSING_DEPENDENCY、RUNTIME_MISMATCH、MODULE_FORMAT、NATIVE_ABI、CONFIG_GAP、LOGIC_ERROR、TASK_ORDERING_PROBLEM、TASK_DECOMPOSITION_PROBLEM、SPEC_CONFLICT 或 EXTERNAL_DEPENDENCY;确定最小安全下一步,并判断当前任务计划是否仍然有效。

使用方式:需提供确切失败症状或阻塞陈述、错误消息与堆栈及失败命令输出、当前 git diff 或未提交失败改动摘要、任务简述、评审反馈(如来自评审驳回)、相关 spec 文件路径(requirements.md、design.md)、相关需求/设计章节编号、相关 ## Implementation Notes、已知运行时或环境约束。输出包含 ROOT_CAUSE、CATEGORY、FIX_PLAN、VERIFICATION、NEXT_ACTION(RETRY_TASK | BLOCK_TASK | STOP_FOR_HUMAN)、CONFIDENCE(HIGH | MEDIUM | LOW)、NOTES,并使用 spec.json 指定的语言。

适用场景与限制:适合仓库内可修复、当前已批准任务计划内的失败;当缺少前置任务、任务排序错误、任务边界需拆分或合并、任务过大或含糊时,优先 STOP_FOR_HUMAN;仅当当前任务应停止但队列其余部分仍可安全推进时使用 BLOCK_TASK。不要提出多修复“散弹式”方案,不要用暴力代码修复替代修订 tasks.md 或已批准计划;若真正问题是规格冲突或架构问题,应直接说明。需要人工产品/需求决策、外部凭据或不可访问服务、硬件或不可用外部系统、因规格/平台冲突需重新界定范围时,应升级为 STOP_FOR_HUMAN。若问题可在当前任务计划内通过仓库改动修复,不要过早升级。