SuperAPI AI 工具集

writing-plans

编程与开发

查看项目

更新于 10-24 16:15

技能介绍

用途

writing-plans 用于在已有规格说明或需求、但尚未开始写代码时,编写一份完整的实施计划。它的核心假设是:执行计划的工程师虽然技术熟练,但几乎不了解当前代码库的工具链和问题领域,也不太擅长测试设计。因此计划需要把一切必要信息都写清楚。

主要能力

  • 为每个任务明确需要触碰的文件:新建、修改(含行号范围)、测试文件。
  • 将任务拆解为细粒度步骤,每一步是一个动作,约 2-5 分钟,例如:写失败测试、运行确认失败、写最小实现、运行确认通过、提交。
  • 在计划中给出完整代码,而不是“添加校验”这类模糊描述。
  • 给出精确命令及预期输出。
  • 遵循 DRY、YAGNI、TDD 和频繁提交原则。
  • 使用 @ 语法引用相关技能。

使用方式

开始时需声明:“I'm using the writing-plans skill to create the implementation plan.”

该技能应在专门的工作树(worktree)中运行,该工作树由 brainstorming 技能创建。

计划保存路径为:docs/plans/YYYY-MM-DD-<feature-name>.md。

每份计划必须以固定头部开头,包含:功能名称、面向 Claude 的必需子技能提示(superpowers:executing-plans)、目标(一句话)、架构(2-3 句)、技术栈。

任务结构示例:

Task N: [Component Name]

Files:

  • Create: exact/path/to/file.py
  • Modify: exact/path/to/existing.py:123-145
  • Test: tests/exact/path/to/test.py

随后按步骤展开:写失败测试(附代码)、运行测试确认失败(附命令与预期)、写最小实现(附代码)、运行测试确认通过(附命令与预期)、提交(附 git 命令)。

执行交接

保存计划后,需提供两种执行选项:

  1. Subagent-Driven(本会话):每个任务派发新的子代理,任务之间进行审查,快速迭代。若选择此项,必需子技能为 superpowers:subagent-driven-development,留在当前会话。
  2. Parallel Session(独立会话):在工作树中打开新会话,使用 executing-plans,带检查点批量执行。若选择此项,需引导用户在工作树中打开新会话,新会话使用 superpowers:executing-plans。

适用场景

适用于已有规格或需求、需要为多步骤任务编写实施计划的场景,尤其适合希望以 TDD 和细粒度任务推进、并要求计划可被他人或子代理直接执行的开发流程。

限制

资料未提供该技能的收费、价格、平台支持范围或效果保证等信息。