writing-plans

writing-plans 技能是 Superpowers 方法论的核心组件，旨在连接抽象的项目规格与可执行的代码。它专为需要执行复杂编程目标、并要求结构完整性与遵循测试驱动开发 (TDD) 原则的软件代理所设计。通过模拟资深架构师对缺乏代码库背景的工程师进行指导的模式，此技能确保所有技术决策都是明确、模块化且可验证的。

• 生成全面且细致的实现计划，将大型功能分解为 2-5 分钟即可完成的小任务。

• 强制执行严格的 TDD 工作流程，要求定义失败测试、最小化实现代码，以及每个组件的验证周期。

• 强制要求精确的文件路径说明，确保工程师在开始工作前明确知道需要创建或修改哪些文件。

• 为所有计划提供标准化的 Markdown 标题，确保与子代理驱动开发或执行工作流程之间的一致性与清晰交接。

• 包含自我审查机制，在编写任何代码之前识别占位符、类型不一致与覆盖范围缺失。

• 此技能应在头脑风暴阶段确定项目规格后，且在任何 git 工作树或实际编程任务开始前调用。

• 它需要输入明确的项目规格或需求集；产出计划的质量直接取决于这些需求的清晰程度。

• 产出内容必须保存为 Markdown 文件，理想情况下遵循 docs/superpowers/plans/YYYY-MM-DD-<feature-name>.md 的命名惯例以保持可审计性。

• 实际限制包括避免模糊的指令，如“新增验证”或“处理边缘情况”；每个任务必须包含具体的代码示例、精确的 CLI 测试指令以及具体的预期输出，以防止歧义并确保自动化开发管线的成功。