SuperAPI AI 工具集

writing-plans

写作与研究

查看项目

更新于 10-16 09:48

技能介绍

用途:当你已有规格说明或需求,准备实施多步骤任务、尚未改动代码时,使用该技能编写一份完整的实现计划文档。它面向对代码库几乎零上下文的工程师,假设对方是熟练开发者但不熟悉本项目的工具链、问题域与测试设计。

主要能力:先划分文件结构,明确将创建或修改哪些文件及各自职责;再据此做任务分解,每个任务产出可独立测试、可单独评审的交付物。任务粒度极小,每步约 2-5 分钟,典型步骤为:写失败测试、运行确认失败、实现最小代码使测试通过、运行测试确认通过、提交。计划文档需包含统一的头部,写明目标、架构、技术栈、规格文档路径、全局约束与评审关注点。任务中包含文件清单与接口约定(消耗与产出的确切签名、参数与返回类型)。

使用方式:开始时声明“I'm using the writing-plans skill to create the implementation plan.”。计划默认保存到 docs/superpowers/plans/YYYY-MM-DD-<feature-name>.md,用户对位置的偏好可覆盖此默认值。若在隔离 worktree 中工作,应在执行时通过 superpowers:using-git-worktrees 技能创建。若规格涵盖多个独立子系统,应建议拆分为每个子系统一份计划。

适用场景:编码前的方案设计、交付前整理实施步骤、需要他人按计划逐步执行的开发任务。

限制:资料未说明该技能的收费、价格、支持平台与具体效果;其完整步骤示例在后文中被截断,此处不作补充。文档强调计划应基于规格展开,规格未提及的输入不代表可以出错,需在评审关注点中列出并为其补充测试。