SuperAPI AI 工具集

writing-plans

写作与研究

查看项目

更新于 10-15 20:09

技能介绍

用途:当你已有规格或需求、准备处理多步骤任务时,在接触代码之前使用本技能编写完整的实施计划。它假设执行者是有能力的开发者,但几乎不了解你的工具链和问题领域,也不擅长测试设计,因此计划要记录一切必要信息。

主要能力:先做范围检查,若规格覆盖多个独立子系统,建议拆成每个子系统一份计划,每份计划都应能独立产出可运行、可测试的软件。随后规划文件结构,明确将创建或修改哪些文件及各自职责,按职责而非技术分层拆分,文件改动同步则放在一起;在既有代码库中遵循既有模式。任务按 2-5 分钟的小步骤拆分,典型步骤为:写失败测试、运行确认失败、写最小实现、运行确认通过、提交。计划文档必须带固定头部,包含目标、架构、技术栈,并注明需配合 superpowers:executing-plans 技能逐任务实施,步骤用复选框跟踪。每个任务需列出精确文件路径(创建、修改、测试)、完整代码、精确命令与预期输出。

使用方式:开始时声明“I'm using the writing-plans skill to create the implementation plan.”,计划保存到 docs/plans/YYYY-MM-DD-<feature-name>.md。写完后派发 plan-document-reviewer 子代理审查,只提供计划文档路径与规格文档路径,不传会话历史;发现问题则修复并重新审查,通过后进入执行交接,询问是否执行,若执行则使用 superpowers:executing-plans 技能。

限制:审查循环超过 3 次需交由人工判断;审查意见仅供参考,若有异议应说明理由。资料未提供该技能的安装方式、收费、支持平台等信息。