SuperAPI AI 工具集

writing-plans

编程与开发

查看项目

更新于 10-16 09:31

技能介绍

用途:在开始编码前,当已有规格说明要完成多步骤任务时,先用本技能编写一份完整实现计划。它假定执行计划的工程师具备开发能力,但几乎不了解代码库、工具链和问题领域,也不擅长测试设计,因此计划需把所需信息全部写清楚。

主要能力与写法:计划按“任务(Task)”组织,每个任务列出要创建、修改和测试的精确文件路径;每个步骤是一个 2-5 分钟可完成的动作,例如先写失败测试、运行确认失败、写最小实现、运行确认通过、提交。计划要求写明完整代码而非“添加校验”这类模糊描述,给出精确命令及预期输出,用 @ 语法引用相关技能,并遵循 DRY、YAGNI、TDD 和频繁提交。

文档格式:每个计划必须以固定头部开始,包含功能名、面向 Claude 的必需子技能说明、目标(一句话)、架构(2-3 句)和技术栈。保存路径为 docs/plans/YYYY-MM-DD-<feature-name>.md。开始时应声明:“I'm using the writing-plans skill to create the implementation plan.”

使用方式与交接:应在专用 worktree 中运行(由 brainstorming 技能创建)。计划保存后向用户提供两种执行选择:1)Subagent-Driven(本会话)——每个任务派发新的子代理,任务之间做代码审查,快速迭代,需使用 superpowers:subagent-driven-development,并留在当前会话;2)Parallel Session(独立会话)——在新工作树中打开新会话,使用 superpowers:executing-plans 批量执行并在检查点停顿。

适用场景:多步骤功能开发前的计划阶段、需要把规格转化为可执行任务的场景。

限制:资料未提供价格、平台支持范围、安装命令、性能效果或与其他工具的收费差异;除上述内容外,未提供更多细节。