用途
writing-plans 用于在已有规格说明或需求、但尚未开始写代码时,编写一份完整的实施计划。它的核心假设是:执行计划的工程师虽然技术熟练,但几乎不了解当前代码库的工具链和问题领域,也不太擅长测试设计。因此计划需要把一切必要信息都写清楚。
主要能力
- 为每个任务明确需要触碰的文件:新建、修改(含行号范围)、测试文件。
- 将任务拆解为细粒度步骤,每一步是一个动作,约 2-5 分钟,例如:写失败测试、运行确认失败、写最小实现、运行确认通过、提交。
- 在计划中给出完整代码,而不是“添加校验”这类模糊描述。
- 给出精确命令及预期输出。
- 遵循 DRY、YAGNI、TDD 和频繁提交原则。
- 使用 @ 语法引用相关技能。
使用方式
开始时需声明:“I'm using the writing-plans skill to create the implementation plan.”
该技能应在专门的工作树(worktree)中运行,该工作树由 brainstorming 技能创建。
计划保存路径为:docs/plans/YYYY-MM-DD-<feature-name>.md。
每份计划必须以固定头部开头,包含:功能名称、面向 Claude 的必需子技能提示(superpowers:executing-plans)、目标(一句话)、架构(2-3 句)、技术栈。
任务结构示例:
Task N: [Component Name]
Files:
- Create:
exact/path/to/file.py - Modify:
exact/path/to/existing.py:123-145 - Test:
tests/exact/path/to/test.py
随后按步骤展开:写失败测试(附代码)、运行测试确认失败(附命令与预期)、写最小实现(附代码)、运行测试确认通过(附命令与预期)、提交(附 git 命令)。
执行交接
保存计划后,需提供两种执行选项:
- Subagent-Driven(本会话):每个任务派发新的子代理,任务之间进行审查,快速迭代。若选择此项,必需子技能为 superpowers:subagent-driven-development,留在当前会话。
- Parallel Session(独立会话):在工作树中打开新会话,使用 executing-plans,带检查点批量执行。若选择此项,需引导用户在工作树中打开新会话,新会话使用 superpowers:executing-plans。
适用场景
适用于已有规格或需求、需要为多步骤任务编写实施计划的场景,尤其适合希望以 TDD 和细粒度任务推进、并要求计划可被他人或子代理直接执行的开发流程。
限制
资料未提供该技能的收费、价格、平台支持范围或效果保证等信息。