让AI先写计划再动手！这个技能让代码从”自由发挥”变成”步步为营”

你有没有这种感觉——让AI写代码，它噼里啪啦一顿输出，你一看，方向全歪了？

不是AI不行，是你没给它上一个好课。

writing-plans 就是来解决这个问题的。

这是 Superpowers 技能套件里的核心技能之一，由开发者 Jesse Vincent（obra）打造。Superpowers 整个项目在 GitHub 上已经突破 34k Star，是目前最火的 AI 编程工作流框架之一。它解决的核心问题是：AI 写代码太快，但写之前”想清楚”这一步，几乎没人管。

它到底干了什么

简单说，writing-plans 在你动手之前，强制让 AI 先写出完整的实施计划——不是简单说”我要做什么”，而是把每个任务拆到 2~5 分钟的颗粒度，精确到要改哪个文件的哪几行、先写什么测试、怎么验证。

它要求 AI 在计划文档里写清楚：

• 文件结构：哪些文件要新建、哪些要改，改了之后各自负责什么
• 任务边界：每个任务必须有独立可测试的交付物，不能糊在一起
• 接口契约：任务之间怎么通信？函数签名是什么？参数类型是什么？
• 测试策略：先写失败的测试，再写代码让它通过——TDD 流程直接内嵌

所有计划文件统一保存到 docs/superpowers/plans/YYYY-MM-DD-<feature-name>.md，团队里谁都能看、谁都能review。

为什么有效

传统的”AI写代码”流程里，AI拿到需求就开始敲，敲完你一看，满屏都是坑。

writing-plans 把这个流程倒过来了：想清楚再动手。每个任务有清晰的验收标准，AI必须先说服你”这个任务完成了”，才能进入下一个。这其实就是软件工程里”任务拆分”的老道理——只不过现在 AI 在帮你执行，而且它不会偷懒。

适用场景

• 团队多人协作：计划文档就是沟通语言，PM、设计、后端都能review
• 复杂功能开发：拆解成小任务后，AI不会中途迷失方向
• 代码审查：reviewer 直接对照计划文档检查，不用猜 AI 为什么这么写
• 新人 onboarding：计划文档里写清楚了”这个项目用什么规范、什么约定”，新人不需要从零摸索

怎么安装

Superpowers 官方支持 Claude Code 插件市场：

# 注册插件市场源
/plugin marketplace add obra/superpowers-marketplace

# 安装 Superpowers 技能套件
/plugin install superpowers@superpowers-marketplace

# 验证安装
/help
# 预期看到: /superpowers:brainstorm, /superpowers:write-plan 等命令

也可以通过 skills.sh 安装，或者手动克隆仓库到本地。

写在最后

用 AI 写代码最常见的悲剧：让它写，它写得飞快；你一看，全是废话。

writing-plans 强制 AI 先做规划再动手，本质上是把软件工程里”先设计再实现”的老规矩，用技能的形式固化下来。AI 跑得快不再是问题——只要方向对。

GitHub：https://github.com/obra/superpowers

GitHub: https://github.com/obra/superpowers/tree/main/skills/writing-plans