支持集群的规划器

创建具有明确任务依赖关系的实施方案，并针对并行代理执行进行优化。此技能可以在规划模式内部或外部运行。

核心原则

1. 探索代码库：研究所使用的架构、模式、现有实现、依赖项和框架。
2. 首先获取最新文档：在规划任务之前，对任何外部库、框架或 API 使用 Context7。
3. 提出问题：在整个规划过程中，随时澄清模糊之处，并就范围、约束或优先级寻求澄清。
4. 明确依赖关系：每个任务声明它所依赖的内容，从而实现最大程度的并行化。
5. 原子化任务：每个任务可由单个代理独立执行。
6. 移交前评审：子代理在定稿前对方案进行审查，查找漏洞。

流程

1. 研究

代码库调研：

• 架构、模式、现有实现
• 正在使用的依赖项和框架

1a. 可选：暂停并提出澄清性问题

• 如果架构不清晰或缺失，请暂停并向用户移交，并在继续之前请求用户输入（使用 AskUserQuestions）。始终为澄清性问题提供建议。
• 如果架构存在，跳过 1a 并进入下一步。

2. 文档

文档检索（外部依赖必需）：

对于项目中正在使用或将要使用的任何库、框架或 API，使用 Context7 技能或 MCP 获取当前文档。如果 Context7 不可用，则使用网络搜索。

这可确保 API 的版本准确性、参数正确性以及遵循当前最佳实践。

3. 暂停并请求用户输入

当任何事情不明确或有多种合理实现方式时：

• 立即停下来提出澄清性问题
• 不要对范围、约束或优先级做出假设
• 问题应旨在降低风险并消除模糊性
• 始终为澄清性问题提供建议。
• 如果可用，使用 request_user_input 或 AskUserQuestion 工具。

4. 创建依赖关系感知的方案

使用以下格式，以明确的依赖关系构建方案：

任务依赖关系格式

每个任务必须包括：

• id：唯一标识符（例如 T1、T2.1）
• depends_on：必须首先完成的任务 ID 数组（根任务为 []）
• description：任务完成的内容
• location：涉及的文件路径
• validation：如何验证完成

示例：

T1: [depends_on: []] 创建数据库模式迁移
T2: [depends_on: []] 安装所需包
T3: [depends_on: [T1]] 创建仓库层
T4: [depends_on: [T1]] 创建服务接口
T5: [depends_on: [T3, T4]] 实现业务逻辑
T6: [depends_on: [T2, T5]] 添加 API 端点
T7: [depends_on: [T6]] 编写集成测试

具有空/已满足依赖关系的任务可以并行运行（如上文的 T1、T2）。

4. 保存方案

保存到当前工作目录的 <主题>-plan.md 文件中。

5. 子代理评审

保存后，启动一个子代理来评审方案：

评审此实施方案，重点关注：
1. 任务之间缺失的依赖关系
2. 可能导致失败的排序问题
3. 缺失的错误处理或边缘情况
4. 差距、漏洞、注意事项。

提供具体、可操作的反馈。不要提问。

方案位置：[文件路径]
上下文：[关于任务的简要背景]

如果子代理提供了可操作的反馈，请在移交前修订方案。

方案模板

# 方案：[任务名称]

**生成时间**：[日期]

## 概述
[任务和方法摘要]

## 前提条件
- [所需的工具、库、访问权限]

## 依赖关系图

[任务依赖关系的可视化表示]
T1 ──┬── T3 ──┐
│ ├── T5 ── T6 ── T7
T2 ──┴── T4 ──┘

## 任务

### T1: [名称]
- **depends_on**: []
- **location**: [文件路径]
- **description**: [需要做什么]
- **validation**: [如何验证]
- **status**: 未完成
- **log**: [留空，稍后填写]
- **files edited/created**: [留空，稍后填写]

### T2: [名称]
- **depends_on**: []
- **location**: [文件路径]
- **description**: [需要做什么]
- **validation**: [如何验证]
- **status**: 未完成
- **log**: [留空，稍后填写]
- **files edited/created**: [留空，稍后填写]

### T3: [名称]
- **depends_on**: [T1]
- **location**: [文件路径]
- **description**: [需要做什么]
- **validation**: [如何验证]
- **status**: 未完成
- **log**: [留空，稍后填写]
- **files edited/created**: [留空，稍后填写]

[……为所有任务继续……]

## 并行执行组

| 批次 | 任务 | 可开始条件 |
|------|------|--------------|
| 1 | T1, T2 | 立即 |
| 2 | T3, T4 | 批次 1 完成 |
| 3 | T5 | T3, T4 完成 |
| ... | ... | ... |

## 测试策略
- [如何测试]
- [需要验证的内容]

## 风险与缓解措施
- [可能出现的问题 + 如何处理]

重要事项

• 每个任务必须有明确的 depends_on 字段
• 根任务（无依赖）可以立即并行执行
• 不要实施 – 只创建方案
• 在敲定任务之前，始终对外部依赖使用 Context7
• 在存在模糊之处时，始终提出问题