writing-plans

用途：在已有规格或需求、尚未动代码前，编写一份完整的多步骤实现计划，假设执行工程师对我们的代码库零上下文、对工具链和问题域几乎不了解，但具备开发能力。\n\n主要能力：先做范围检查，若规格覆盖多个相互独立的子系统，建议拆成每个子系统单独的、可独立产出可工作可测试软件的计划；随后映射文件结构，明确将创建或修改哪些文件及各自职责，遵循单一职责、按职责而非技术分层拆分、同变更文件相邻放置；将任务拆成 2-5 分钟的单动作步骤，典型为写失败测试、运行确认失败、写最小实现、运行确认通过、提交，采用 DRY、YAGNI、TDD 与频繁提交。\n\n计划文档：保存到 docs/superpowers/plans/YYYY-MM-DD-<feature-name>.md（用户自定义位置优先）。计划必须带固定头部，包含标题、供智能体执行者使用的必选子技能说明、目标、架构、技术栈。每个任务给出精确文件路径（创建/修改/测试）与若干带复选框的步骤，步骤需附完整代码、精确命令与预期输出。禁止占位内容，如 TBD、TODO、稍后实现、加上适当错误处理、写测试（无实际测试代码）、同任务 N、只描述做什么不展示怎么做、引用未在任何任务中定义的类型或函数等。\n\n使用方式：开始时声明正在使用该技能创建实现计划；写完后自检——规格覆盖（每条需求能否对应到任务）、占位符扫描、类型一致性（如 clearLayers 与 clearFullLayers 不一致即为缺陷），发现问题就地修复。保存后向用户提供执行方式选择：1）子代理驱动（推荐），每个任务派发全新子代理并在任务间评审；2）内联执行，在本会话中用 executing-plans 分批执行并设检查点。若选子代理驱动需使用 superpowers:subagent-driven-development，若选内联执行需使用 superpowers:executing-plans。\n\n限制：资料未提供适用平台、依赖安装方式、收费或许可信息。