用途:为规划代理提供端到端规划流程,把某项功能拆分为多个可实施的阶段,产出 plan.md 与各阶段文件。
主要能力与流程:
- 完整读取模板(PLAN-TEMPLATE.md、PHASE-TEMPLATE.md),这些模板的每个章节均为必需。
- 创建目录结构:主目录 plans/{YYMMDD}-{feature-name}/,以及 reviews/planning/ 与 reviews/code/。
- 创建任务列表,主题前缀为 [Plan],设置 owner 为代理名并带结构化元数据;创建前先用 TaskList 检查是否已有任务,若存在则用 TaskGet 找到第一个 pending 或 in_progress 的任务并从该任务继续,不重建列表。
- 读取代码库参考(每种文件类型读取一个),以保证代码块符合真实项目模式,而非凭记忆编写。
- 创建 plan.md,补齐除 Phase Table 行以外的全部章节。
- 检查点 1:向编排器发送计划摘要并等待批准,未获批准前不进入下一步。
- 迭代创建各阶段文件,加入 Phase Table 行,写完整阶段文件,并运行校验器检查占位内容、TDD 顺序与文件是否创建。
- 检查点 2:汇报完成情况后进入空闲。
必要用法:资料给出模板路径如 $CLAUDE_PROJECT_DIR/.claude/skills/create-plan/references/PLAN-TEMPLATE.md、PHASE-TEMPLATE.md;校验命令形如:
echo '{"cwd":"."}' | uv run $CLAUDE_PROJECT_DIR/.claude/hooks/validators/validate_no_placeholders.py
--directory plans/{folder} --extension .md
(另有 validate_tdd_tasks.py、validate_new_file.py)。
限制与约束:每个阶段应能在一个上下文窗口内完成;阶段过多或上下文溢出会导致输出不一致;代码块若偏离项目模式会被审查标记为返工。资料中未提供具体功能、收费与平台信息。