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

/deep-planning 时,Cline 遵循一个四步过程,镜像高级开发者处理复杂功能的方式:彻底调查、讨论和澄清需求、详细规划,以及具有进度跟踪的结构化任务创建。
四步过程
第一步:静默调查
Cline 变成侦探,静静地探索你的代码库以理解其结构、模式和约束。他检查源文件、分析导入模式、发现类层次结构,并识别技术债务标记。没有评论,没有叙述 - 只是专注的研究。 在这个阶段,Cline 运行如下命令:- 查找代码库中所有类和函数定义
- 分析导入模式以理解依赖关系
- 发现项目结构和文件组织
- 识别 TODO 和技术债务
第二步:讨论和问题
一旦 Cline 理解了你的代码库,他会提出将塑造实现的针对性问题。这些不是通用问题 - 它们是特定于你的项目和你正在构建的功能的。 问题可能涵盖:- 澄清模糊的需求
- 在同样有效的实现方法之间选择
- 确认关于系统行为的假设
- 理解技术决策的偏好
第三步:实现计划文档
Cline 创建一个结构化的 markdown 文档(implementation_plan.md),作为你的实现蓝图。这不是模糊的大纲 - 而是具有确切文件路径、函数签名和实现顺序的详细规范。
计划包括八个全面的部分:
- 概述:目标和高级方法
- 类型:完整的类型定义和数据结构
- 文件:要创建、修改或删除的确切文件
- 函数:带签名的新函数和修改函数
- 类:类修改和继承详细信息
- 依赖项:包要求和版本
- 测试:验证策略和测试要求
- 实现顺序:分步执行序列
第四步:实现任务创建
Cline 创建一个引用计划文档并包含可跟踪实现步骤的新任务。任务带有读取计划每个部分的特定命令,确保实现代理(无论是你还是在执行模式下的 Cline)可以高效地导航蓝图。使用深度规划
通过输入/deep-planning 后跟你的功能描述来开始深度规划会话:
示例工作流程
以下是我如何为真实功能使用/deep-planning:
与计划/执行模式的集成
深度规划设计为与计划/执行模式无缝配合:- 在计划模式中使用
/deep-planning进行调查和规划阶段 - 生成的任务请求切换到执行模式进行实现
- 专注链自动跟踪实现步骤的进度
最佳实践
何时使用深度规划
对以下情况使用/deep-planning:
- 触及代码库多个部分的功能
- 需要仔细协调的架构更改
- 与外部服务的复杂集成
- 需要系统执行的重构工作
- 你通常会花时间画白板的任何功能
充分利用调查
让 Cline 彻底完成他的调查。计划的质量与他对你代码库的理解程度直接相关。如果你有他应该检查的特定区域,在你的初始请求中提及它们。审查计划
在开始实现之前始终审查implementation_plan.md。计划是全面的但不是不可变的 - 如果需要,你可以直接编辑它。将其视为你和 Cline 之间的协作文档。
跟踪进度
启用专注链后,你的实现进度会显示在任务标题中。随着 Cline 执行计划,每个完成的步骤都会自动标记,为你提供复杂实现的实时可见性。灵感
每当我要构建通常需要设计文档的东西时,我都会使用/deep-planning。我工作流程中的最近示例:
- 迁移认证系统:深度规划映射了每个端点,识别了所有认证接触点,并创建了避免破坏性更改的迁移计划。
- 添加实时功能:计划涵盖了 WebSocket 集成、事件处理、状态同步和断开连接的回退机制。
- 数据库架构重构:Cline 识别了所有受影响的查询,创建了迁移脚本,并规划了最小化停机时间的推出。
- API 版本实现:计划详细说明了路由更改、向后兼容层、弃用通知和客户端迁移路径。
/deep-planning 的力量在于它在实现之前强制进行深思熟虑的架构。这就像在你编写代码之前有一个高级开发者审查你的方法,除了那个开发者对你的整个代码库有完美的了解。
深度规划需要具有强推理能力的模型。它在最新一代模型(如 GPT-5、Claude 4、Gemini 2.5 或 Grok 4)上效果最好。较小的模型可能难以进行所需的全面分析。

