安装方式
手动下载安装
下载 ZIP 后解压到技能目录即可安装。若在桌面客户端 WebView中直接下载出现异常，本站会改为提示页 + 原始链接，请按页内说明操作。
下载 ZIP (oss-superpowers-writing-plans-v1.0.0.zip)触发指令
/writing-plans
跨平台安装指引
该技能声明兼容以下 1 个平台，将 ZIP 解压到对应目录即可被识别。
unzip oss-superpowers-writing-plans-v1.0.0.zip -d ~/.claude/skills/
mkdir -p 创建；启用 Skill 后请重启对应 Agent 让配置生效。
使用指南
撰写实现计划
把规格变成 可执行计划：假设执行者 零本仓库上下文、测试设计一般，因此要把 文件路径、代码片段、命令、期望输出 都写清。任务拆到 几分钟一步。DRY、YAGNI、TDD、小步提交。
开场宣告：「我正使用 writing-plans 技能来编写实现计划。」
上下文： 宜在 brainstorming 创建的 独立 worktree 里写计划。
保存路径： docs/superpowers/plans/YYYY-MM-DD-<feature>.md（用户另有规定从其规定）。
范围检查
若规格含多个 独立子系统，应在头脑风暴阶段已拆成多份规格；若未拆，建议 一子系统一计划，每份计划都能单独交付可测软件。
文件结构（先于任务列表）
先规划 将创建/修改哪些文件、各文件职责。边界清晰、接口明确；单文件单责；一起变的文件放近；存量仓库跟现有风格；若正在改的文件已臃肿，可在计划里包含合理拆分。
任务粒度
每步是 一个动作（约 2–5 分钟）：写失败测试、跑红、写最简实现、跑绿、提交——各算一步。
计划文件头（必须）
# [功能名] 实现计划
> **给代理执行者：** 必须子技能：superpowers:subagent-driven-development（推荐）或 superpowers:executing-plans。步骤用 `- [ ]` 勾选跟踪。
**目标：** 一句话说明交付什么
**架构：** 2–3 句说明做法
**技术栈：** 关键语言/库
---
任务块结构
每任务含：Files（创建/修改/测试路径，修改可写到行号）、若干 - [ ] 步骤；每步含 具体代码或具体命令 与 期望输出（FAIL 信息 / PASS）。最后一步常是 commit 示例。
禁止占位
以下视为 计划不合格：TBD、TODO、稍后实现、「加适当错误处理」却不写清、不写具体测试代码的「写测试」、写「同任务 N」却不重复贴代码（执行者可能跳着读）、只描述不写代码块等。
牢记
路径精确、有代码的步骤必贴代码、命令带期望输出、DRY+YAGNI+TDD+勤提交。
自检
- 规格每段是否都能指到某个任务？
- 搜一遍占位红线词。
- 前后任务里类型名、方法名是否一致？
有问题当场改；缺任务就补任务。
交接执行
计划保存后问用户：
「计划已保存到 docs/superpowers/plans/<文件>。执行方式二选一：
- 子代理驱动（推荐） — 每任务新子代理，任务间评审，迭代快
- 本会话执行 — 用 executing-plans 分批带检查点
选哪种？」
- 选 1 → 必须 subagent-driven-development
- 选 2 → 必须 executing-plans
<!-- zh-only -->
# 撰写实现计划
把规格变成 **可执行计划**：假设执行者 **零本仓库上下文**、测试设计一般，因此要把 **文件路径、代码片段、命令、期望输出** 都写清。任务拆到 **几分钟一步**。DRY、YAGNI、TDD、小步提交。
**开场宣告：**「我正使用 writing-plans 技能来编写实现计划。」
**上下文：** 宜在 brainstorming 创建的 **独立 worktree** 里写计划。
**保存路径：** `docs/superpowers/plans/YYYY-MM-DD-<feature>.md`（用户另有规定从其规定）。
## 范围检查
若规格含多个 **独立子系统**，应在头脑风暴阶段已拆成多份规格；若未拆，建议 **一子系统一计划**，每份计划都能单独交付可测软件。
## 文件结构（先于任务列表）
先规划 **将创建/修改哪些文件**、各文件职责。边界清晰、接口明确；单文件单责；**一起变的文件放近**；存量仓库跟现有风格；若正在改的文件已臃肿，可在计划里包含合理拆分。
## 任务粒度
每步是 **一个动作**（约 2–5 分钟）：写失败测试、跑红、写最简实现、跑绿、提交——各算一步。
## 计划文件头（必须）
```markdown
# [功能名] 实现计划
> **给代理执行者：** 必须子技能：superpowers:subagent-driven-development（推荐）或 superpowers:executing-plans。步骤用 `- [ ]` 勾选跟踪。
**目标：** 一句话说明交付什么
**架构：** 2–3 句说明做法
**技术栈：** 关键语言/库
---
```
## 任务块结构
每任务含：**Files**（创建/修改/测试路径，修改可写到行号）、若干 `- [ ]` 步骤；每步含 **具体代码或具体命令** 与 **期望输出**（FAIL 信息 / PASS）。最后一步常是 **commit** 示例。
## 禁止占位
以下视为 **计划不合格**：TBD、TODO、稍后实现、「加适当错误处理」却不写清、不写具体测试代码的「写测试」、写「同任务 N」却不重复贴代码（执行者可能跳着读）、只描述不写代码块等。
## 牢记
路径精确、有代码的步骤必贴代码、命令带期望输出、DRY+YAGNI+TDD+勤提交。
## 自检
1. 规格每段是否都能指到某个任务？
2. 搜一遍占位红线词。
3. 前后任务里类型名、方法名是否一致？
有问题当场改；缺任务就补任务。
## 交接执行
计划保存后问用户：
「计划已保存到 `docs/superpowers/plans/<文件>`。执行方式二选一：
1. **子代理驱动（推荐）** — 每任务新子代理，任务间评审，迭代快
2. **本会话执行** — 用 executing-plans 分批带检查点
选哪种？」
- 选 1 → **必须** subagent-driven-development
- 选 2 → **必须** executing-plans