文档基础理论自动计划模式

自动计划模式 (Auto Plan Mode)

自动计划模式是计划模式的进化版本,它结合了人工智能的判断能力和自动化执行的效率,在保证安全性的同时最大化开发效率。

什么是自动计划模式

自动计划模式是一种智能的执行策略,它会:

根据任务的复杂度和风险级别,自动决定是否需要用户确认,或者直接执行相对安全的操作。

与传统的计划模式不同,自动计划模式具备:

  • 智能风险评估能力
  • 动态执行策略调整
  • 自动化的安全检查
  • 渐进式的任务执行

工作原理

智能风险评估

自动计划模式会对每个任务进行多维度的风险评估:

📊 复杂度评估

  • 低复杂度: 单文件修改、简单配置更新
  • 中复杂度: 多文件修改、依赖关系调整
  • 高复杂度: 架构重构、系统集成更改

🎯 影响范围评估

  • 局部影响: 仅影响特定组件或功能
  • 模块影响: 影响整个功能模块
  • 全局影响: 可能影响整个应用系统

⚡ 可逆性评估

  • 完全可逆: 可以通过简单操作撤销
  • 部分可逆: 需要额外操作才能撤销
  • 不可逆: 撤销困难或不可能

动态执行策略

基于风险评估结果,自动计划模式会选择合适的执行策略:

执行策略分类

🚀 直接执行策略

适用场景:

  • 添加注释或文档
  • 简单的代码格式化
  • 单行代码修复
  • 配置参数微调

特点:

  • 立即执行,无需等待
  • 实时反馈执行结果
  • 自动错误恢复机制

⚡ 简化计划策略

适用场景:

  • 中等复杂度的功能添加
  • 多个相关文件的同步修改
  • 测试用例的批量更新

特点:

  • 展示简化版的执行计划
  • 在关键节点暂停确认
  • 支持中途调整策略

🛡️ 完整计划策略

适用场景:

  • 大规模代码重构
  • 架构模式变更
  • 数据迁移操作
  • 第三方集成修改

特点:

  • 详细的步骤分解
  • 用户完全控制执行节奏
  • 每步都有回滚机制

如何影响 Claude Code 的自动执行行为

Claude Code 没有独立的「自动计划模式」开关,自动行为由以下几个机制控制:

通过 CLAUDE.md 写入行为规则

在项目的 CLAUDE.md 里以自然语言描述任务边界,是最稳定的方式。Claude Code 会在每次会话开始时读取这份文件并遵循其中的规则:

# 执行策略
 
## 可以不询问直接执行的操作
- 添加/修改注释和文档
- 代码格式化(prettier/eslint)
- 单文件的简单 bug 修复
 
## 必须先说明计划再执行的操作
- 跨多个文件的重构
- 修改配置文件(package.json、tsconfig 等)
- 任何涉及数据库 schema 的操作

通过 settings.json 控制文件编辑行为

~/.claude/settings.json(全局)或项目 .claude/settings.json 中可以设置 autoAcceptEdits,让 Claude Code 在写文件时无需每次手动确认:

{
  "autoAcceptEdits": true
}
⚠️

autoAcceptEdits: true 会让 Claude Code 直接写入文件而不提示确认,建议仅在你清楚任务范围、配合 Git 使用时开启。

在会话中使用 —dangerously-skip-permissions 标志

启动时加上此标志可以跳过所有操作确认,适合在 CI/脚本环境中使用:

claude --dangerously-skip-permissions "运行测试并修复所有 lint 错误"

不建议在日常交互开发中使用,因为它会跳过所有安全确认。

安全机制

🔒 多重安全保障

⚠️

即使在自动计划模式下,Claude Code 也会保持严格的安全标准。

  1. 预执行检查

    • 语法验证
    • 依赖关系检查
    • 兼容性验证
  2. 执行中监控

    • 实时错误检测
    • 性能影响监控
    • 资源使用跟踪
  3. 执行后验证

    • 功能完整性检查
    • 测试用例执行
    • 回归测试验证

🔄 自动回滚机制

当检测到以下情况时,系统会自动回滚:

  • 编译错误或语法错误
  • 测试用例失败
  • 性能指标严重下降
  • 用户手动中断请求

最佳实践

项目初期设置

  1. 评估项目风险容忍度

    成熟项目建议在 CLAUDE.md 里把可自动执行的范围写得更窄(仅文档、格式化),实验性项目可以放宽到包含功能开发,但需要配合完整的测试覆盖。

  2. 建立安全基线

    • 配置完整的测试套件
    • 设置代码质量检查
    • 建立持续集成流水线

团队协作配置

团队共用一个项目时,在 repo 根目录的 CLAUDE.md 里写入统一的执行边界规则,比个人本地配置更可靠——所有人 clone 代码后即生效,不需要每个人单独配置。核心原则:把”必须确认的操作”写清楚,其余让 Claude 自己判断。

监控和调优

性能指标

自动计划模式会跟踪以下关键指标:

  • 执行成功率: 无需人工干预的任务占比
  • 时间节省: 相比传统计划模式的效率提升
  • 错误恢复率: 自动回滚成功的比例
  • 用户满意度: 基于反馈的质量评分

持续优化

# 优化策略示例
 
## 基于历史数据调整
- 成功率高的操作类型 → 降低风险等级
- 频繁失败的操作模式 → 提高安全检查
 
## 基于用户行为调整  
- 用户经常取消的计划类型 → 提高确认频率
- 用户信任的操作类型 → 增加自动执行范围

故障排查

常见问题

🚫

自动计划模式不工作

  1. 检查配置文件语法
  2. 验证权限设置
  3. 查看错误日志

排查思路

  • 行为不符合预期:先检查 CLAUDE.md 的规则描述是否足够清晰,模糊的指令会导致 Claude 自行判断
  • 文件被意外修改:确认 settings.json 里的 autoAcceptEdits 是否开启,关闭后每次写文件前都会有确认提示
  • 想查看当前设置:运行 claude config 可以打开交互式配置界面查看和修改可用选项

相关概念

核心阅读路径

基础理论页最好围绕主线阅读,而不是拆散看

这类概念页更适合作为方法论网络的一部分。先抓住主线页,再回到细分概念会更自然。

关于我