用途:当你已有规格或需求、准备处理多步骤任务时,在接触代码之前使用本技能,产出一份可被他人或智能体直接执行的实施计划。
主要能力:先做范围检查,若规格覆盖多个独立子系统,建议拆成每个子系统一份计划,每份都能独立产出可运行、可测试的软件。随后规划文件结构,明确每个文件创建或修改的职责与接口,按职责而非技术分层拆分,并遵循既有代码库的惯例。任务按 2-5 分钟的小步骤拆分,典型步骤为:写失败测试、运行确认失败、写最小实现、运行确认通过、提交。计划文档必须带固定头部,包含目标、架构、技术栈,并提示执行者使用复选框跟踪进度。每个任务需列出精确文件路径(创建、修改、测试),给出完整代码而非“添加校验”这类描述,给出精确命令与预期输出,可用 @ 语法引用相关技能。
使用方式:开始时声明“I'm using the writing-plans skill to create the implementation plan.”。应在专用 worktree 中运行(由 brainstorming 技能创建)。计划默认保存到 docs/superpowers/plans/YYYY-MM-DD-<feature-name>.md,用户对位置的偏好可覆盖默认值。每完成一个计划块,派发 plan-document-reviewer 子代理审查,只提供块内容与规格文档路径,不提供会话历史;未通过则修复并重新派发,直到通过再进入下一块。块用 ## Chunk N: <name> 标题分隔,每块不超过 1000 行且逻辑自洽。审查循环超过 5 次需交人工判断,审查意见仅供参考。
执行交接:计划保存后提示“Plan complete and saved to docs/superpowers/plans/<filename>.md. Ready to execute?”。若运行环境有子代理(如 Claude Code),必须使用 superpowers:subagent-driven-development,每个任务用全新子代理并做两阶段审查;若无子代理,则在当前会话用 superpowers:executing-plans 分批执行并设检查点。
限制:资料未提供该技能的收费、价格、平台支持范围与效果数据;其流程依赖 superpowers 相关技能与子代理能力,缺少这些环境时部分步骤无法按原样执行。