菜单
通过 Git Commit 二分法调试前端白屏/卡死问题。 当用户报告页面白屏、无响应、卡死，且怀疑是代码问题时使用。 特别适用于： 1. 开发服务器能启动但页面显示白屏 2. 页面无响应或卡死（可能是死循环） 3. 需要快速定位引入问题的具体 commit 4. 需要排除缓存、配置等干扰因素
默认使用会先检查来源的 Prompt；你也可以切换为直接命令，或下载本地副本。
决定是否安装前，请先阅读 SKILL.md，以及 SkillsMP 当前展示的配套文件。
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
直接命令不会经过审查 Prompt；运行前请先检查来源。
npx skills add https://github.com/Lionad-Morotar/local-tools --skill debug-by-commits命令会保持在同一行。复制前请横向滚动并检查完整内容。
想先保存到本地？可下载 SkillsMP 当前能够提供的文件。
项目版本发布流程指导，帮助用户完成版本规划、Changelog 管理、版本号升级、Git 标签创建和首次发布准备（支持 npm 包、VSCode 扩展/vsce、Claude Code skill 包等多发布目标）。Use when: (1) 用户需要发布新版本 (2) 需要创建版本发布流程 (3) 需要管理版本号和 Changelog (4) 需要自动化版本发布 (5) 需要识别分支模型并确保发版分支同步 (6) 首次发布准备（npm / VSCode 扩展 / Claude skill）
关闭承载当前 Claude Code 会话的宿主（VSCode 窗口或其终端面板），连同 claude 一起退出。通过 close-host-window 扩展触发：先 SIGTERM claude（走完 SessionEnd hooks）再关 host，不抢焦点、不丢 hooks。--host vscode 关窗口、--host terminal（默认）只关终端面板。Use when 任务结束要随宿主退出，或需精确关闭某 claude 终端所在窗口/面板。
将对话内容、Excalidraw 或 Mermaid 图表存档到 Obsidian vault（默认 Chaos）。触发词："存档到 Obsidian"、"保存到 Chaos"、"ob 存档"、"记下这个"、"存到 chaos"、"画个图存到 ob"、"excalidraw 存档"、"画流程图保存"、"mermaid 存档"、"画架构图到 ob"。
基于 SOC 职业分类
正在显示 SKILL.md
| name | debug-by-commits |
| description | 通过 Git Commit 二分法调试前端白屏/卡死问题。 当用户报告页面白屏、无响应、卡死，且怀疑是代码问题时使用。 特别适用于： 1. 开发服务器能启动但页面显示白屏 2. 页面无响应或卡死（可能是死循环） 3. 需要快速定位引入问题的具体 commit 4. 需要排除缓存、配置等干扰因素 |
| disable-model-invocation | true |
当页面出现白屏或卡死时，通过 Git 回退到之前的 commit，逐个验证，快速定位问题引入点。
# 查看当前状态
git status --short
git log --oneline -10
# 保存当前工作（包括未跟踪文件）
git stash push -m "stash: debug 问题" --include-untracked
# 查看最近提交历史
git log --oneline -10
选择要回退的目标 commit（通常是已知正常的版本）。
# 回退到指定 commit
git checkout <commit-hash>
# 清理依赖（关键！排除缓存干扰）
rm -rf node_modules .nuxt
# 杀掉残留进程
pkill -f "nuxt" || true
pnpm install && pnpm dev
让用户验证页面是否正常：
重复步骤 3-4，使用二分法快速缩小范围：
正常 ←——————————————————→ 白屏
↑
检查中间点
找到第一个出现问题的 commit 后：
# 查看该 commit 的具体改动
git show <commit-hash>
# 查看改动的文件列表
git show <commit-hash> --stat
# 查看具体改动内容
git show <commit-hash> --no-patch
根据改动内容分析可能的问题。重点检查该 commit 引入的新代码：
分析思路：
不要预设立场 - 白屏可能由多种原因导致，需要根据具体改动分析，而不是套用固定模式。
修复完成后，恢复之前 stash 的工作：
# 回到原分支
git checkout <branch-name>
# 恢复 stash
git stash pop
node_modules 和 .nuxt，排除缓存干扰定位到问题后，记录：
问题 commit: <hash>
问题文件: <file-path>
问题类型: <死循环/异步/生命周期/响应式/其他>
根本原因: <具体解释>
修复方案: <如何修复>