别再被 Claude 乱改代码了,给它加个“架构师”开关!

点击上方卡片关注我

最近在迭代一个出海产品的核心支付模块，代码里嵌套着复杂的 Stripe 回调和计费逻辑。

对着 Claude 下达了一个指令：“帮我重构一下这个文件的错误处理部分。”

本以为它会像往常一样精准，结果几秒钟后，它直接触发了 fs_write，反手将几百行的 payment.ts 彻底重写。

我又不得不一边翻 Git 历史执行 git checkout。

后来想到可以通过配置 Claude Skill，强制 AI 在动手前执行“方案评审”流程，将其角色从“代码生成器”转变为严谨的“技术方案执行者”。

从“直接写入”到“方案先行”

在传统的 AI 编程流中，指令下达与代码写入之间缺乏缓冲。引入 Plan Skill 的目的，是利用 Claude Code 的插件机制，在执行敏感操作前插入一个人工确认点。

该 Skill 衍生自 GitHub 知名开源项目 superpowers。它定义了一套规范化的工程路径，确保 AI 的每一步操作都具备可追溯性和可预测性。

部署 Plan 技能包

该 Skill 不需要编写复杂的脚本，只需在 Claude 的全局配置目录中定义一套行为准则（SKILL.md）。

1. 创建目录结构

mkdir -p ~/.claude/skills/plan

2. 定义规则文件在 ~/.claude/skills/plan/SKILL.md 中写入以下配置。这套规则会在 Claude 启动时自动加载：

---name: plandescription: 强制 AI 在修改代码前提交实施方案，未经确认禁止执行写入操作。---# 指令规范当用户要求进行代码重构、功能开发或复杂逻辑变更时，必须遵循以下流程：1. **禁止直接写入**：在方案获准前，严禁调用任何文件写入工具。2. **生成 [Implementation Plan]**：   - 明确受影响的文件路径及变更范围。   - 详细描述核心逻辑的调整逻辑。   - 将复杂任务拆解为原子化的 Step 1, Step 2...3. **设置确认阈值**：输出方案后，必须停顿并询问“方案是否可行？输入‘LFG’开始执行第一步”。

代码的模块化重构

为了验证该工作流的严谨性，我们以一个基础的 CommonJS 模块重构为例。

1. 初始状态 (Before)

创建一个简单的 user.js，其逻辑相对松散：

let users = [];functionadd(name) {    users.push({ id: Date.now(), name });}functiongetAll() { return users; }module.exports = { add, getAll };

2. 下达重构任务

启动 claude 并输入指令：

“

“分析 user.js，将其重构为 ESM 规范的单例类 UserManager，并增加根据 ID 删除用户的功能。先提交 Plan。”

3. AI 的方案反馈

在加载了 Plan Skill 后，Claude 不会直接改动源码，而是会输出一份结构化的设计文档：

Claude 的反馈要点：

• 架构选型：将 module.exports 迁移至 export，使用私有类属性存储数据。
• 变更路径：先定义类结构，再迁移方法，最后补齐删除逻辑。
• 确认请求：方案已就绪，等待开发者输入 LFG 指令。

4. 确认与执行

开发者审核方案无误后输入 LFG，AI 才会启动写入流程。这种“先看方案再审代码”的模式，将重构风险降低了 80% 以上。

为什么这套工作流对开发者至关重要？

看完上面的实操，可能会觉得：这不就是多了一道手续吗？但如果你真的在维护一个正式项目，这几秒钟的“方案确认”能帮你省掉几个小时的复机时间。

1. 守住代码逻辑的“底线”

很多时候，AI 会为了完成一个局部功能，改动你的全局变量或底层结构。有了 Plan，你可以在它动手前一眼看出它的逻辑是否有损，尤其是涉及支付、权限等核心模块时，这种“先看方案再改代码”的操作，是防止项目崩溃的最后一道防线。

2. 拒绝无效的 Token 浪费

AI 乱写一通不仅耽误时间，每一行废话都在消耗你的 API 额度。先审阅几十个字符的 Plan，确认没问题再让它去写几百行的代码，这种“以小博大”的确认机制，能让你的 AI 使用成本大幅下降。

3. 从“肉搏代码”转向“逻辑审计”

开发者最值钱的不是打字速度，而是解决问题的思路，这套 Skill 强迫你从琐碎的语法中抽离出来，去审视系统的整体架构。当你在终端输入 LFG 的那一刻，你不再是一个帮 AI 擦屁股的码农，而是一个掌控全局的系统架构师。

4. 建立标准化的“数字雇员”规矩

不管你是个人开发者，还是带小团队，这套 Skill 实际上是在建立一套可复用的工程标准。它让 AI 变成了一个“凡事有交代、件件有方案”的靠谱助手，这种可预测的开发体验，才是高效工作的核心。

总结

最后实践下来，也能发现 /write-plan 并不是什么高深莫测的黑科技，它更像是一种“防呆机制”。

在咱们做项目的时候，最忌讳的就是“快中出错”。不管是调 Stripe 的接口，还是处理复杂的时区逻辑，AI 拍脑袋给出的代码，一旦跑偏了，就需要花好几倍的时间去定位和回退，这种隐形成本非常高。

我一直觉得，用 AI 编程不代表我们要把大脑完全交给它；相反，我们要学会给它立规矩。

这个 Skill 就是把那种“拍脑袋就干”的实习生，强行变成了一个“凡事有交待、件件有方案”的靠谱助手。这种掌控感，才是咱们独立开发者最需要的。

代码改得快不厉害，一次性改对、改稳才叫真厉害。