debug-pro

提供 7 步标准调试协议 + 多语言调试命令，系统性识别、验证、修复软件缺陷，用于回答「代码报错怎么查」「这个 bug 到底在哪」「改了还是不对怎么办」这类问题

Install

openclaw skills install @zhaoxinghua09-cell/debug-pro

一句话

报错不可怕，可怕的是凭感觉乱改。本技能把调试压成 7 步标准协议：每一步只回答一个问题，走完就知道 bug 在哪、为什么改了没用。

七步协议

复现：先拿到稳定复现路径，复现不了的 bug 不硬修——先记录；
定位层：判断错误出在输入、逻辑、依赖还是环境，别在错误的层里翻代码；
最小化：把触发条件裁到最小，变量越少定位越快；
假设：一次只立一个假设，写清楚「若假设成立会看到什么」；
验证：跑实验去证伪假设，而不是找支持它的证据；
修复：改根因不改症状；顺手修「顺便的问题」是二次事故之源；
回归：修完跑原复现路径加相邻用例，确认没改出新问题。

分层速查

症状	先查哪层
立即崩溃	输入与环境（路径、版本、权限）
偶发失败	并发、缓存、边界条件
改了没反应	是否改对了执行中的那份代码（旧进程在跑？构建缓存？）

改了还是不对怎么办

多半是三种情况之一：改的不是执行中的文件、假设跳步没验证、修复只盖住了表层。回到第 1 步重新复现，最省时间。

边界

给排查路径与验证命令，不凭截图远程断言根因；
无法复现时明确说「信息不足」，列出需要补充的日志项；
生产环境操作（重启、回滚、改配置）只给方案，执行须人工确认。

常见问题

问	答
只给报错截图能查吗？	能给排查方向，但给最小复现步骤效率高一个量级
会不会建议直接重装？	只在环境层确认损坏后才建议，且先列备份清单

License & attribution

分层许可（务必并读；代码许可不覆盖文档与理论文本）

层	载体	许可
代码	本包无独立代码文件（纯文档/理论件）	—
文档与理论文本	本 `SKILL.md`、`README.md`、其中「理论依据」段与一切理论表述	不在 MIT 覆盖范围内：保留所有权利（All rights reserved）

即：代码可依 MIT 使用与再分发；文档与理论文本不因代码许可而默认可自由再发布。

text

© 2026 赵兴华 / Steven Zhao·China (ORCID 0009-0001-0512-1237). All rights reserved.
理论署名 (attribution) : LGD（Lifecycle Governance Doctrine / 全程治理论）— SynomosAI initiative
名称状态 (name status)  : "SynomosAI" / "MedXpert" — 未申请实体注册、未申请商标注册
                        (not a registered legal entity; no trademark registered)
生产参考部署 (production reference, self-reported) : MedXpert
                    ← 非认证、非背书、非监管认可（not a certification or endorsement）
代码许可 (code license) : 本包 = MIT (see LICENSE)
                    本文本与理论表述不在任何代码许可覆盖范围内
引用格式 (cite as)      : 本资产无 DOI

（上列为《LGD 对外表述规范》§3.2 统一块，整体复制、未删改；发布/重提前须照最新版本复核。）