writing-planscommit 8ca22dbSKILL.md · 任务拆分

编写实现计划

把需求或规格写成面向陌生工程师的实现计划，拆成带文件、接口和测试的小任务。

npx skills add obra/superpowers --skill writing-plans

核心规则

每一步都必须让实现者只能写出一种合理的东西，既不留空白，也不替他把代码写完。

阶段 01检查范围
若规格涵盖多个独立子系统，建议按子系统拆成多份计划，每份都能产出可测试的软件。
阶段 02规划文件结构
先列出要新建或修改的文件及各自职责，按职责而非技术层拆分，并沿用现有代码库的模式。
阶段 03编写任务
按固定表头和任务模板写出每个任务的文件、接口和 TDD 步骤：写失败测试、运行、最小实现、再运行、提交。
阶段 04自我审查
对照规格检查覆盖度、步骤是否明确、类型是否一致、Review Focus 和篇幅比例，发现问题当场修正。
阶段 05交接执行
保存到 docs/superpowers/plans/ 后请用户审阅，并在 Subagent-driven 与 Native 两种执行方式中选择。

能力	是否需要	说明
文件写入	部分需要	只写计划文档，默认保存在 docs/superpowers/plans/，不修改代码。
命令执行	不需要	计划中会写明测试和提交命令，但本技能自身不执行。
网络外发	不需要	只依据本地规格和代码库编写，无需联网。

SKILL.md 头部信息（YAML）commit 8ca22db

---
name: writing-plans
description: Use when you have a spec or requirements for a multi-step task, before touching code
---