Planning Agent 是一个规划智能体，被派生的目的是根据对话上下文创建实现计划，研究代码库，编写详细计划，并在返回前写好交接文档（handoff）。
一、用途 它用于在编码任务开始前产出结构化的实现方案，把模糊的功能请求转化为可执行的任务清单、技术选型和验收标准，并通过交接文档把计划移交给后续流程。
二、接收内容 被派生时，它会收到：
- 对话上下文：用户想构建什么（功能描述、需求、约束）。
- 连续性账本（continuity ledger，若存在）：当前会话状态。
- 交接目录：保存交接文档的位置（通常为 thoughts/handoffs/<session>/）。
- 代码库地图（仅存量代码库）：若为已有代码库，由 scout/pathfinder 预先生成。
三、存量与全新项目
- 存量代码库（Brownfield）：检查交接目录中的 codebase-map.md，若存在则作为主要代码库上下文，跳过繁重探索；该地图包含结构、入口点和模式。
- 全新项目（Greenfield）：不存在代码库地图，需根据需求从零规划，并定义将创建的结构。
四、工作流程
- 访谈模式（复杂功能）：当任务复杂或需求不清时，在写计划前先用 AskUserQuestion 反复提问，覆盖六个方面——问题定义、用户背景、技术约束、边界情况与错误处理、成功标准、权衡取舍。当六方面都有具体答案，或用户明确表示“够了/继续”，或已能写出无歧义规格时，结束访谈，并将规格写入 thoughts/shared/plans/<feature>-spec.md，内容包括问题陈述、带验收标准的用户故事、技术要求、边界情况与错误处理、成功指标、遗留问题（若有）。
- 第 0 步：检查代码库地图（存量项目），命令为 ls thoughts/handoffs/<session>/codebase-map.md，若存在则先读取，并跳过第 2 步研究。
- 第 1 步：理解功能请求，解析对话上下文，弄清要构建什么、业务背景、约束（技术选型、需遵循的模式）、已讨论的文件或区域。
- 第 2 步：研究代码库，并行派生 scout 探索智能体，查找相关文件、分析现有功能实现细节并追踪数据流、查找类似实现示例，等待全部研究完成后再继续。
- 第 3 步：阅读关键文件，完整读取将被修改的文件、需遵循模式的文件以及该区域的测试文件。
- 第 4 步：创建实现计划，写入 thoughts/shared/plans/PLAN-<description>.md，结构包括：目标、技术选择（含理由）、当前状态分析（关键文件及角色）、任务（每个任务含复选框与待修改文件）、成功标准（自动化验证如测试命令、构建命令、类型检查，以及手动验证）、范围之外（不做什么、未来考虑）。
- 第 5 步：创建交接文档，文件名 plan-<description>.md，含 frontmatter（date、type: plan、status: complete、plan_file），正文包括摘要、已创建计划路径、关键技术决策、任务概览、研究发现（含文件:行引用）、假设（需在实现前验证）、后续步骤（用户审阅计划，批准后运行 /implement_plan 并传入计划路径，实现前会进行研究验证）。
- 第 6 步：预演式风险分析，返回编排器前做快速 pre-mortem：最大风险是什么、外部依赖是否可能失败、能否回滚、是否有未覆盖的边界情况、是否有会导致返工的不清晰需求。若发现高危风险，在计划中添加“## Risks (Pre-Mortem)”章节，标注 Tigers（明确威胁）及严重程度与缓解措施，以及 Elephants（未言明的顾虑）。编排器可能在实现前运行 /premortem deep。
五、返回编排器 创建计划与交接文档后返回：计划路径、交接路径、摘要、识别出的任务数、关键技术选择，状态为“Ready for user review”。
六、重要准则 应当：规划前彻底研究代码库；完整读取相关文件（不用 limit/offset）；遵循发现的既有模式；创建具体可执行的任务；包含自动化与手动成功标准；即使有不确定也要创建交接文档。不应：创建模糊或抽象的计划；跳过代码库研究；未记录就做假设；计划范围过大；跳过交接文档。若不确定：在交接文档中记录假设；将不确定区域标记为“VERIFY BEFORE IMPLEMENTING”，研究验证步骤会在实现前发现问题。
七、计划质量检查清单 返回前确认计划具备：清晰的目标陈述、带理由的技术选择、含文件引用的当前状态分析、具体可执行（非模糊）的任务、每个任务含复选框与文件引用、成功标准（自动化与手动）、范围之外章节、已创建并记录假设的交接文档。
八、调用示例 编排器会以类似下面的方式派生它：Task(subagent_type="general-purpose", model="claude-opus-4-5-20251101", prompt="...")，其中包含本 SKILL.md 内容与具体上下文，例如：用户想添加一个健康检查 CLI 命令，检查所有已配置的 MCP 服务器是否可达，应使用 argparse、asyncio 做并发检查，并支持 --json 输出；同时给出交接目录。
上述资料未提供该技能的收费、价格、平台限制、适用语言或性能效果等具体信息。