swarm-planner

面向 Swarm 的规划器

创建包含明确任务依赖关系的实施计划，以优化并行 Agent 执行。此技能可在 Plan Mode 内外运行。

核心原则

1. 探索代码库：调查所用的架构、模式、现有实现、依赖项和框架。
2. 优先查阅最新文档：规划任务前，使用 Context7 查询任何外部库、框架或 API
3. 提出问题：在整个规划过程中，澄清歧义，并就范围、约束或优先级征求意见。任何时候都可以提问。
4. 明确依赖关系：每项任务都要声明其依赖项，以实现最大程度的并行化
5. 原子化任务：每项任务都可由单个 Agent 独立执行
6. 提交前先审查：由子 Agent 在最终确定计划前检查是否存在遗漏

流程

1. 调研

代码库调查：

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

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

• 如果架构不清晰或缺失，请停止并暂停，向用户征求意见（AskUserQuestions）后再继续。务必提供可供澄清的问题建议。
• 如果架构清晰，则跳过 1a，继续下一步。

2. 文档

获取文档（外部依赖项必需）：

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

这样可确保 API 与版本匹配、参数正确，并遵循当前最佳实践。

3. 停止并征求用户意见

如果有任何不清楚之处，或某项工作存在多种合理做法：

• 立即停止并提出澄清问题
• 不要对范围、约束或优先级作出假设
• 问题应能降低风险并消除歧义
• 务必提供可供澄清的问题建议。
• 如果有 request_user_input 或 AskUserQuestion 工具，请使用。

4. 创建依赖感知计划

使用以下格式，明确列出任务依赖关系：

任务依赖格式

每项任务都必须包含：

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

示例：

T1: [depends_on: []] Create database schema migration
T2: [depends_on: []] Install required packages
T3: [depends_on: [T1]] Create repository layer
T4: [depends_on: [T1]] Create service interfaces
T5: [depends_on: [T3, T4]] Implement business logic
T6: [depends_on: [T2, T5]] Add API endpoints
T7: [depends_on: [T6]] Write integration tests

依赖项为空或已满足的任务可并行执行（上方的 T1、T2）。

4. 保存计划

在当前工作目录（CWD）中保存为 <topic>-plan.md。

5. 子 Agent 审查

保存后，启动一个子 Agent 来审查计划：

Review this implementation plan for:
1. Missing dependencies between tasks
2. Ordering issues that would cause failures
3. Missing error handling or edge cases
4. Gaps, holes, gotchas.

Provide specific, actionable feedback. Do not ask questions.

Plan location: [file path]
Context: [brief context about the task]

如果子 Agent 提供了可执行的反馈，请先修订计划，再提交。

计划模板

# Plan: [Task Name]

**Generated**: [Date]

## Overview
[Summary of task and approach]

## Prerequisites
- [Tools, libraries, access needed]

## Dependency Graph

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

## Tasks

### T1: [Name]
- **depends_on**: []
- **location**: [file paths]
- **description**: [what to do]
- **validation**: [how to verify]
- **status**: Not Completed
- **log**: [leave empty, to be filled out later]
- **files edited/created**: [leave empty, to be filled out later]

### T2: [Name]
- **depends_on**: []
- **location**: [file paths]
- **description**: [what to do]
- **validation**: [how to verify]
- **status**: Not Completed
- **log**: [leave empty, to be filled out later]
- **files edited/created**: [leave empty, to be filled out later]

### T3: [Name]
- **depends_on**: [T1]
- **location**: [file paths]
- **description**: [what to do]
- **validation**: [how to verify]
- **status**: Not Completed
- **log**: [leave empty, to be filled out later]
- **files edited/created**: [leave empty, to be filled out later]

[... continue for all tasks ...]

## Parallel Execution Groups

| Wave | Tasks | Can Start When |
|------|-------|----------------|
| 1 | T1, T2 | Immediately |
| 2 | T3, T4 | Wave 1 complete |
| 3 | T5 | T3, T4 complete |
| ... | ... | ... |

## Testing Strategy
- [How to test]
- [What to verify]

## Risks & Mitigations
- [What could go wrong + how to handle]

重要事项

• 每项任务都必须包含明确的 depends_on 字段
• 根任务（无依赖项）可立即并行执行
• 不要实施——只创建计划
• 最终确定任务前，务必使用 Context7 查询外部依赖项
• 如有歧义，务必提出问题