Appearance
让 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 Cookiecreate-plan:在用户配置页面添加头像上传功能计划输出的结构
每次生成的计划都遵循固定模板,方便你快速阅读和确认:
markdown
# 计划
<1-3 句话:做什么、为什么、高层次方案。>
## 范围
- 在范围内:
- 不在范围内:
## 行动项
[ ] 步骤 1
[ ] 步骤 2
[ ] 步骤 3
...
## 开放问题
- 问题 1(如有)范围界定是这个结构里最有价值的部分:明确说"不在范围内",能帮你发现 AI 是否理解你的意图,也能避免 AI 越界修改。
行动项按照「发现 → 修改 → 测试 → 发布」顺序排列,动词开头("添加…"、"重构…"、"验证…"),每项都指向具体文件或命令,不写模糊的"处理后端"。
容易忽略的事
这个技能只读不写。AI 在制定计划阶段不会修改任何文件。如果你看到它开始写代码,说明计划模式没有正确触发。
行动项默认 6-10 个。太少意味着遗漏了步骤,太多则说明任务太大需要先拆分。如果计划超过 15 项,考虑先用 to-issues 把任务拆小。
开放问题不是必须回答的。AI 最多问 2 个问题,只在真正无法规划时才问——大多数时候它会做合理假设直接给计划,你再调整。
计划是给你确认的。生成计划不等于开始执行,你看完确认没问题后再让 AI 按计划动手。
下载和安装
解压后将 create-plan/ 目录放入你的 AI 编辑器技能目录(Claude Code 用 ~/.claude/skills/,Codex 用 ~/.codex/skills/),然后在任务描述中说"帮我制定一个计划"即可触发。
你可能还需要
先规划,再执行
- 需求澄清到 Spec 文档:spec-driven-development 怎么用 — 需要写详细 Spec 文档时用
- 拆成可执行 Issue:to-issues 怎么用 — 计划规模更大,需要进 Issue tracker 时用
- 任务拆解:task-breakdown 怎么用 — 把大任务拆成小任务的更完整技能
同分类技能