SuperAPI AI 工具集

writing-plans

编程与开发

查看项目

更新于 10-16 08:49

技能介绍

用途:当你已有规格或需求,准备进行多步骤任务,但尚未接触代码时,使用 writing-plans 编写完整实施计划。它假设执行工程师对当前代码库几乎零上下文,因此需要把每个任务写到可独立执行的程度。

主要能力:把计划拆成 2-5 分钟粒度的步骤,例如“写失败测试”“运行确认失败”“写最小实现”“运行确认通过”“提交”。每个任务需列出要创建、修改和测试的精确文件路径,给出完整代码而非模糊描述,并提供带预期输出的精确命令。计划开头需包含执行技能说明、目标、架构与技术栈,并按固定任务结构组织。原则包括 DRY、YGNI、TDD 和频繁提交。

使用方式:开始时声明“I'm using the writing-plans skill to create the implementation plan.”。建议在由 brainstorming 技能创建的专用 worktree 中运行。计划保存到 docs/plans/YYYY-MM-DD-<feature-name>.md。保存后提供两种执行选择:本会话使用 superpowers:subagent-driven-development,每个任务派发新子代理并在任务间审查;或另开会话使用 superpowers:executing-plans,按检查点批量执行。

适用场景:适合需要跨文件、多步骤、强测试驱动的功能实现规划,以及希望把规格转换为可执行任务清单的工程流程。

限制:资料未提供该技能的收费、价格、平台兼容性、实际效果数据或除上述流程外的其他功能;也未说明不适用场景。执行命令示例需按实际项目替换,不应直接照搬。