SuperAPI AI 工具集

writing-plans

编程与开发

查看项目

更新于 10-16 07:11

技能介绍

用途

writing-plans 适用于这样一种情况:你已经拿到某个多步骤任务的规格说明(spec)或需求文档,准备动手写代码之前,先需要一份可落地的实施计划。它强调计划的可执行性——目标是让一名对项目背景只有极少上下文的工程师也能照着计划直接执行。

主要能力与规则

该技能通过一套明确的规则来约束计划的质量:

  • 任务粒度:每个任务控制在 2-5 分钟内完成,并且只包含一个动作。典型的动作序列为:写测试 -> 运行并预期失败 -> 实现 -> 验证 -> 提交。
  • 禁止占位符:计划中不允许出现占位内容。每一步都必须列出确切的文件路径、完整的代码块和确切的命令。不能只写“添加错误处理”而不展示具体如何实现。
  • 先梳理文件职责:在编写任务之前,先梳理文件职责,并确保每个文件只承担单一职责。
  • 完成前自检:收尾前对照一份自检清单:检查每一条规格要求是否都能映射到某个任务;排查是否存在 TBD、TODO 或“类似任务 N”这类模糊表述;确保各任务之间的类型与签名保持一致。
  • 计划头部:计划头部需要声明目标(Goal)、架构(Architecture)和技术栈(Tech Stack)。
  • 默认保存路径:docs/plans/YYYY-MM-DD-<feature>.md。

使用方式

在拥有规格或需求、准备进入编码阶段之前使用该技能来生成计划。由于资料中未提供具体的调用方式、安装命令或界面操作步骤,此处暂未提供。

适用场景

  • 已有一份规格说明或需求,需要将其拆解为可执行的多步骤实现计划。
  • 需要让缺少上下文的工程师(或协作者)能够独立按计划执行任务的场景。
  • 希望在编码前明确文件职责、任务顺序与验证方式的开发流程。

来源与限制

该项目来源于 github.com/obra/superpowers(MIT 许可),经过精简并注明出处后用于 corlinman 市场。资料中未提供关于收费、价格、支持平台、实际使用效果以及更多具体操作步骤的信息,这些内容暂未提供。