writing-plans

writing-plans 技能是为编程 AI 代理量身打造的工程工具，旨在弥合抽象需求与可执行代码之间的差距。在开始实现之前，此技能强制要求代理生成一份全面且可执行的蓝图。通过严格遵守测试驱动开发 (TDD)、YAGNI 和 DRY 原则，它确保即使是复杂的功能也能被拆解为 2-5 分钟的微型任务。此技能适用于已有明确规格，但需要结构化、可靠的执行方式，且无需手动监督每一行代码的情境。

• 生成包含精确文件路径、所需代码片段及验证指令的结构化实现计划。

• 通过将测试优先的要求嵌入每个任务步骤，强制执行严格的红-绿-重构 (Red-Green-Refactor) 循环。

• 将输出标准化，要求每个计划都必须包含特定标题、目标定义与架构摘要。

• 严格禁止使用 TODO 或模糊的“加入错误处理”等占位符，以防止常见的开发疏忽。

• 通过子代理驱动开发 (Subagent-Driven Development) 或内嵌批次处理，促进从计划到执行的无缝衔接。

• 要求在生成任何代码之前进行系统化的文件映射与架构拆解，确保模块化设计。

• 输入：需要有效的项目功能规格或需求清单，建议由 brainstorming 技能产生。

• 输出：存储于 docs/superpowers/plans/ 的 Markdown 文件，包含完整且可测试的任务清单。

• 限制：代理将目标受众预设为缺乏项目上下文的开发者，因此所有步骤必须明确且自给自足。

• 最佳实践：在专用的 git worktree 中使用此技能，以维持实现期间的工作区整洁。

• 审查：在提供执行交接之前，代理必须对占位符模式、类型一致性及规格覆盖率进行自我审查。

• 整合：与 executing-plans 及 subagent-driven-development 无缝整合，形成完整的自动化开发循环。