SuperAPI AI 工具集

writing-plans

写作与研究

查看项目

更新于 10-15 23:33

技能介绍

用途:当已有规格说明或需求、且任务需要多个步骤时,在写代码之前先编写实现计划。计划面向没见过代码库和规格的工程师,把已决定的文件、命名与签名、规格取值、验证测试记录下来。

主要能力:先做范围检查,若规格覆盖多个独立子系统,建议拆成各自可独立产出可工作、可测试软件的计划;随后列出将创建或修改的文件及职责,按职责而非技术层级拆分,优先小而专注的文件;再按任务与步骤粒度分解,每个任务以可独立测试的交付物结束,每步是一个操作并有可检查结果,如编写失败测试、运行确认失败、实现最少代码、运行确认通过、commit。计划头部包含目标、架构、技术栈、规格路径、全局约束与审查重点。

使用方式:开始时宣布正在使用 writing-plans 技能创建实现计划;该技能应在专用 worktree 中运行(由 brainstorming 技能创建)。计划默认保存到 docs/superpowers/plans/YYYY-MM-DD-<feature-name>.md,用户偏好优先。步骤使用复选框语法跟踪进度。完成后按清单自检:规格覆盖度、步骤扫描、类型一致性、审查重点、比例,发现问题直接内联修复。最后把计划链接交给人类伙伴审阅,并选择执行方式:子代理驱动(使用 subagent-driven-development)或原生执行(使用 executing-plans)。

适用场景:多步骤功能实现前的计划编写,尤其是需要明确接口、测试与文件结构的任务。

限制:资料未提供具体支持的编程语言、平台或工具链范围;计划位置默认值可被用户偏好覆盖;执行方式需由人类伙伴确认,未确认前不应开始实现。