mcpField
O
oma-debug

oma-debug

github.com/gracefullight开发49158 次安装1 天前更新
代码仓库

关于 oma-debug

oma-debug 是面向软件缺陷排查与修复的技能，适用于处理错误、崩溃、性能问题和回归。它强调先复现并确认根因，再进行最小范围修复、添加回归测试并验证。

主要功能

  1. 01复现故障并分析根因
  2. 02实施最小范围代码修复
  3. 03添加回归测试
  4. 04运行相关验证检查
  5. 05记录问题与修复结果

适用场景

  1. 01排查带有错误信息的故障
  2. 02修复间歇性失败或竞态问题
  3. 03调查性能变慢或回归

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/gracefullight/stock-checker --skill oma-debug

安装后在 Claude Code 中输入/oma-debug确认已加载。

包含的文件

除 SKILL.md 外，安装时一起下载的参考资料和脚本。

resources/
bug-report-template.md
checklist.md
common-patterns.md
debugging-checklist.md
error-playbook.md
examples.md
execution-protocol.md

详细介绍

调试 Agent - Bug 修复专家

调度

目标

复现、诊断并以最小改动修复 Bug，进行回归测试，同时严格控制范围并记录根本原因。

意图特征
  • 用户报告 Bug、崩溃、回溯、异常、错误消息、性能问题、间歇性故障或回归问题。
  • 用户需要根本原因分析、最小代码修复和回归测试。
适用情况
  • 用户报告了带有错误消息的 Bug
  • 某项功能出现故障，需要修复
  • 存在性能问题或速度变慢
  • 出现间歇性故障或竞态条件
  • 出现回归 Bug
不适用情况
  • 构建新功能 → 使用前端／后端／移动端 Agent
  • 常规代码审查 → 使用 QA Agent
预期输入
  • 错误消息、故障行为、复现步骤、日志、测试失败信息或受影响的代码路径
  • 现有测试、堆栈跟踪、环境说明和疑似回归范围
预期输出
  • 根本原因说明
  • 针对故障行为的最小修复
  • 回归测试，或明确说明无法添加测试的原因
  • 适当时在 .agents/results/bugs/ 下记录 Bug 文档
依赖项
  • resources/execution-protocol.md、示例、检查清单、常见模式和调试检查清单
  • 本地代码库搜索和符号／引用工具
  • 项目测试、lint、类型检查和运行命令
控制流特征
  • 根据复现是否成功、错误类别、疑似层级和验证结果进行分支处理
  • 读取日志／代码／测试，并编写代码／测试／文档
  • 修复后必须搜索类似模式

结构化流程

入口
  1. 记录报告的问题现象和疑似范围。
  2. 复现问题，或建立最接近且可靠的故障信号。
  3. 确认受影响的文件、测试和相关模式。
阶段
  1. 准备：收集问题现象、日志、复现路径和验证命令。
  2. 采集：阅读故障代码、测试、引用和类似模式。
  3. 推理：查明根本原因，并排除缺乏依据的假设。
  4. 执行：应用最小修复并添加回归测试。
  5. 验证：重新运行故障相关检查和其他相关检查。
  6. 收尾：记录根本原因、修复、测试和剩余风险。
转换
  • 如果无法复现，则利用日志／测试建立较弱但明确的诊断信号。
  • 如果首次修复未通过验证，则返回根本原因分析。
  • 如果存在类似模式，则检查并仅修补受影响的情况。
  • 如果请求实际上属于功能开发，则转交给相关实现技能。
故障与恢复
  • 如果缺少环境，则记录阻碍因素，并提供尽可能接近的静态诊断。
  • 如果无法添加回归测试，则说明原因并提供手动验证方法。
  • 如果修复范围扩大，则停止并指出更广泛的设计问题。
退出
  • 成功：Bug 已修复，已有回归测试覆盖，且检查通过。
  • 部分成功：明确说明根本原因或验证阻碍因素。

逻辑操作

操作
操作SSL 原语证据
复现故障CALL_TOOL测试／运行时／日志命令
搜索受影响的代码READ代码、测试、符号、引用
对比类似模式COMPARE模式搜索
推断根本原因INFER诊断推理
编写最小修复WRITE代码补丁
编写回归测试WRITE测试补丁
验证行为VALIDATE测试／检查
报告结果NOTIFY根本原因摘要
工具与手段
  • 项目测试、lint、类型检查、运行时和日志命令
  • 配置好的代码智能符号／引用／模式搜索工具，并在必要时使用原生命令作为后备
  • 调试检查清单和 Bug 报告模板
规范工作流路径

使用已配置的代码智能提供程序定位文件并检查符号 或内容。对于 Serena，请使用 find_file、search_for_pattern、 get_symbols_overview 和 find_symbol。原生搜索仅限于提供程序排除项 以及项目搜索策略允许的非代码路径。

首先运行最小复现命令，确定因果机制；如果 OMA 工作流处于活动状态，则按照 resources/execution-protocol.md 记录诊断。添加回归测试，并重新运行失败检查及相关测试。

资源范围
范围资源目标
CODEBASE失败的源代码、测试和相关模式
LOCAL_FSBug 报告和结果产物
PROCESS复现和验证命令
MEMORY假设、根因记录、验证证据
前置条件
  • 有可用的 Bug 信号、症状或失败行为。
  • 可以检查相关代码和验证路径，或者已说明阻碍因素。
影响和副作用
  • 仅在修复所需范围内修改源代码/测试。
  • 可能会在 .agents/results/bugs/ 下创建 Bug 文档。
防护措施
  1. 先复现，再诊断——绝不猜测修复方案
  2. 找出根因，而不只是症状
  3. 最小化修复：只修改必要内容
  4. 每项修复都要有回归测试
  5. 修复后搜索其他位置的类似模式
  6. 在 .agents/results/bugs/ 中记录文档
代码智能

使用已配置的提供程序定位失败函数、查找调用方并搜索类似错误模式。支持原生搜索和限定范围的读取作为后备方案；参见共享能力约定。

参考资料

  • 本地代码工具：../_shared/core/code-intelligence.md（代码搜索/导航）

  • 执行步骤（所选任务必须遵循）：resources/execution-protocol.md

  • 检查清单（提交前自检）：resources/checklist.md

  • 错误恢复：resources/error-playbook.md

  • Bug 报告模板：resources/bug-report-template.md

  • 常见模式：resources/common-patterns.md

  • 调试检查清单（调查指南，用于步骤 1-2）：resources/debugging-checklist.md

  • 上下文加载：../_shared/core/context-loading.md

  • 上下文预算：../_shared/core/context-budget.md

  • 经验教训：../_shared/core/lessons-learned.md（匹配以往故障或按需回顾）

  • 可观测性移交：../oma-observability/SKILL.md §Integrations — 按 trace_id 查看跟踪/日志，进行 6 维取证

评论

支持 Markdown