Menu
从 Spec 技术规格文档生成分步实施计划（Plan），包含执行记忆存储和 git commit 策略。当用户要求"写 plan"、"生成实施计划"、"spec 转 plan"、"帮我拆分实现步骤"时触发。
Installer avec Codex ou Claude Copiez ce prompt, collez-le dans Codex, Claude ou un autre assistant, puis laissez-le vérifier la page du skill et l'installer pour vous.
Basé sur la classification professionnelle SOC
| name | write-plan |
| description | 从 Spec 技术规格文档生成分步实施计划（Plan），包含执行记忆存储和 git commit 策略。当用户要求"写 plan"、"生成实施计划"、"spec 转 plan"、"帮我拆分实现步骤"时触发。 |
| allowed-tools | Read(*), Bash(git:*, ls:*, find:*, cat:*, head:*, tail:*, test:*), Write(*), Edit(*), Glob(*) |
| metadata | {"author":"tangjiahui","version":"1.0.0"} |
从 Spec 文档生成结构化的分步实施计划，输出到 .claude/tmp/plan/。每步可独立验证、可 git 回滚、可中断续接。
当用户提到以下内容时调用此 skill：
开始执行前，必须确认 Spec 文件存在：
ls .claude/tmp/spec/*.md 2>/dev/null
❌ 错误：Spec 文件不存在（.claude/tmp/spec/ 目录下无 .md 文件）。
请先执行以下命令生成 Spec：
「帮我写 spec：<你的需求>」
或手动运行 write-spec skill 生成技术规格文档。
如果有多个 Spec，让用户选择目标 Spec。如果只有一个，直接使用。
读取 Spec 文档，提取关键信息：
确认当前工作区干净，避免计划执行时的冲突：
git status --porcelain
如果有未提交的修改，警告用户并建议先处理。
按 spec 中的「实现步骤」章节，细化为可独立执行和验证的步骤。每个步骤需满足：
git revert 单步回滚Plan 文件名与 Spec 文件名保持一致，输出两个文件到 .claude/tmp/plan/：
.claude/tmp/plan/
├── <name>.md # 实施计划文档（与 spec 同名）
└── <name>.state.json # 执行状态追踪
示例（spec 为 drag-clamp-to-canvas-boundary.md）：
.claude/tmp/spec/drag-clamp-to-canvas-boundary.md
.claude/tmp/plan/drag-clamp-to-canvas-boundary.md
.claude/tmp/plan/drag-clamp-to-canvas-boundary.state.json
# [计划标题]
> Spec: [spec 文件路径] | 创建时间: YYYY-MM-DD | 总步骤: N
## 前置准备
- [x] 工作区干净 (`git status` 无未提交内容)
- [ ] Spec 已确认
- [ ] 依赖已安装 (`pnpm install`)
## 执行步骤
### Step 1: [步骤名称]
- **文件**：`src/xxx.ts`
- **操作**：[新增/修改] — 具体改动描述
- **验证**：如何确认这一步做对了
- **依赖**：无 / Step N
### Step 2: [步骤名称]
- **文件**：`src/yyy.ts`
- **操作**：[新增/修改] — 具体改动描述
- **验证**：如何确认这一步做对了
- **依赖**：Step 1
### Test Step: 编写并运行单元测试
- **文件**：`src/**/__tests__/*.test.ts`（依据 spec 中的「单元测试」章节）
- **操作**：新增 — 为 P0/P1 功能点编写单元测试
- **验证**：`pnpm vitest run` 全部通过
- **前置条件**：如项目未安装 Vitest，在「前置准备」中安排安装
- **依赖**：所有功能实现步骤完成后执行
{
"plan": "<name>",
"spec": ".claude/tmp/spec/<name>.md",
"planFile": ".claude/tmp/plan/<name>.md",
"stateFile": ".claude/tmp/plan/<name>.state.json",
"createdAt": "2026-07-20T10:00:00",
"updatedAt": "2026-07-20T10:30:00",
"branch": "feat/<name>",
"steps": [
{
"id": 1,
"name": "Step 1: xxx",
"status": "completed",
"commitHash": "abc1234",
"completedAt": "2026-07-20T10:10:00"
},
{
"id": 2,
"name": "Step 2: xxx",
"status": "in_progress",
"commitHash": null,
"completedAt": null
},
{
"id": 3,
"name": "Step 3: xxx",
"status": "pending",
"commitHash": null,
"completedAt": null
}
],
"completedAt": null
}
状态取值：
pending — 未开始in_progress — 执行中（中断后从此步恢复）completed — 已完成（含 git commit）skipped — 已跳过failed — 执行失败（需人工介入）生成 plan 时必须包含以下约定：
## 执行约定
### Git 策略
1. 开始前创建新分支 `feat/<name>`（基于当前分支）
2. 每完成一个 Step（含 Test Step），执行：
```bash
git add <涉及文件>
git commit -m "feat: <步骤名称>"
"test: <模块名> 单元测试"git reset --hard <上一Step的commitHash> 丢弃之后所有 commitgit checkout master && git merge --no-ff plan/<name>
### 中断续接
```markdown
### 中断续接
1. 读取 `.claude/tmp/plan/<name>.state.json`
2. 找到第一个 `status: "in_progress"` 或 `status: "pending"` 的步骤
3. 检查 git 状态：如果该步骤的 `commitHash` 非空，说明已完成；如果为空，需要重新执行
4. 从中断步骤继续执行，完成后更新 state.json
用户说「按 plan 执行」→ 读取 plan.md 和 state.json → 从第一个 pending 步骤开始执行 → 每步完成后更新 state.json + git commit
用户说「继续执行 plan」→ 读取 state.json → 从 in_progress 或第一个 pending 步骤恢复 → 继续执行
用户说「回滚到 Step N」→ git reset --hard <Step N-1的commitHash> → 更新 state.json 中 Step N 及之后的状态为 pending
test: 而非 feat:pnpm add -D vitest @testing-library/react @testing-library/jest-dom jsdom
按 Plan 文档逐步执行代码改动，每步自动 lint、git commit 并更新执行状态，支持中断续接和单步回滚。当用户要求"执行 plan"、"按计划实施"、"开始写代码"时触发。
全自动需求→实现流水线编排。串联 write-spec → refine-spec → write-plan → execute-plan → 验收，每阶段设置确认门，支持中断恢复。当用户要求"全自动实现"、"一键开发"、"按需求交付"时触发。
循环向用户提问，持续收集补充意见来打磨 Spec 文档，直到用户明确确认全部 OK 才停止并输出完整结果。当用户要求"完善 spec"、"补充需求"、"评审 spec"、"继续细化"时触发。
分析项目代码结构，生成一份 CLAUDE.md 项目架构文档，包含技术栈、目录结构、入口文件、架构模式和配置说明。当用户要求"生成 CLAUDE.md"、"写项目文档"、"分析项目架构"、"初始化项目上下文"时触发。
将用户需求与 CLAUDE.md 项目架构上下文结合，生成一份结构化的 Spec 技术规格文档。当用户要求"写 spec"、"生成规格文档"、"需求转技术方案"、"帮我设计实现方案"时触发。