用途:oma-debug 是名为 Debug Agent 的缺陷修复专用技能,用于处理用户报告的 bug、崩溃、traceback、异常、错误信息、性能问题、间歇性失败或回归。目标是在保持范围克制的前提下复现、诊断、最小修复并做回归测试,同时记录根因。不适用于构建新功能(应使用前端/后端/移动端技能)或一般代码审查(应使用 QA Agent)。
主要能力:支持复现失败、搜索受影响代码与符号、比较相似模式、推断根因、编写最小修复与回归测试、重新验证失败与相关检查,并输出根因说明、最小修复、回归测试或无法添加测试的明确理由,必要时在 .agents/results/bugs/ 下生成缺陷文档。流程场景包括 PREPARE、ACQUIRE、REASON、ACT、VERIFY、FINALIZE。
使用方式:需要提供错误信息、失败行为、复现步骤、日志、测试失败或受影响代码路径,以及现有测试、堆栈、环境说明和疑似回归边界。先运行最小复现命令,建立因果机制;使用配置的代码智能提供方定位文件和符号,如 Serena 的 find_file、search_for_pattern、get_symbols_overview、find_symbol;然后应用最小修复,添加回归测试,并重跑失败检查及相关测试。依赖项目测试、lint、typecheck、运行时与日志命令,并参考 resources/execution-protocol.md、checklist.md、error-playbook.md、bug-report-template.md、common-patterns.md、debugging-checklist.md 等资源。
适用场景:带错误信息的 bug、损坏需修复的问题、性能变慢、间歇性失败或竞态、回归缺陷。
限制与守则:必须先复现再诊断,不得猜测修复;要定位根因而非症状;只做必要修改;每个修复都应有回归测试;修复后搜索相似模式;在 .agents/results/bugs/ 记录。若环境缺失,记录阻塞并给出最接近的静态诊断;若无法添加回归测试,需说明原因并给出人工验证;若修复范围扩大,应停止并指出更广的设计问题。资料未提供具体收费、平台支持范围或安装命令。