用途
writing-plans 用于在动手改代码之前，针对已有规格说明（spec）或需求的多步骤任务编写完整实施计划。技能开头需声明："I'm using the writing-plans skill to create the implementation plan."，并应在由 brainstorming 技能创建的专用 worktree 中运行。
计划保存位置
新项目保存到 docs/rubypowers/plans/YYYY-MM-DD-<feature-name>.md；若已存在 docs/superpowers/plans/ 则使用该旧目录，不再新建目录。用户对计划位置的偏好优先于默认值。
范围检查与文件结构
若规格覆盖多个独立子系统，应先拆分为子项目规格，每个计划独立产出可工作、可测试的软件。定义任务前先规划将创建或修改的文件及其职责，按职责而非技术层拆分，文件应小而聚焦；在既有代码库中遵循已有模式，若修改的文件已过于臃肿，可在计划中纳入拆分。
任务粒度与文档结构
每个步骤是一个动作（2-5 分钟），如写失败测试、运行确认失败、写最小实现、运行确认通过、提交。每个计划必须以固定头部开始，包含 Goal、Architecture、Tech Stack 及指向 rubypowers:subagent-driven-development 或 rubypowers:executing-plans 的说明。任务结构包含 Files（Create/Modify/Test 精确路径）与带复选框的步骤，代码步骤需给出完整代码、精确命令与预期输出。
禁止占位内容
不得出现 TBD、TODO、implement later、fill in details、"add appropriate error handling"、无实际测试代码的"write tests for above"、"similar to Task N"、只描述做什么而不展示怎么做的步骤、引用未在任何任务中定义的类型或函数。
自检与执行交接
写完计划后对照规格自查：规格覆盖（每条需求能否对应到任务）、占位符扫描、类型与命名一致性，发现问题直接就地修复。保存后提供两种执行方式：Subagent-Driven（推荐，每任务派发新子代理并在任务间评审，需使用 rubypowers:subagent-driven-development）或 Inline Execution（在当前会话用 rubypowers:executing-plans 批量执行并设检查点）。
限制
该技能面向 Ruby 项目场景（来自 rubypowers 技能集），依赖配套的 brainstorming、执行类子技能；未提供价格、平台或效果方面的信息。