SuperAPI AI 工具集

debug-for-openclaw

编程与开发

查看项目

更新于 11-09 22:21

技能介绍

Debug For OpenClaw 是一个 OpenClaw 工作区内的调试技能,旨在用一套有纪律的调试循环来分诊和解决故障。其核心理念是:通过缩小不确定性来调试,而不是靠猜测修复。

用途 该技能适用于请求听起来像“帮我调试这个”“这个测试失败”等需要定位并修复 OpenClaw 工作区内故障的场景。它强调先理解问题再修改代码,避免盲目修补。

主要能力 技能给出的调试流程包括:尽可能具体地复现问题;定义观察到的行为与预期行为;在编辑代码前先定位故障面;把问题缩减为可获得的最小可复现用例;一次只形成一个强假设;只改动尽可能小的范围;重新运行验证;添加防护措施,使同类故障不太可能再次出现。

使用方式 在 OpenClaw 环境中调用该技能后,按其流程逐步推进调试。技能还提供 OpenClaw 相关指引:可用时优先使用一等工具进行检查;UI 或运行时缺陷在浏览器中可见时,使用基于浏览器的检查;把日志和追踪作为证据,而不是复现的替代品;如果缺陷横跨多个文件,应先回到规划环节,而不是盲目打补丁。

参考文件 当调试变得嘈杂或带有推测性时,阅读 references/triage-loop.md;当故障是间歇性的、发生在重构之后,或在配置或环境变更后出现时,阅读 references/failure-patterns.md;当故障面仍然过宽、需要缩小搜索空间时,阅读 references/localization-strategies.md。

应避免的做法 技能列出了若干不良模式:在复现缺陷之前就修改代码;叠加多个推测性修复;用不相关的通过测试作为证明;只消除症状而不理解原因就停止。

适用场景与限制 该技能面向 OpenClaw 工作区内的调试任务,依赖 OpenClaw 环境及相关参考文件。关于其具体安装方式、支持的平台、收费情况等,资料暂未提供。