用途:该技能适用于已有多步任务的规格说明或需求、但尚未开始改动代码的阶段,用来产出一份供工程师或智能体执行的实施计划。
主要能力:
- 明确计划前提:假设执行者会写项目语言的惯用代码,但无法知道规划者做出的具体决定,因此计划需记录涉及哪些文件、名称与签名、规格中的取值、以及证明每个任务的测试。
- 范围检查:若规格覆盖多个独立子系统,建议拆分为每个子系统一份独立计划,每份计划应能独立产出可运行、可测试的软件。
- 文件结构规划:在定义任务前先梳理将创建或修改的文件及其职责,偏好小而专注的文件,按职责而非技术分层拆分,并遵循现有代码库的既定模式。
- 任务划分:任务是最小单元,自带测试循环并值得独立审查;把环境搭建、配置、脚手架和文档步骤并入需要它们的任务,只在审查者可能分别接受或拒绝相邻任务处拆分。
- 步骤粒度:每步对应一个动作和可检查结果,例如先写失败测试、运行确认失败、实现最小代码、运行确认通过、提交。
- 计划文档头:固定包含功能名称、面向智能体执行者的提示、目标、架构、技术栈、全局约束和审查重点。
- 任务结构:每个任务包含文件清单(创建、修改、测试路径)、接口(消费与产出)、带复选框的步骤,以及测试代码、运行命令与预期结果、提交命令。
- 自查清单:检查规格覆盖、步骤歧义或冗余、类型与签名一致性、审查重点是否都有对应测试、计划与规格篇幅是否成比例。
- 执行交接:计划保存并自查后,请用户审阅;在用户未指定执行方式时,提供子智能体驱动与原生执行两种方案并给出推荐理由,等待确认后再实施。
使用方式:开始时说明正在使用 writing-plans 技能创建实施计划;计划默认保存到 docs/superpowers/plans/YYYY-MM-DD-<feature-name>.md,用户对位置的偏好可覆盖默认值;若在隔离工作树中工作,该工作树应已在执行时通过 using-git-worktrees 技能创建。计划写完后按模板中的提示完成自查与执行方式选择。
适用场景:拥有规格或需求、需要为多步骤开发任务做实施规划时;多人或多智能体协作、需要明确接口与测试边界时;希望在动代码前锁定文件职责与任务顺序时。
限制:资料未说明该技能的安装方式、收费、平台支持或具体工具集成;其效果依赖规格本身的完整性,计划无法覆盖规格未提及的所有输入。