SuperAPI AI 工具集

writing-plans

写作与研究

查看项目

更新于 10-15 23:41

技能介绍

用途:在已有规格或需求、尚未触碰代码时,编写一份面向多步骤任务的完整实施计划。计划假设执行者是熟练开发者,但几乎不了解本项目的工具链和问题域,也不擅长测试设计。

主要能力:先做范围检查,若规格覆盖多个独立子系统,建议拆成每个子系统一份计划,每份计划应能独立产出可运行、可测试的软件。随后规划文件结构,明确每个文件由谁创建或修改、各自职责,按职责而非技术分层拆分,并遵循现有代码库的既有模式。任务按 2-5 分钟的小步骤拆分,典型步骤为:写失败测试、运行确认失败、写最小实现、运行确认通过、提交。计划文档需包含固定头部(目标、架构、技术栈),每个任务列出精确文件路径、完整代码、精确命令与预期输出,并用 @ 语法引用相关技能。

使用方式:开始时声明“I'm using the writing-plans skill to create the implementation plan.”。应在专用 worktree 中运行(由 brainstorming 技能创建)。计划默认保存到 docs/superpowers/plans/YYYY-MM-DD-<feature-name>.md,用户对位置的偏好可覆盖默认值。写完计划后进入评审循环:派发单个 plan-document-reviewer 子代理,只提供计划文档路径和规格文档路径,不提供会话历史;发现问题由原编写者修复并重新派发,超过 3 轮则交由人工判断。评审通过后提供执行选择:子代理驱动(推荐,每个任务派发新子代理并在任务间评审)或内联执行(在当前会话用 executing-plans 批量执行并设检查点)。

适用场景:需要把规格转化为可逐步执行、可测试、可提交的工程计划时。

限制:资料未提供具体安装命令、收费方式、支持平台或效果数据;计划位置默认值可被用户偏好覆盖。