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

/deep-planning 时,Cline 会遵循一个四步流程,这与高级开发人员处理复杂功能的方式相似:透彻的调查、讨论和需求澄清、详细的规划以及带有进度跟踪的结构化任务创建。
四步流程
第一步:静默调查
Cline 变身为侦探,静默地探索你的代码库,以了解其结构、模式和约束。他检查源文件,分析导入模式,发现类层次结构,并识别技术债务标记。没有评论,没有叙述——只有专注的研究。 在此阶段,Cline 运行以下命令:- 查找代码库中所有类和函数的定义
- 分析导入模式以理解依赖关系
- 发现项目结构和文件组织
- 识别 TODO 和技术债务
第二步:讨论和提问
一旦 Cline 理解了你的代码库,他就会提出有针对性的问题,这些问题将塑造实施过程。这些问题并非泛泛而谈,而是针对你的项目和你正在构建的功能。 问题可能包括:- 澄清模糊的需求
- 在同样有效的实施方法之间进行选择
- 确认对系统行为的假设
- 了解技术决策偏好
第三步:实施计划文档
Cline 创建一个结构化的 Markdown 文档 (implementation_plan.md),作为你的实施蓝图。这不是一个模糊的提纲——它是一个详细的规范,包含确切的文件路径、函数签名和实施顺序。 该计划包括八个全面的部分:- 概述:目标和高层方法
- 类型:完整的类型定义和数据结构
- 文件:要创建、修改或删除的确切文件
- 函数:新增和修改的函数及其签名
- 类:类的修改和继承细节
- 依赖关系:包要求和版本
- 测试:验证策略和测试要求
- 实施顺序:分步执行序列
第四步:创建实施任务
Cline 创建一个引用计划文档并包含可跟踪实施步骤的新任务。该任务附带特定命令,用于读取计划的每个部分,确保实施代理(无论是你还是处于执行模式的 Cline)能够高效地浏览蓝图。使用深度规划
通过输入/deep-planning 加上你的功能描述来开始深度规划会话
示例工作流程
以下是我如何使用/deep-planning 来实现一个真实功能
1
启动规划
我输入
/deep-planning 实现 API 响应的缓存层2
静默调查
Cline 探索我的代码库,检查
- 当前的 API 结构和端点
- 现有数据流模式
- 数据库查询和性能瓶颈
- 配置和环境设置
3
有针对性的讨论
Cline 问我
- “我们应该使用 Redis 还是内存缓存?”
- “用户数据可接受的缓存失效时间是多少?”
- “你需要缓存失效 webhook 吗?”
4
计划创建
Cline 生成
implementation_plan.md,包含- 缓存服务类规范
- Redis 连接配置
- 带缓存逻辑的修改后的 API 端点
- 缓存键生成策略
- 不同数据类型的 TTL 配置
5
任务生成
Cline 创建一个新任务,包含
- 对实施计划的引用
- 用于读取特定部分的命令
- 每个实施步骤的可跟踪待办事项
- 请求切换到执行模式以进行执行
与计划/执行模式集成
深度规划旨在与 计划/执行模式 无缝协作- 在计划模式下使用
/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。较小的模型可能难以完成所需的全面分析。

