> ## Documentation Index
> Fetch the complete documentation index at: https://cat.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# 深度规划命令

`/deep-planning` 将 Cline 转变为一个细致的架构师，他会调查你的代码库，提出澄清问题，并在编写任何代码之前创建全面的实现计划。

![深度规划命令展示调查和规划过程](https://storage.googleapis.com/cline_public_images/docs/assets/deep-planning.png)

当你使用 `/deep-planning` 时，Cline 遵循一个四步过程，镜像高级开发者处理复杂功能的方式：彻底调查、讨论和澄清需求、详细规划，以及具有进度跟踪的结构化任务创建。

## 四步过程

### 第一步：静默调查

Cline 变成侦探，静静地探索你的代码库以理解其结构、模式和约束。他检查源文件、分析导入模式、发现类层次结构，并识别技术债务标记。没有评论，没有叙述 - 只是专注的研究。

在这个阶段，Cline 运行如下命令：

* 查找代码库中所有类和函数定义
* 分析导入模式以理解依赖关系
* 发现项目结构和文件组织
* 识别 TODO 和技术债务

### 第二步：讨论和问题

一旦 Cline 理解了你的代码库，他会提出将塑造实现的针对性问题。这些不是通用问题 - 它们是特定于你的项目和你正在构建的功能的。

问题可能涵盖：

* 澄清模糊的需求
* 在同样有效的实现方法之间选择
* 确认关于系统行为的假设
* 理解技术决策的偏好

### 第三步：实现计划文档

Cline 创建一个结构化的 markdown 文档（`implementation_plan.md`），作为你的实现蓝图。这不是模糊的大纲 - 而是具有确切文件路径、函数签名和实现顺序的详细规范。

计划包括八个全面的部分：

* **概述**：目标和高级方法
* **类型**：完整的类型定义和数据结构
* **文件**：要创建、修改或删除的确切文件
* **函数**：带签名的新函数和修改函数
* **类**：类修改和继承详细信息
* **依赖项**：包要求和版本
* **测试**：验证策略和测试要求
* **实现顺序**：分步执行序列

### 第四步：实现任务创建

Cline 创建一个引用计划文档并包含可跟踪实现步骤的新任务。任务带有读取计划每个部分的特定命令，确保实现代理（无论是你还是在执行模式下的 Cline）可以高效地导航蓝图。

> [!TIP]
>
> 深度规划与[专注链](https://cat.mintlify.site/features/focus-chain.md)配合得很好。实现步骤自动成为具有实时进度跟踪的待办事项列表，保持复杂项目的组织和进度。

## 使用深度规划

通过输入 `/deep-planning` 后跟你的功能描述来开始深度规划会话：

```
/deep-planning 添加具有 JWT 令牌和基于角色访问控制的用户认证
```

Cline 将立即开始他的调查。你会看到他读取文件并运行命令来理解你的代码库。一旦他收集了足够的上下文，他会在创建计划之前与你进行讨论。

## 示例工作流程

以下是我如何为真实功能使用 `/deep-planning`：

**1. 启动规划**

我输入 `/deep-planning 为 API 响应实现缓存层`

**2. 静默调查**

Cline 探索我的代码库，检查：

* 当前 API 结构和端点
* 现有数据流模式
* 数据库查询和性能瓶颈
* 配置和环境设置

**3. 针对性讨论**

Cline 问我：

* "我们应该使用 Redis 还是内存缓存？"
* "用户数据的可接受缓存陈旧度是多少？"
* "你需要缓存失效 webhook 吗？"

**4. 计划创建**

Cline 生成 `implementation_plan.md`，包含：

* 缓存服务类规范
* Redis 连接配置
* 带缓存逻辑的修改 API 端点
* 缓存键生成策略
* 不同数据类型的 TTL 配置

**5. 任务生成**

Cline 创建新任务，包含：

* 对实现计划的引用
* 读取特定部分的命令
* 每个实现步骤的可跟踪待办事项
* 切换到执行模式进行执行的请求

## 与计划/执行模式的集成

深度规划设计为与[计划/执行模式](https://cat.mintlify.site/features/plan-and-act.md)无缝配合：

* 在计划模式中使用 `/deep-planning` 进行调查和规划阶段
* 生成的任务请求切换到执行模式进行实现
* 专注链自动跟踪实现步骤的进度

这种分离确保规划专注于架构，而实现专注于执行。

## 最佳实践

### 何时使用深度规划

对以下情况使用 `/deep-planning`：

* 触及代码库多个部分的功能
* 需要仔细协调的架构更改
* 与外部服务的复杂集成
* 需要系统执行的重构工作
* 你通常会花时间画白板的任何功能

### 充分利用调查

让 Cline 彻底完成他的调查。计划的质量与他对你代码库的理解程度直接相关。如果你有他应该检查的特定区域，在你的初始请求中提及它们。

### 审查计划

在开始实现之前始终审查 `implementation_plan.md`。计划是全面的但不是不可变的 - 如果需要，你可以直接编辑它。将其视为你和 Cline 之间的协作文档。

### 跟踪进度

启用专注链后，你的实现进度会显示在任务标题中。随着 Cline 执行计划，每个完成的步骤都会自动标记，为你提供复杂实现的实时可见性。

## 灵感

每当我要构建通常需要设计文档的东西时，我都会使用 `/deep-planning`。我工作流程中的最近示例：

* **迁移认证系统**：深度规划映射了每个端点，识别了所有认证接触点，并创建了避免破坏性更改的迁移计划。

* **添加实时功能**：计划涵盖了 WebSocket 集成、事件处理、状态同步和断开连接的回退机制。

* **数据库架构重构**：Cline 识别了所有受影响的查询，创建了迁移脚本，并规划了最小化停机时间的推出。

* **API 版本实现**：计划详细说明了路由更改、向后兼容层、弃用通知和客户端迁移路径。

`/deep-planning` 的力量在于它在实现之前强制进行深思熟虑的架构。这就像在你编写代码之前有一个高级开发者审查你的方法，除了那个开发者对你的整个代码库有完美的了解。

> [!NOTE]
>
> 深度规划需要具有强推理能力的模型。它在最新一代模型（如 GPT-5、Claude 4、Gemini 2.5 或 Grok 4）上效果最好。较小的模型可能难以进行所需的全面分析。

对于不需要广泛规划的简单任务，考虑使用 [/newtask](https://cat.mintlify.site/features/slash-commands/new-task.md) 创建带上下文的专注任务，或者如果前进的路径清楚，直接跳到实现。


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.