SuperAPI AI 工具集

writing-plans

写作与研究

查看项目

更新于 10-15 20:29

技能介绍

用途:当已有规格或需求、准备实施多步任务时,先编写完整的实施计划,再进入编码。计划假设执行者是熟练开发者,但几乎不了解你的工具链和问题域,也不擅长测试设计。

主要能力:先做范围检查,若规格覆盖多个独立子系统,建议拆分为每个子系统一份计划,每份都能独立产出可运行、可测试的软件。在定义任务前先做文件结构规划,明确各文件职责与边界,倾向小而聚焦的文件,按职责而非技术层拆分,已有代码库遵循既有模式。任务按 2-5 分钟的小步骤拆分:写失败测试、运行确认失败、写最小实现、运行确认通过、提交。计划开头必须包含固定头部,写明目标、架构、技术栈,并提示使用 superpowers:subagent-driven-development 或 superpowers:executing-plans,步骤用复选框跟踪。每个任务列出需创建、修改、测试的确切文件路径,代码步骤需给出完整代码,命令需给出确切命令与预期输出。

使用方式:在专用 worktree 中运行;开始时声明使用 writing-plans 技能;默认将计划保存到 docs/superpowers/plans/YYYY-MM-DD-<feature-name>.md,用户偏好可覆盖。写完计划后对照规格自查:检查规格覆盖、占位符、类型与方法名一致性,发现问题直接就地修复。完成后提供两种执行选择:subagent 驱动(推荐)或内联执行。

限制:禁止占位符,如 TBD、TODO、稍后实现、补充细节;禁止写“添加适当错误处理”“为上述写测试”等空泛步骤;不得引用未在任何任务中定义的类型、函数或方法。安装命令与具体依赖工具信息暂未提供。