SuperAPI AI 工具集

writing-plans

写作与研究

查看项目

更新于 10-16 03:05

技能介绍

用途:当你已有规格或需求、准备实现一个多步骤任务但尚未接触代码时,使用 writing-plans 编写完整的实施计划。它假设执行工程师熟悉开发但对当前代码库、工具链和问题域几乎零上下文,因此要求把每个任务所需信息全部写清。

主要能力:先做范围检查,若规格覆盖多个独立子系统,建议拆成每个子系统一份计划,每份计划应能独立产出可运行、可测试的软件。随后规划文件结构,明确每个文件创建或修改什么、职责边界与接口,并据此分解任务。任务按“最小可独立测试单元”划分,步骤细化为 2-5 分钟一个动作,典型顺序为:写失败测试、运行确认失败、写最小实现、运行确认通过、提交。计划文档需带固定头部,包含目标、架构、技术栈、规格路径和全局约束,并逐任务列出文件、接口(消费与产出)、带复选框的步骤及实际代码与命令。

使用方式:开始时声明“I'm using the writing-plans skill to create the implementation plan.”。计划默认保存到 docs/superpowers/plans/YYYY-MM-DD-<feature-name>.md,用户对位置的偏好可覆盖默认值。若在隔离 worktree 中工作,应在执行时通过 superpowers:using-git-worktrees 技能创建。写完计划后需自审:核对规格覆盖、扫描占位符、检查类型与命名一致性,发现问题就地修复。最后提供执行选择:子智能体驱动(推荐,每任务派发新子智能体并在任务间审查)或内联执行(本会话内批量执行并设检查点)。

适用场景:多步骤功能实现前的计划编写,尤其适合需要 TDD、频繁提交、任务可独立评审的工程流程。

限制:资料未提供该技能的安装方式、收费、价格、支持平台或实际效果数据;计划中禁止出现 TBD、TODO、稍后实现、适当错误处理、无代码的测试描述、仅引用其他任务而不重复代码等占位内容。