SuperAPI AI 工具集

writing-plans

写作与研究

查看项目

更新于 10-15 17:35

技能介绍

用途:在动手写代码前,根据规格说明、需求文档或功能描述,产出一份完整的实施计划,假设执行工程师对代码库几乎零上下文。计划保存到 docs/plans/YYYY-MM-DD-<feature-name>.md,并建议在专用 worktree 中运行。

主要能力:把计划拆成 2-5 分钟粒度的步骤,遵循 DRY、YAGNI、TDD 和频繁提交;每个任务标明要创建、修改、测试的确切文件路径(修改现有文件时给出行号),提供完整代码而非伪代码,给出确切命令与预期输出,并用 @ 语法引用相关技能。计划头部需包含目标、架构、技术栈,并注明执行时使用 executing-plans 技能。

使用方式:开始时声明“I'm using the writing-plans skill to create the implementation plan.”。典型步骤为:写失败测试、运行确认失败、写最小实现、运行确认通过、提交。保存后提供两种执行选择:本会话内由子代理逐任务执行并在任务间审查,或另开会话用 executing-plans 批量执行并设检查点。

适用场景:需要把需求转化为可执行、可验证的开发计划时。

限制与常见问题:计划过于抽象、任务粒度不当、缺少验证步骤、重复指令、假设执行者不具备的上下文。资料未提供安装命令、收费或平台信息。