Skip to content

让 AI 动手前先想清楚:create-plan 一键生成可执行编码计划

直接让 AI 开始改代码,结果改了一堆但方向不对——create-plan 技能解决这个问题。它让 AI 在动手前快速扫描代码库、理解约束,然后生成一份包含范围界定、原子化行动项和开放问题的简洁计划,你确认后再执行,方向不偏、步骤清晰。

这个技能解决什么问题

AI 开始写代码前,很容易跳过"想清楚"这一步:

  • 直接开改,写到一半发现方向不对
  • 没搞清楚范围,改了不该改的文件
  • 没识别约束条件(测试框架、部署要求),写出来的代码跑不了
  • 你不清楚 AI 打算怎么做,等出来结果才发现理解偏了

create-plan 在 AI 动手之前强制插入一个"计划"步骤:AI 只读不写地快速扫描上下文,生成一份有结构的计划交给你确认,再进入实现。

这个技能和 spec-driven-development(写详细 Spec 文档)不同——它是轻量级的,适合快速规划,不适合产品级需求文档。和 to-issues(拆成 Issue)也不同——它的产出是一次会话里的执行清单,不是 Issue tracker 条目。

什么时候用

  • 你描述了一个编码任务,想在 AI 动手前先看它的计划
  • 任务稍复杂,你担心 AI 会跑偏或改错地方
  • 你想快速整理自己的思路,让 AI 帮你发现漏掉的步骤
  • 结对编程,想先和 AI 对齐方向再分工

明确说"给我一个计划"即可触发:

帮我生成一个计划:把项目的身份验证从 JWT 迁移到 Session Cookie
create-plan:在用户配置页面添加头像上传功能

计划输出的结构

每次生成的计划都遵循固定模板,方便你快速阅读和确认:

markdown
# 计划

<1-3 句话:做什么、为什么、高层次方案。>

## 范围
- 在范围内:
- 不在范围内:

## 行动项
[ ] 步骤 1
[ ] 步骤 2
[ ] 步骤 3
...

## 开放问题
- 问题 1(如有)

范围界定是这个结构里最有价值的部分:明确说"不在范围内",能帮你发现 AI 是否理解你的意图,也能避免 AI 越界修改。

行动项按照「发现 → 修改 → 测试 → 发布」顺序排列,动词开头("添加…"、"重构…"、"验证…"),每项都指向具体文件或命令,不写模糊的"处理后端"。

容易忽略的事

这个技能只读不写。AI 在制定计划阶段不会修改任何文件。如果你看到它开始写代码,说明计划模式没有正确触发。

行动项默认 6-10 个。太少意味着遗漏了步骤,太多则说明任务太大需要先拆分。如果计划超过 15 项,考虑先用 to-issues 把任务拆小。

开放问题不是必须回答的。AI 最多问 2 个问题,只在真正无法规划时才问——大多数时候它会做合理假设直接给计划,你再调整。

计划是给你确认的。生成计划不等于开始执行,你看完确认没问题后再让 AI 按计划动手。

下载和安装

下载 create-plan 中文版 Skill ZIP

解压后将 create-plan/ 目录放入你的 AI 编辑器技能目录(Claude Code 用 ~/.claude/skills/,Codex 用 ~/.codex/skills/),然后在任务描述中说"帮我制定一个计划"即可触发。

你可能还需要

先规划,再执行

同分类技能