SuperAPI AI 工具集

writing-plans

编程与开发

查看项目

更新于 10-16 07:16

技能介绍

用途:当你已有规格说明或需求,准备开始一个多步骤任务、但尚未接触代码时,使用 writing-plans 技能编写实施计划。它假设执行者是熟练开发者,但几乎不了解你的工具链和问题领域,也不擅长测试设计,因此计划必须自包含。

主要能力:先做范围检查,若规格覆盖多个独立子系统,建议拆成每个子系统一份计划,每份都能独立产出可运行、可测试的软件。随后规划文件结构,明确每个文件由谁创建或修改、各自职责,按职责而非技术分层拆分,并遵循既有代码库模式。任务按 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,用户对位置的偏好可覆盖默认值。每个任务需列出精确文件路径、完整代码、精确命令与预期输出,禁止占位符(如 TBD、TODO、implement later、add appropriate error handling、Write tests for the above、Similar to Task N 等)。写完后自行做三项自检:规格覆盖、占位符扫描、类型一致性。保存后提供两种执行方式:Subagent-Driven(推荐,每个任务派发新子代理并在任务间审查)或 Inline Execution(用 executing-plans 批量执行并设检查点)。

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

限制:资料未提供该技能的安装命令、收费、价格、平台支持或效果数据;其依赖的 brainstorming、subagent-driven-development、executing-plans 等子技能细节也未在资料中展开。