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/balanced/budget 下分别使用 opus/sonnet/sonnet。新问题需通过 AskUserQuestion 收集预期行为、实际行为、错误信息、时间线和复现方式。之后读取 references/debugger-instructions.md,填充提示并启动 Task,subagent_type 为 general-purpose,调试文件创建于 .planning/debug/{slug}.md。

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

限制:资料未提供安装方式、收费、价格、平台支持或效果保证;具体行为取决于 kata-orchestrator 环境与配置。