用途:planning 用于工作计划中的 PRD 构建,在 PLAN 阶段强制使用。它把剩余工作整理为 ./.prd 文件,作为唯一事实来源,并在执行前冻结为依赖图,尽可能枚举所有工作项,包括步骤、子步骤、边界情况、依赖与传递依赖、未知项、假设、决策、权衡、验收标准、失败与恢复路径、集成点、状态转换、并发问题、输入输出校验、错误与边界条件、配置与环境差异、向后兼容、数据迁移、回滚、监控与验证步骤等。资料强调“越长越好”,遗漏条目即遗漏工作。
主要能力:以 JSON 格式记录工作项,字段含 id、subject、status、description、blocking、blockedBy、effort、category、acceptance、edge_cases。subject 用祈使句描述结果;blocking 与 blockedBy 双向对应;status 仅 pending、in_progress、completed;effort 分 small(一次尝试,<15 分钟)、medium(2 轮,<45 分钟)、large(多轮,1 小时以上)。
使用方式:文件路径必须为当前工作目录下的 ./.prd,不得改名、加扩展名或放子目录,内容须为合法 JSON。构建时枚举未知项、映射依赖、把独立项分组为并行波次(每波最多 3 个)、把边界情况写成独立项或 edge_case 字段,然后写入磁盘并冻结,之后只能删除已完成项。执行时找出 blockedBy 为空的 pending 项,每波启动不超过 3 个并行子代理(subagent_type: gm:gm),每个子代理完成一项并验证,完成后从 .prd 删除并写回,再检查新解锁项并启动下一波,直到 .prd 为空。完成时 .prd 必须为空,否则停止钩子会阻止会话结束。
适用场景与限制:适合多步骤、有依赖和未知项的工作规划;若任务为单步、5 分钟内、无依赖和未知项,则不应使用。资料未提供收费、平台或效果信息。