菜单
按 Plan 文档逐步执行代码改动，每步自动 lint、git commit 并更新执行状态，支持中断续接和单步回滚。当用户要求"执行 plan"、"按计划实施"、"开始写代码"时触发。
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
基于 SOC 职业分类
全自动需求→实现流水线编排。串联 write-spec → refine-spec → write-plan → execute-plan → 验收，每阶段设置确认门，支持中断恢复。当用户要求"全自动实现"、"一键开发"、"按需求交付"时触发。
循环向用户提问，持续收集补充意见来打磨 Spec 文档，直到用户明确确认全部 OK 才停止并输出完整结果。当用户要求"完善 spec"、"补充需求"、"评审 spec"、"继续细化"时触发。
从 Spec 技术规格文档生成分步实施计划（Plan），包含执行记忆存储和 git commit 策略。当用户要求"写 plan"、"生成实施计划"、"spec 转 plan"、"帮我拆分实现步骤"时触发。
分析项目代码结构，生成一份 CLAUDE.md 项目架构文档，包含技术栈、目录结构、入口文件、架构模式和配置说明。当用户要求"生成 CLAUDE.md"、"写项目文档"、"分析项目架构"、"初始化项目上下文"时触发。
将用户需求与 CLAUDE.md 项目架构上下文结合，生成一份结构化的 Spec 技术规格文档。当用户要求"写 spec"、"生成规格文档"、"需求转技术方案"、"帮我设计实现方案"时触发。
| name | execute-plan |
| description | 按 Plan 文档逐步执行代码改动，每步自动 lint、git commit 并更新执行状态，支持中断续接和单步回滚。当用户要求"执行 plan"、"按计划实施"、"开始写代码"时触发。 |
| allowed-tools | Read(*), Write(*), Edit(*), Bash(git:*, pnpm:*, ls:*, cat:*, test:*), Glob(*) |
| metadata | {"author":"tangjiahui","version":"1.0.0"} |
按 Plan 文档的分步计划逐步执行代码改动，每步完成后自动 lint + git commit，支持中断续接和回滚。
ls .claude/tmp/plan/*.state.json 2>/dev/null
❌ 错误：Plan 文件不存在（.claude/tmp/plan/ 目录下无 .state.json 文件）。
请先用 write-plan 生成实施计划：
「帮我写 plan：<spec 文件>」
读 plan.md + state.json
→ 找到第一个 pending/in_progress 步骤
→ git checkout feat/<plan-name>（首次则创建）
→ 按 plan 中的代码 diff 执行 Edit 改动
→ pnpm lint --fix（如果配置了）
→ ✅ 通过 → git add + commit（"feat: <步骤名称>"）
→ ❌ 失败 → 尝试修复，不行则暂停等人工
→ 更新 state.json（status + commitHash）
→ 继续下一步
→ 全部完成 → 输出摘要
Step N 执行:
1. 更新 state.json: status → "in_progress"
2. 读取 plan.md 中 Step N 的「改动内容」
3. 用 Edit 工具精确修改目标文件
4. 运行 lint: pnpm lint --fix（如果有 lint script）
- lint 失败 → 根据错误信息自动修复，最多重试 2 次
- 2 次仍失败 → status → "failed"，暂停，等用户介入
5. git add <涉及文件>
6. git commit -m "feat: <步骤名称>"
7. 更新 state.json: status → "completed", commitHash → 实际 hash
8. 输出: "✅ Step N 完成 (commit: abc1234) — <步骤名称>"
重新进入 execute-plan 时:
1. 读 state.json
2. 找 status = "in_progress" 的步骤
- 存在 → 检查 commitHash 是否为空
- 非空 → 已完成，标记为 completed，继续下一步
- 为空 → 重新执行（上次中断在代码改动阶段）
3. 找第一个 status = "pending" 的步骤 → 从此开始
4. 全部 completed → 输出"全部步骤已执行完毕"
回滚 Step N:
1. 读 state.json，获取该步骤的 commitHash
2. git revert <commitHash> --no-edit
3. 状态更新: status → "pending", commitHash → null
4. 输出: "↩ Step N 已回滚，状态重置为 pending"
| 场景 | 处理方式 |
|---|---|
| lint 报错 | 自动分析错误原因，用 Edit 修复，重试 2 次 |
| 修复失败 | 标记 status="failed"，输出具体错误信息，暂停等用户 |
| git 冲突 | 暂停，提示用户手动解决后继续 |
| 文件已被修改 | 输出 git diff 差异，询问是否覆盖/合并/跳过 |
| 构建失败 | 与 lint 相同，尝试自动修复 |
全部步骤完成后输出：
## 执行完毕
Plan: <plan-name>
分支: feat/<plan-name>
| Step | 名称 | Commit | 状态 |
|------|------|--------|------|
| 1 | xxx | abc1234 | ✅ |
| 2 | xxx | def5678 | ✅ |
| 3 | xxx | ghi9012 | ✅ |
### 下一步
- 验收：pnpm dev 启动，手动验证功能
- 合并：git checkout master && git merge --no-ff feat/<plan-name>
- 回滚全部：git reset --hard $(git merge-base master feat/<plan-name>)