点击上方卡片关注我

设置星标 学习更多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编程出海训练营!

图片

炸裂!Anthropic 又杀疯了!

从海外公司注册到 Stripe 收款,跑通了出海收付款全流程(实操分享)

出海建站必备:告别AI味,这两个页面设计 Skills 太牛了!

玩转 Claude Code Hooks:让自动化渗透到每个环节

出海工具全集:覆盖 9 大类别,收藏这一篇就够了

出海网站实战:Stripe 支付接入,从 0 到收款全流程

出海必备:一天搞定5张港卡,我的香港卡办理全攻略

彭涛:从百万自媒体到 AI 编程出海,我的 2025 破局与重生

Logo

小龙虾开发者社区是 CSDN 旗下专注 OpenClaw 生态的官方阵地,聚焦技能开发、插件实践与部署教程,为开发者提供可直接落地的方案、工具与交流平台,助力高效构建与落地 AI 应用

更多推荐