SuperAPI AI 工具集

writing-plans

写作与研究

查看项目

更新于 10-16 09:44

技能介绍

用途:当已有规格说明或需求、准备进行多步骤任务时,在写代码前先编写全面的实现计划。计划假设执行工程师经验丰富,但对当前工具链和问题领域几乎一无所知,因此需要记录其所需的一切信息。

主要能力与要求:将计划拆成小步骤任务,每步约 2-5 分钟、一个操作,例如“编写失败的测试”“运行确认失败”“编写最少实现代码”“运行确认通过”“Commit”。先列出将创建或修改的文件及各自职责,设计边界清晰、接口良好的小文件;贴近上下文、按职责而非技术层级拆分。计划文档头部需包含功能名称、目标、架构、技术栈,并注明必需子技能。任务以复选框跟踪进度,包含精确文件路径、完整代码、精确命令与预期输出,禁止占位符,不做“类似任务 N”的省略。

使用方式:开始时宣布正在使用 writing-plans 创建实现计划;在专用 worktree 中运行(由 brainstorming 技能创建);计划保存到 docs/superpowers/plans/YYYY-MM-DD-<feature-name>.md,用户偏好优先。完成后进行自检:规格覆盖度、占位符扫描、类型一致性,发现问题直接内联修复。随后提供执行选项,子代理驱动(推荐,每个任务一个新子代理加两阶段审查,使用 superpowers:subagent-driven-development)或内联执行(使用 superpowers:executing-plans,批量执行并设检查点)。

适用场景与限制:适合需要多步骤实现、希望提前锁定分解与测试策略的任务。若规格涵盖多个独立子系统,应在头脑风暴阶段拆分;否则建议拆为独立计划,每个能独立产出可工作、可测试的软件。需避免“待定”“TODO”等占位内容,以及只描述做什么而不展示怎么做的步骤。其它未在资料中说明的限制暂未提供。