用途
writing-plans 用于在多步骤任务已有规格或需求、尚未接触代码之前,编写一份完整的实施计划。它的目标是让一位技术熟练、但对本代码库和问题领域几乎一无所知、测试设计经验也有限的工程师,能够仅凭计划独立完成任务。
主要能力
技能会指导生成结构化的计划文档,要求:
- 为每个任务列明需要新建、修改和测试的确切文件路径(含行号范围)。
- 在计划中写出完整代码,而不是“添加校验”这类模糊描述。
- 给出确切命令及其预期输出。
- 以 @ 语法引用相关技能。
- 遵循 DRY、YAGNI、TDD 与频繁提交原则。
使用方式
开始时应声明:“I'm using the writing-plans skill to create the implementation plan.” 该技能建议在专门的工作树(由 brainstorming 技能创建)中运行。计划保存路径为 docs/plans/YYYY-MM-DD-<feature-name>.md。
每个计划必须以固定文档头开始,包含功能名称、给 Claude 的子技能提示、目标(一句话)、架构(2-3 句)与技术栈。任务结构为“Task N: 组件名”,先列文件清单,再按微步骤展开——每步一个动作(2-5 分钟):写失败测试、运行确认失败、写最小实现、运行确认通过、提交。
计划保存后会提供两种执行选择:其一为子代理驱动(当前会话内,每个任务派发新的子代理并在任务间审查,需使用 superpowers:subagent-driven-development);其二为并行会话(在新会话中使用 superpowers:executing-plans 批量执行并设检查点)。
适用场景
已有需求或规格说明、需要把开发工作拆解为可逐条执行的微任务时;需要让缺乏上下文的工程师或代理独立接手实现时;需要以测试驱动方式推进多步骤功能开发时。
限制
该技能依赖工作树和配套技能(brainstorming、executing-plans、subagent-driven-development)协同使用;资料未提供其对具体编程语言、框架或平台的限制说明。