SuperAPI AI 工具集

debug-agent

编程与开发

查看项目

更新于 10-16 05:28

技能介绍

用途

Debug Agent 是一个 Bug 诊断与修复专用技能,来自 first-fluke/fullstack-starter。它面向需要排查和修复代码缺陷的场景,帮助分析错误、定位根本原因、给出修复方案并补充回归测试。

适用场景

根据资料,以下情况适合使用该技能:

  • 用户报告带有错误信息的 Bug
  • 某处功能损坏,需要修复
  • 性能问题或运行变慢
  • 间歇性失败或竞态条件
  • 回归 Bug

以下情况不适合使用:

  • 构建新功能,应改用 Frontend/Backend/Mobile agents
  • 一般代码审查,应改用 QA Agent

核心规则

该技能强调以下工作原则:

  • 先复现,再诊断,绝不猜测修复方案
  • 定位根本原因,而不只是处理表面症状
  • 最小化修复:只改动必要部分
  • 每个修复都要配一个回归测试
  • 修复后搜索其他地方是否存在相似模式
  • 将记录写入 .agents/brain/bugs/

使用方式

资料给出的执行方式包括:

  • 按步骤遵循 resources/execution-protocol.md
  • 查看 resources/examples.md 了解输入/输出示例
  • 提交前运行 resources/checklist.md

在 CLI 模式下,执行协议参见 ../_shared/execution-protocols/ 中针对不同厂商的协议。当通过 oh-my-ag agent:spawn 启动时,协议会自动注入。

Serena MCP 能力

该技能可配合 Serena MCP 使用,资料列出的能力包括:

  • find_symbol("functionName"):定位函数
  • find_referencing_symbols("Component"):查找所有使用位置
  • search_for_pattern("error pattern"):查找相似问题

参考资料

资料中列出的参考文件包括:

  • 执行步骤:resources/execution-protocol.md
  • 代码示例:resources/examples.md
  • 检查清单:resources/checklist.md
  • 错误恢复:resources/error-playbook.md
  • Bug 报告模板:resources/bug-report-template.md
  • 常见模式:resources/common-patterns.md
  • 调试检查清单:resources/debugging-checklist.md
  • 上下文加载:../_shared/context-loading.md
  • 推理模板:../_shared/reasoning-templates.md
  • 上下文预算:../_shared/context-budget.md
  • 经验教训:../_shared/lessons-learned.md

限制

资料未提供该技能的收费、价格、平台支持范围、具体效果指标或完整安装步骤,这些信息暂未提供。