claude-code/docs/safety/plan-mode.mdx

61 lines
1.9 KiB
Plaintext
Raw Normal View History

2026-04-01 09:16:41 +08:00
---
title: "计划模式"
description: "先看后做——给 AI 一个只读的探索阶段"
---
{/* 本章目标:解释 Plan Mode 的设计理念 */}
## 问题场景
你说"重构这个模块"AI 立刻开始改代码——但你还没搞清楚它打算怎么改。等改了一半发现方向不对,已经来不及了。
## Plan Mode 的解决方案
计划模式给对话加了一个"只读阶段"
<Steps>
<Step title="进入计划模式">
AI 自主判断任务需要规划(或用户主动触发),进入计划模式
</Step>
<Step title="探索阶段">
在这个阶段AI 只能使用读取和搜索类工具——不能编辑文件、不能执行命令
</Step>
<Step title="形成计划">
AI 把理解和方案写入计划文件,提交给用户审阅
</Step>
<Step title="用户审批">
用户阅读计划,提出修改意见或直接批准
</Step>
<Step title="退出计划模式">
计划被批准后AI 恢复全部工具权限,按计划执行
</Step>
</Steps>
## 权限的自动收窄与恢复
计划模式的精妙之处在于**自动改变权限上下文**
- 进入时:系统自动保存当前权限模式,切换为"只读"
- 退出时:系统自动恢复之前的权限模式
AI 和用户都不需要手动调整权限设置。
## 什么时候该用计划模式
| 场景 | 是否需要计划 |
|------|-------------|
| 修复一个明确的 typo | 不需要,直接修 |
| 添加一个简单的函数 | 不需要 |
| 重构一个大模块 | 需要——先搞清楚影响范围 |
| 涉及多个文件的 feature | 需要——先统一方案 |
| 不确定该怎么做 | 需要——让 AI 先调研 |
## 计划模式 + 任务系统
计划模式通常与任务系统配合使用:
1. 在计划模式中AI 把实施步骤创建为任务列表
2. 用户审批计划(包含任务列表)
3. 退出计划模式后AI 按任务列表逐项执行
4. 用户可以通过任务列表追踪进度