别再被 Claude 乱改代码了,给它加个“架构师”开关!
在咱们做项目的时候,最忌讳的就是“快中出错”。不管是调 Stripe 的接口,还是处理复杂的时区逻辑,AI 拍脑袋给出的代码,一旦跑偏了,就需要花好几倍的时间去定位和回退,这种隐形成本非常高。它让 AI 变成了一个“凡事有交代、件件有方案”的靠谱助手,这种可预测的开发体验,才是高效工作的核心。开发者最值钱的不是打字速度,而是解决问题的思路,这套 Skill 强迫你从琐碎的语法中抽离出来,去审视系统
点击上方卡片关注我
设置星标 学习更多AI出海知识
最近在迭代一个出海产品的核心支付模块,代码里嵌套着复杂的 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: plan
description: 强制 AI 在修改代码前提交实施方案,未经确认禁止执行写入操作。
---
# 指令规范
当用户要求进行代码重构、功能开发或复杂逻辑变更时,必须遵循以下流程:
1. **禁止直接写入**:在方案获准前,严禁调用任何文件写入工具。
2. **生成 [Implementation Plan]**:
- 明确受影响的文件路径及变更范围。
- 详细描述核心逻辑的调整逻辑。
- 将复杂任务拆解为原子化的 Step 1, Step 2...
3. **设置确认阈值**:输出方案后,必须停顿并询问“方案是否可行?输入‘LFG’开始执行第一步”。
代码的模块化重构
为了验证该工作流的严谨性,我们以一个基础的 CommonJS 模块重构为例。
1. 初始状态 (Before)
创建一个简单的 user.js,其逻辑相对松散:
let users = [];
function add(name) {
users.push({ id: Date.now(), name });
}
function getAll() { 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 就是把那种“拍脑袋就干”的实习生,强行变成了一个“凡事有交待、件件有方案”的靠谱助手。这种掌控感,才是咱们独立开发者最需要的。
代码改得快不厉害,一次性改对、改稳才叫真厉害。
欢迎关注,这个账号还会持续分享更多出海工具、实战经验、踩坑记录。
扫码或微信搜索 257735 添加微信,回复【出海资料】即可免费领取《AI 编程出海资料》,一次读懂普通人也能启动的出海路径。
如果你想进一步系统学习、实操出海项目,👉 点击了解详情:推荐我的AI编程出海训练营!

从海外公司注册到 Stripe 收款,跑通了出海收付款全流程(实操分享)
出海建站必备:告别AI味,这两个页面设计 Skills 太牛了!
更多推荐



所有评论(0)