writing-plans

技能简介

writing-plans 用于在编写代码之前，为多步骤开发任务生成详细的实施计划。它假设执行计划的工程师对代码库和工具链缺乏背景知识，因此需要把所有细节（涉及文件、代码实现、测试步骤、提交方式）都以小粒度任务的形式写清楚，帮助团队按 TDD、DRY、YAGNI 等工程实践稳步推进。

使用场景

• 拿到多步骤任务的规格说明（Spec），准备开始编码之前
• 需要为新手工程师或子代理（subagent）制定一份可直接执行的详细任务清单
• 功能涉及多个文件或子系统，需要提前确定文件拆分和接口设计
• 需要确保每个任务都能独立测试、独立提交，配合规范的良好工程实践

使用方法

该技能由 Agent 在满足触发条件时自动调用（多步骤任务、编写代码之前）。启用时，Agent 会先声明："I'm using the writing-plans skill to create the implementation plan."

计划默认保存到：docs/superpowers/plans/YYYY-MM-DD-<feature-name>.md

计划文档采用固定结构：

• 文档头部：包含目标（Goal）、架构（Architecture）、技术栈（Tech Stack）、规范路径（Spec）和全局约束（Global Constraints）
• 任务分解：每个任务以 ### Task N: [组件名称] 开头，列出涉及文件、接口契约（Consumes/Produces），以及带复选框的任务步骤
• 步骤粒度：每个步骤是单一操作（2-5 分钟），典型流程为：编写失败测试 → 运行确认失败 → 编写最小实现 → 运行确认通过 → 提交代码

实施时建议配合 superpowers:subagent-driven-development 或 superpowers:executing-plans 子技能，按任务逐一推进（步骤使用 - [ ] 复选框追踪进度）。

注意事项

• 计划中禁止出现 TBD、TODO 等占位描述，每个代码步骤必须直接给出可运行的代码和测试内容
• 任务划分以“可独立测试、可独立审查”为原则，不要过度拆分
• 遵循代码库现有模式；若改动的文件过于臃肿，可在计划中合理提出拆分方案
• 每个任务结束时应有独立可测试的交付物，并伴随一次代码提交（commit）