⚡

Swarm-ReadyPlanner swarm-planner

创建并行多代理执行的依赖关系感知实施计划，适用于软件开发中的项目管理和任务协调。

DevOps 0 次安装 0 次浏览 更新于 3/5/2026

Swarm-Ready Planner

创建具有明确任务依赖关系的实施计划，优化并行多代理执行。这项技能可以在计划模式内或外部运行。

核心原则

  1. 探索代码库：调查架构、模式、现有实现、依赖关系和使用的框架。
  2. 首先获取最新文档：在使用任何外部库、框架或API之前使用Context7进行查询。
  3. 提问：在整个计划过程中澄清模糊不清的地方，寻求关于范围、限制或优先级的澄清。随时。
  4. 明确依赖关系：每个任务声明它依赖于什么，实现最大并行化。
  5. 原子任务：每个任务都可以由单个代理独立执行。
  6. 审核后再提交：在最终确定之前，子代理会审核计划是否有遗漏。

流程

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: []] 创建数据库架构迁移
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. 保存计划

保存到<topic>-plan.md在当前工作目录。

5. 子代理审核

保存后，生成一个子代理来审核计划：

审核此实施计划：
1. 任务之间的缺失依赖关系
2. 会导致失败的排序问题
3. 缺失的错误处理或边缘情况
4. 遗漏、漏洞、陷阱。

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

计划位置：[文件路径]
上下文：[关于任务的简要上下文]

如果子代理提供可操作的反馈，在提交之前修订计划。

计划模板

# 计划：[任务名称]

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

## 概览
[任务和方法的总结]

## 先决条件
- [所需工具、库、访问权限]

## 依赖图

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


## 任务

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

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

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

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

## 并行执行组

| 波次 | 任务 | 何时可以开始 |
|------|-------|----------------|
| 1 | T1, T2 | 立即 |
| 2 | T3, T4 | 第一波次完成后 |
| 3 | T5 | T3, T4完成后 |
| ... | ... | ... |

## 测试策略
- [如何测试]
- [要验证什么]

## 风险与缓解措施
- [可能出错的地方+如何处理]