改了一行代码，两个服务炸了！我用 Claude Code Skill 写了个“防爆”工具

文章目录

• 🚨 那天的发布群消息
• 💡 被逼出来的想法
• ⚙️ 核心设计：让 AI 学会“多嘴”
• 🧠 真实对话：它在后台是怎么看我的代码的？
• 🛡️ 拦截与自动修复闭环
• ✅ 支持的“雷区”与技术栈清单
• 📦 如何安装使用（附 Git Hook 原理）
• 💬 写在最后

---

🚨 那天的发布群消息

“订单页用户信息展示不全了”
“客服系统查不到用户手机号”
“回滚吗还是热修复？”

事情发生在一场再普通不过的迭代。开发同学在 UserDTO 里删了一个字段——mobile，原因很简单：手机号要迁移到新的用户中心，这个字段不再用了。

改动就一行。CR过了，测试过了，上线了。然后群聊开始刷屏。查下来原因很直接：OrderService 和 CustomerService 都在调 user.getMobile()，DTO里字段一删，反序列化直接抛异常。

一行代码的改动，两个下游服务同时炸了。

这不是段子，这是我身边真实发生过的事。类似的场景每天都在无数团队里反复上演：

• API路径从 /api/order 改成了 /api/v2/order，前端没同步，线上 404
• 枚举加了一个新状态，下游的 switch 没覆盖，直接抛异常
• 数据库字段改了名，编译过了，存量查询全走偏

问题出在哪？不是改代码的人不仔细，也不是 CR 的人不负责。是人的注意力有极限。 一个 MR 几十个文件，reviewer 不可能一眼看出每行改动波及了多少引用方。

那段时间我一直在想：如果我改代码的时候，旁边有个人一直盯着屏幕，我刚敲完一行，他就说"哎，这行改了，那边 OrderService 会挂"——那该多好？

后来我意识到，这个人其实已经存在了——它就是 AI。我每天用 Claude Code 写代码，它看着我敲每一行，比任何人都清楚"这行改了谁会受影响"，因为它能扫描整个项目。

但问题是：Claude 默认不会主动告诉你。 它只管按照你的指令改代码，至于改了之后会不会炸掉别的地方——你不问，它不说。

所以我想：能不能把这个"不说"变成"主动说"？

---

💡 核心理念：让 AI 学会"多嘴"

Claude Code 有一个叫 Skill 的扩展机制（即自定义行为说明书）。我写了一个名为 business-conflict-analyzer 的 Skill。

它的核心流程分为 4 步：

1. 自动感知：读取 git diff，提取字段、方法、配置的增删改清单。
2. Diff Analyzer：识别哪些变更属于“破坏性变更”。
3. Impact Mapper：利用 grep 扫描全项目，结合 Git 历史，找到所有受影响引用方。
4. Report Generator：生成一份“业务语言”的影响分析报告，并主动追问决策。

它不会一条路走到黑，而是跑完流程后停下来等你拍板。

---

🧠 真实对话：它在后台是怎么看我的代码的？

在我测试的过程里，有一个改动让我印象特别深：我想把 UserDTO 里的 mobile 字段改为 phone，并调整 API 路径。

如果没有工具，这又是潜伏着无数颗雷的操作。但当 AI 感知到变更后，它直接生成了一个影响范围图谱：

上面这张图揭示了真相：仅仅改一个字段，直接牵连出了 10 个文件的变更点（包含 Java、Python、Go、TS、Vue，甚至数据库 DDL）。 并精确分级为 P0（编译失败/运行时异常）和 P1（兼容行为变化）。

而在另一个真实的项目里，当我想删除一个 ReverseEvaluation 实体中的 resultScore 字段时，它在终端的实际交互如下：

你看，它不是只给个结论，而是把底层 grep 的搜索过程、各个层的分析结果（SQL、后端、前端、Map 映射）全部罗列，然后抛出一个“采纳/拒绝/修改建议”的三选一交给我决策。

---

🛡️ 拦截与决策执行闭环

当检测到 P0 级（高危）变更时，我还在 git commit-msg 钩子里加了物理防线（Commit Guard），直接阻断提交，并开启闭环：

• 选择 【采纳】 ：AI 自动执行跨语言批量修复（如 Java 的 getMobile()→getPhone()，Python 的字典兼容读取，前端 Props 同步），修复完自动跑编译验证。
• 选择 【拒绝】 ：AI 执行 git checkout HEAD~1 自动回滚到安全状态，无残留。
• 选择 【修改建议】 ：AI 记录你的调整意图，调整方案后重新跑分析流程。

这不是告警，这是 “我已经分析完了，你来决策” 的完整闭环。

---

✅ 它能识别哪些雷区与技术栈？

自动感知（P0 级高危，无需指令）

• DTO/VO 字段增删改
• 接口方法签名变化
• Feign/RPC 接口、MQ 消息体结构变更
• 数据库 DDL 变更
• 核心配置文件增删改

按需建议（中低危，提示分析）

• 枚举值新增、废弃
• 核心业务逻辑重构（支付、退款、库存）
• 注解校验规则收紧

支持的技术栈

• 后端：Java/Spring、Python/Django/DRF/FastAPI/Flask、TypeScript/NestJS、Node.js/Express、Go、Kotlin/Ktor
• 前端：Vue (props/emit/store)、React (props/context/hooks)、JSP (taglib/include)
• 数据库：MySQL DDL 变更

---

📦 如何安装使用？（附 Git Hook 原理）

在终端中运行以下两条指令即可：

# 注册 Skill（让 Claude 学会这个能力）
claude add skill https://github.com/GoBeyondYang/skills/raw/main/skills/business-conflict-analyzer/SKILL.md

# 安装 Commit Guard（推荐必装，拦截拦截提交）
bash skills/business-conflict-analyzer/scripts/install_hook.sh

附：Commit Guard 的 Git Hook 实现原理：
作为一个程序员，你可以直接看这个钩子的伪逻辑（这也是我特别喜欢这个设计的地方）：

# .git/hooks/commit-msg
#!/bin/sh

# 1. 提取当前变更
git diff --cached --name-only > /tmp/changed_files

# 2. 调用分析流水线（如果变更涉及高危文件）
python skills/business-conflict-analyzer/scripts/diff_analyzer.py

# 3. 如果产生 P0 级别报告
if [ -f "conflict-report.md" ] && grep -q "P0" "conflict-report.md"; then
    echo "⚠️ 阻断提交！发现 P0 破坏性变更！"
    cat conflict-report.md
    exit 1  # 阻塞 Git 提交
fi

详细使用文档和配置说明，都在 GitHub 上：
👉 https://github.com/GoBeyondYang/skills