Writing Plans 实施规划
将多步骤软件需求拆解为可执行、可测试的实现计划。
证据显示技能限定在已有需求下生成计划，并规定计划保存位置、工作树上下文和执行方式选择；未见恶意行为、凭据处理或隐蔽外传。扣分原因是写入文件、提交步骤及后续子代理执行的权限边界、敏感数据处理、回滚和确认机制没有完整说明。
证据显示流程结构清晰，包含范围检查、文件映射、任务拆分、测试步骤、预期输出和自审清单。扣分原因是依赖其他未提供技能，未定义异常输入、保存失败、测试失败或不适用环境的诊断反馈；静态审查上限为10，且没有技能专属执行复现证据。
证据显示触发条件是已有规格或多步需求、输出格式和保存路径明确，并覆盖多子系统拆分及非占用范围。扣分原因是未明确非代码任务、无测试项目或缺乏规格时的边界，也未说明中文语言支持和不同代理工具环境下的语义触发细节。
证据显示文档分层良好，包含概览、范围、文件结构、任务模板、禁止占位符、自审和执行交接；仓库上下文提供MIT许可、版本号、安装说明和维护入口。扣分原因是该技能自身没有版本、变更记录或明确维护责任，且对多个外部子技能存在隐式依赖。
证据显示技能要求精确文件路径、完整代码、测试命令、预期结果和可独立审查的任务，理论上能产出可执行计划。扣分原因是没有该技能输出的已验证样例或实际结果证据，计划质量仍依赖模型对规格和代码库的理解；静态审查上限为7。
证据显示规则文本本身可审计，且要求进行规格覆盖、占位符和类型一致性检查。扣分原因是未见针对writing-plans关键路径的测试、第三方复现报告或多来源佐证；仓库测试证据主要覆盖其他组件，静态审查上限为5。
- 该技能要求依赖subagent-driven-development、executing-plans等其他技能；若这些技能不可用，未说明如何安全降级。
- 计划包含保存文件和提交命令等潜在外部效果，但未定义逐步确认、失败恢复或回滚流程。
- 未提供writing-plans专属行为测试或代表性计划，因此应对输出进行人工审阅。
- 未说明中文提示、中文规格或中国大陆网络环境下的适配；其核心功能不显式依赖海外在线服务。
这个 Skill 能做什么，适合哪些场景？
Writing Plans 适用于已有规格或需求、但尚未开始修改代码的多步骤软件任务。它要求先梳理文件结构和职责，再把工作拆成每步约 2–5 分钟、可独立验证的任务。计划应包含确切文件路径、完整代码片段、测试命令和预期结果，并遵循 DRY、YAGNI、TDD 与频繁提交。计划默认保存到 `docs/superpowers/plans/YYYY-MM-DD-<feature-name>.md`，除非用户指定其他位置。
读取用户提供的规格或需求，检查是否涉及多个独立子系统；在任务分解前列出将创建或修改的文件及其职责；生成包含固定头部、任务接口、逐步复选框、代码示例、测试命令和 Git 提交命令的 Markdown 实现计划；完成后进行规格覆盖、占位符和类型一致性自检，并提供子代理驱动执行或当前会话内执行两种选择。
- 开发者已经批准设计，需要在编写代码前得到一份可交给缺少项目背景的工程师执行的计划。
- 团队面对一个多步骤功能，希望每个任务都有独立的测试周期和明确的审查边界。
- 使用 TDD 的工程师需要把失败测试、最小实现、通过验证和提交拆成连续步骤。
- 维护者希望明确每个文件的修改责任，避免在现有代码库中进行未经计划的大规模重构。
这个 Skill 有哪些优点和局限？
- 要求提供确切文件路径、完整代码和可复制的测试命令。
- 任务粒度明确，每个任务都应形成可独立测试的交付物。
- 内置规格覆盖、占位符扫描和类型一致性自检。
- 明确强调 DRY、YAGNI、TDD 和频繁提交。
- 只负责编写实现计划，不负责执行计划中的代码变更。
- 默认假设工程师几乎不了解代码库、工具集和问题领域，因此计划可能较为详尽。
- 依赖 Superpowers 集合中的执行技能完成后续实施。
- 来源未提供独立的本技能测试套件或跨平台验证结果。
如何安装这个 Skill？
该技能位于 obra/superpowers 仓库的 skills/writing-plans/SKILL.md。README 说明 Superpowers 是包含 14 个技能的集合，需按所用 coding agent 分别安装；例如 Antigravity 可运行 agy plugin install https://github.com/obra/superpowers，Pi 可运行 pi install git:github.com/obra/superpowers。其他安装方式因 harness 而异。单独安装本技能的步骤未在来源中说明。
如何使用这个 Skill？
在已有规格或需求、准备修改代码之前触发该技能。开始时应宣布：I'm using the writing-plans skill to create the implementation plan. 随后生成并保存计划到 docs/superpowers/plans/YYYY-MM-DD-<feature-name>.md；若用户指定计划位置，则使用用户指定位置。计划完成后，提供子代理驱动执行或当前会话内执行两种选项。