SuperAPI AI 工具集

kata-debug

编程与开发

查看项目

更新于 10-15 21:49

技能介绍

用途:系统化调试问题,调查缺陷、排查故障或追踪错误,并在上下文重置后保持状态。它作为编排者,负责收集症状、启动 kata-debugger 子代理、处理检查点并启动续接代理。

主要能力:使用子代理进行调查,因为调查会快速消耗上下文(读文件、形成假设、测试),每次调查使用全新的 200k 上下文,主上下文保持精简以用于用户交互。支持检查活动会话、收集症状、读取指令文件、启动调试代理、处理代理返回结果以及启动续接代理。

使用方式:先检查活动会话,命令为 find .planning/debug -maxdepth 1 -name "*.md" 2>/dev/null | grep -v resolved | head -5。然后解析模型配置:MODEL_PROFILE=$(node scripts/kata-lib.cjs read-config "model_profile" "balanced"),未设置时默认 balanced。模型查找表中 kata-debugger 在 quality 下为 opus,balanced 和 budget 下为 sonnet。若有活动会话且无参数,列出会话供用户选择恢复或描述新问题;若有参数或新问题,则收集症状。症状收集使用 AskUserQuestion,涵盖预期行为、实际行为、错误信息、时间线和复现方式。之后读取 references/debugger-instructions.md,填充提示并启动 Task,subagent_type 为 general-purpose,模型为解析出的 debugger_model,调试文件创建于 .planning/debug/{slug}.md。

代理返回处理:若发现根因,显示根因和证据摘要,提供立即修复、规划修复或手动修复选项;若到达检查点,展示详情、获取用户响应并启动续接代理;若调查无结论,展示已检查与排除内容,提供继续调查、手动调查或补充上下文选项。续接代理在用户响应检查点后启动,引用调试文件并传入检查点响应。

适用场景:需要系统化排查缺陷、追踪错误、在多次上下文重置间保持调试状态的开发调试流程。

限制:资料未提供具体安装命令、收费信息、支持平台或效果保证;部分行为依赖外部脚本 scripts/kata-lib.cjs 和 references/debugger-instructions.md,这些文件内容暂未提供。