用途
writing-plans 是一个实施计划编写技能,用在已经拿到多步骤任务的规格说明或需求、但还没有开始改代码的时候。它的目标是写出一份完整的实施计划,假设执行计划的工程师对当前代码库毫无上下文,但对工具集和问题领域相当陌生,且不擅长测试设计。计划需要记录对方需要知道的一切:每个任务涉及哪些文件、代码、测试、需要查阅的文档以及如何测试。
主要能力
- 范围检查:如果规格覆盖多个独立子系统,建议拆分成多个计划,每个子系统一份,每份计划应能独立产出可运行、可测试的软件。
- 文件结构规划:在定义任务前先梳理将创建或修改的文件及各自职责,按职责而非技术分层拆分,文件应小而聚焦;在已有代码库中遵循既有模式,仅在文件过大时在计划中包含拆分。
- 任务粒度控制:任务是自带测试周期、值得独立评审的最小单元,将搭建、配置、脚手架、文档步骤并入需要它们的任务;每个步骤是一个2-5分钟的动作,例如“写失败的测试”“运行确认失败”“写最小实现”“运行确认通过”“提交”。
- 计划文档头部:必须包含功能名、面向代理执行者的子技能提示、目标、架构、技术栈与全局约束(版本下限、依赖限制、命名与文案规则、平台要求,逐条照抄规格中的精确值)。
- 任务结构:每个任务列出创建/修改/测试的精确文件路径,以及 Interfaces 块(Consumes 与 Produces,含精确函数名、参数与返回类型),并提供带复选框语法的步骤与代码块。
- 禁止占位符:不得写 TBD、TODO、稍后实现、补充细节、“添加适当的错误处理”“为上述内容写测试”(无实际测试代码)、“类似任务 N”(需重复代码)等。
- 自查:写完后对照规格检查覆盖度、扫描占位符、核对前后任务的类型与方法签名一致性,发现问题就地修复。
- 执行交接:计划保存后提供两种执行方式选择——子代理驱动(推荐,每个任务派发新子代理并在任务间评审)或内联执行(在当前会话中批量执行并设检查点)。
使用方式
开始时声明正在使用 writing-plans 技能创建实施计划。计划默认保存到 docs/superpowers/plans/YYYY-MM-DD-<feature-name>.md,用户对位置的偏好可覆盖此默认值。若在隔离 worktree 中工作,应在执行时通过 superpowers:using-git-worktrees 技能创建。选择子代理驱动时需使用 superpowers:subagent-driven-development;选择内联执行时需使用 superpowers:executing-plans。
适用场景
适用于已有明确规格或需求、需要把多步骤功能拆解为可独立测试、可评审任务的开发前规划,尤其适合交由代理执行者按任务逐步实现的场景。
限制
该技能强调计划本身的质量约束(精确路径、完整代码、精确命令与预期输出、DRY、YAGNI、TDD、频繁提交),但对具体技术栈、平台或运行环境未作限制说明;官方页面未提供收费、价格等信息,暂未提供。