SuperAPI AI 工具集

writing-plans

写作与研究

查看项目

更新于 10-15 21:39

技能介绍

用途:当你已有规格或需求、准备处理多步骤任务但尚未接触代码时,使用 writing-plans 技能编写完整的实施计划。它假设执行工程师熟悉开发但几乎不了解你的工具链和问题域,因此要求把所需信息全部写清楚。

主要能力:先做范围检查,若规格覆盖多个独立子系统,建议拆分为每个子系统一份计划;在定义任务前先规划文件结构,明确每个文件由谁创建或修改、各自职责,并按职责而非技术分层拆分,让一起变更的文件放在一起。任务按 2-5 分钟的小步粒度展开,典型步骤为:写失败测试、运行确认失败、写最小实现、运行确认通过、提交。计划文档必须带固定头部,包含目标、架构、技术栈,并注明必需子技能。

使用方式:开始时声明“I'm using the writing-plans skill to create the implementation plan.”。应在专用 worktree 中运行(由 brainstorming 技能创建)。计划保存到 docs/superpowers/plans/YYYY-MM-DD-<feature-name>.md,用户对位置的偏好可覆盖默认值。每个任务需列出精确文件路径(创建、修改、测试),代码步骤必须给出完整代码,命令需带预期输出。

限制与要求:禁止占位内容,如 TBD、TODO、implement later、fill in details,或“添加适当错误处理”“为上述写测试”等无实际代码的步骤;不得用“与任务 N 类似”代替重复代码;不得引用任何任务中未定义的类型、函数或方法。写完计划后需自检:规格覆盖、占位符扫描、类型一致性,发现问题就地修复。保存后提供两种执行选择:Subagent-Driven(推荐,每任务派发新子代理并在任务间审查)或 Inline Execution(使用 executing-plans 批量执行并设检查点)。