陌讯skills聚合平台

scientific-debugging

📁 vidyfoo/antigravity-skill-engine 📅 9 days ago
2
总安装量
1
周安装量
#69106
全站排名
安装命令
npx skills add https://github.com/vidyfoo/antigravity-skill-engine --skill scientific-debugging

Agent 安装分布

cline 1
openclaw 1
cursor 1

Skill 文档

Scientific Debugger Skill (v2.0)

Role: 拒绝”猜测驱动开发”。像科学家一样思考，用实验数据定位根因。

核心协议 (The Protocol)

1. 观察 (Observe)

  • 收集现场: 用户报告了什么？错误堆栈是什么？
  • 环境确认: 本地服务器是否运行？
  • 现象复现: 必须 使用 browser_subagent 复现问题 (Visual Proof)。

2. 假设 (Hypothesize)

基于观察，提出 1-3 个可能的根因假设：

  • H1: DOM 事件未冒泡 (Event)
  • H2: 状态更新被闭包捕获 (State)
  • H3: 样式层叠导致的遮挡 (CSS)

3. 实验 (Experiment)

设计最小化实验验证假设：

  • Console Log: 在关键路径打点。
  • Browser Interaction: 模拟用户行为序列。
  • Code Inspection: 检查 view_code_item.

4. 修复与验证 (Fix & Verify)

  • 最小化修复: 只改根因，不附带重构。
  • 回归测试: 再次运行 browser_subagent 确认修复且无副作用。

调试策略库

问题类型 推荐工具 重点检查
UI 无响应/交互失效 browser_subagent pointer-events, z-index, onClick vs onFocus
状态不同步 console.log + React DevTools Zustand Selectors, React Query Cache Key
样式错乱 browser_subagent (Screenshot) Tailwind Classes, CSS Variables
网络错误 Network Tab (via Browser) CORS, 404/500, Payload Format

资源索引

资源文件 用途
browser-test-guide.md 浏览器测试通过指南
root-cause-patterns.md 常见根因模式库

强制要求

  1. No Blind Fixes: 禁止在未复现问题前修改代码。
  2. Visual Evidence: 对于 UI Bug，必须看截图证明。
  3. Logs are Cheap: 大胆加日志，但修好后记得删。
GitHub 仓库 ↗ ← 返回陌讯 Skills 聚合平台
本页面由 陌讯 Skills 聚合平台 收录整理，数据定期更新。