SuperAPI AI 工具集

writing-plans

写作与研究

查看项目

更新于 10-15 21:10

技能介绍

用途:在已有规格或需求、但尚未开始编码时,为多步骤任务编写一份完整的实现计划。计划假设执行工程师熟悉开发但几乎不了解当前代码库、工具集与问题领域,也假设其测试设计经验不足,因此需要把所需信息全部写清楚。

主要能力与结构:计划以“小任务”为单位拆分,每步只做一个动作,通常是:写失败测试、运行确认失败、写最小实现、运行确认通过、提交。每个任务需列出要创建、修改和测试的精确文件路径,包含完整代码而非笼统描述,并给出确切命令及预期输出。文档头部需包含功能名、目标、架构、技术栈,并注明所需子技能。计划强调 DRY、YAGNI、TDD 与频繁提交。

使用方式:开始时声明正在使用 writing-plans 技能创建实现计划;应在专用 worktree 中运行。计划保存到 docs/plans/YYYY-MM-DD-<feature-name>.md。在 SuperNavigator 中,计划同时写入 docs/plans/ 与 .agent/tasks/ 以便索引,完成后 nav-task 会自动在 DEVELOPMENT-README.md 中建立索引,未来会话可用 nav-start 恢复访问。

执行交接:保存计划后需提供两种执行选项,一是子代理驱动(本会话,每任务派发新子代理并在任务间审查),二是并行会话(另开会话使用 executing-plans,分批执行并设检查点)。

限制:资料未提供该技能的具体安装命令、收费或价格、支持平台及实际效果数据,这些事实暂未提供。