SuperAPI AI 工具集

writing-plans

办公与效率

查看项目

更新于 10-15 17:04

技能介绍

Writing Plans 是一个用于撰写实施计划的技能,目标读者被假定为对当前代码库几乎没有上下文、且测试设计能力较弱的熟练开发者。因此,计划需要把工程师需要知道的内容全部写清楚:每个任务要改哪些文件、具体代码、测试方法、可能需要的文档,以及如何测试。

用途 该技能用于把功能实现工作整理成完整、可执行的实施计划。计划假设工程师熟悉开发工作,但不了解当前工具链或问题域,因此要求写明所有关键细节,而不是依赖读者自行推断。

主要能力

  • 将计划组织为小任务,每一步约 2-5 分钟。
  • 使用精确文件路径,例如 src/models/user.py,而不是“用户模块”这类模糊描述。
  • 在计划中包含完整代码,而不是“添加校验”之类的说明。
  • 给出确切命令与预期输出,例如 pytest tests/file.py -v 以及预期看到什么。
  • 引用相关技能,使用 @ 语法,例如 @skills/category/skill-name。
  • 每个任务遵循 DRY、YAGNI、TDD 和频繁提交的模式。

使用方式 开始时需要声明:“I'm using the Writing Plans skill to create the implementation plan.” 该技能应在由头脑风暴技能创建的专用 worktree 中运行。计划保存路径为 docs/plans/YYYY-MM-DD-<feature-name>.md。计划保存后,需向用户提供执行选择:1. 子代理驱动(当前会话):每个任务派发新的子代理,任务之间进行审查,快速迭代;2. 并行会话(独立会话):在工作树中打开新会话,使用 executing-plans,批量执行并设置检查点。如果选择子代理驱动,使用 @skills/collaboration/subagent-driven-development,并留在当前会话,每任务使用新子代理加代码审查。如果选择并行会话,则引导用户在工作树中打开新会话,新会话使用 @skills/collaboration/executing-plans。

适用场景 适合需要把实现方案写成详细工程计划、并交给对代码库几乎不熟悉的工程师执行的情况。也适合需要按 TDD 节奏、频繁提交、逐步实现功能的工作流。

限制与未提供信息 资料未提供该技能的安装命令、收费方式、平台限制、具体代码示例、完整计划结构模板细节、最佳实践中的错误处理、日志、测试设计等展开内容。资料仅给出可查看进一步说明的章节指向,如 Plan Structure & Templates 和 Best Practices & Guidelines,但未包含具体正文。