用途
writing-plans 用于在已有规格说明或需求、但尚未开始写代码时,为多步骤任务编写一份完整的实施计划。它的核心假设是:执行计划的工程师虽然技术熟练,但对当前代码库、工具链和问题领域几乎一无所知,并且不太懂良好的测试设计。因此计划需要把一切必要信息都写清楚,而不是依赖执行者的上下文或品味。
主要能力
- 以“零上下文”为前提编写计划,明确每个任务需要触碰哪些文件、写什么代码、需要参考哪些测试与文档、如何测试。
- 将整个计划拆解为“一口大小”的任务粒度,每个步骤只做一件事,约 2-5 分钟,例如:写失败测试、运行确认失败、写最小实现、运行确认通过、提交。
- 计划文档带有固定头部,包含功能名称、目标(一句话)、架构(2-3 句)、技术栈,并注明执行时需使用 superpowers:executing-plans 子技能。
- 任务结构固定:每个任务列出 Files(Create / Modify / Test 的精确路径),随后按步骤给出测试代码、运行命令与预期输出、最小实现代码、验证命令与预期结果、提交命令。
- 强调精确文件路径、计划中包含完整代码(而不是“添加校验”这类模糊描述)、精确命令与预期输出、用 @ 语法引用相关技能。
- 遵循 DRY、YAGNI、TDD 与频繁提交原则。
- 计划保存路径为 docs/plans/YYYY-MM-DD-<feature-name>.md。
- 开始时会声明:“I'm using the writing-plans skill to create the implementation plan.”
- 计划完成后提供执行方式选择:子代理驱动(本会话内,每个任务派发全新子代理,任务间进行审查,快速迭代)或并行会话(另开会话,使用 executing-plans,带检查点批量执行)。
使用方式
该技能应在由 brainstorming 技能创建的专用 worktree 中运行。编写时先声明正在使用本技能,然后按固定头部与任务结构逐项撰写计划,最后保存到指定路径。保存后向用户提供两种执行选项并询问选择:若选择子代理驱动,则要求使用 superpowers:subagent-driven-development,留在当前会话,每个任务使用全新子代理并进行代码审查;若选择并行会话,则引导用户在该 worktree 中打开新会话,新会话需使用 superpowers:executing-plans。
适用场景
适用于已有规格或需求、需要为多步骤开发任务制定实施计划的场景,尤其是希望计划足够详细、可被缺乏代码库上下文的工程师或子代理直接执行的团队协作与自动化开发流程。
限制
资料未提供该技能的安装方式、收费模式、支持平台或具体效果数据,这些信息暂未提供。