SuperAPI AI 工具集

writing-plans

写作与研究

查看项目

更新于 10-16 02:31

技能介绍

用途:依据规格或需求,编写面向“对代码库零上下文”工程师的详细实现计划,把多步工作拆成可独立测试的小任务,供后续逐步执行。

主要能力:计划以文档形式保存,默认位置为项目的 plans 目录;若仓库已有 plans 目录或有约定的计划位置则沿用,否则默认 docs/plans/,文件名为 YYYY-MM-DD-<feature-name>.md,用户对位置的偏好可覆盖默认值。每个任务列出将创建、修改和测试的精确文件路径,说明接口的消费与产出(函数名、参数与返回类型),并以复选步骤呈现:写失败测试、运行确认失败、写最小实现、运行确认通过、提交。每步只做一个动作(约 2-5 分钟),并给出实际代码与运行命令。计划开头包含目标、架构、技术栈和全局约束。若规格涉及多个独立子系统,建议拆成多份计划。完成后进行自检:规格覆盖、占位符扫描、类型一致性。

使用方式:开始时声明使用该技能创建实现计划;执行前若使用隔离的 git worktree,需确保已存在。计划保存后提供两种执行方式:每个任务派发新的子智能体并在任务间评审(推荐),或在当前会话中逐任务执行并设检查点。

适用场景:需要把规格转化为具体、可验收的实现步骤,供人或其他智能体逐步执行。

限制与边界:该技能负责通用任务分解,不含阶段契约;阶段契约(DoD 断言、TDD 网格、产出物、边界)由 stage-spec 处理,顺序是先定型 stage-spec,再按 writing-plans 拆任务,且任务不得超出 DoD 边界。计划中禁止 TBD、TODO、稍后实现等占位符,禁止只描述做什么而不给出代码。资料未提供收费、平台与价格信息。