Plan Mode + AskUserQuestion 双剑合璧
两套"先规划、后动手"机制的结合使用。
对比:两种模式定位
| 特性 | Plan Mode | AskUserQuestion |
|---|---|---|
| 侧重 | 代码层面精密解耦 | 业务逻辑需求对齐 |
| 触发 | /plan 命令 |
prompt 中强制调用工具 |
| 权限 | 锁定写权限 | 正常权限,暂停执行 |
| 产出 | 执行计划 | SPEC.md 业务蓝图 |
| 适用 | 老项目、跨文件重构 | 新项目、复杂业务逻辑 |
Plan Mode(原生计划模式)
命令
/plan
Shift+Tab # 快捷键切换
适用场景
| 场景 | 说明 |
|---|---|
| 老项目维护 | 已有大量业务代码,需确保不破坏现有逻辑 |
| 跨多文件重构 | 修改核心底层逻辑,牵一发动全身 |
| 强制只读审查 | 防止 AI 盲目改动,锁定写权限 |
Prompt 示例
/plan
我需要将系统现有的 Session 认证机制全面重构为 JWT 双令牌机制
(包含 Access Token 和 Refresh Token 刷新逻辑)。
请深度扫描 @users/models.py、@users/views.py 以及 @settings.py
中的中间件配置。制定详细重构步骤,重点排查迁移期间如何保持
向下兼容。先不要修改任何代码。
AskUserQuestion(访谈模式)
触发方式
无需 /plan,在正常模式下通过 prompt 强制调用工具。
适用场景
| 场景 | 说明 |
|---|---|
| 新项目从零起步 | 本地无代码上下文,需从产品维度理清 |
| 业务逻辑极复杂 | 技术栈简单,但业务边界/安全漏洞多 |
| 生成 SPEC.md | 需产出永久项目文档供团队评估 |
Prompt 示例
我想构建一个【用户数据异步导出为 CSV 并通过邮件发送给用户】的功能。
请作为资深系统架构师和产品经理对我进行深度访谈。
请必须调用 AskUserQuestion 工具来向我提问,
暂停自动化执行并等待我的回答。
不要问显而易见的问题,请深挖我可能没有考虑到的硬核难点:
1. 技术实现(如大文件内存优化、异步队列选择)
2. 安全与防刷(如越权下载防御、接口 Rate Limit)
3. UI/UX 异步状态反馈与失败重试补偿
请连续逐步地面试我,直到涵盖所有隐患。
最后,将所有对齐的细节梳理并写入根目录的 SPEC.md。
双剑合璧终极工作流
graph TD
A[1. AskUserQuestion 访谈] --> B[产出 SPEC.md]
B --> C[2. /clear 清空上下文]
C --> D[开启 /plan]
D --> E[结合代码库 + SPEC.md 制定执行计划]
E --> F[3. 新 Session 落地实现]
步骤详解
Step 1: 业务对齐(AskUserQuestion)
通过访谈逼迫 Claude 帮你兜底产品和架构漏洞,产出 SPEC.md。
Step 2: 记忆洗牌(/clear)
倒空对话中的废话和错误尝试,轻装上阵。
/clear
Step 3: 精准手术(/plan)
锁死写权限,让 Claude 拿着 SPEC.md 去盘点本地代码,出具行级执行计划。
/plan
根据 @SPEC.md 中的需求,扫描相关代码并制定执行计划。
列出所有需要修改的文件和具体改动内容。
Step 4: 一键执行
确认计划无误后退出 /plan,执行实现。
Prompt 模板库
访谈模式模板
我需要实现 [功能名称]。
请作为资深架构师对我进行深度访谈,必须调用 AskUserQuestion 工具。
请深挖以下方面的隐患:
- [技术难点列表]
- [安全风险列表]
- [边界情况列表]
最后将结论写入 SPEC.md。
计划模式模板
/plan
根据 @SPEC.md 的需求,分析现有代码并制定执行计划:
1. 需要修改的文件列表
2. 每个文件的具体改动
3. 依赖关系和执行顺序
4. 风险点和回滚方案
相关链接
- 02_explore_plan_implement - 计划模式的标准工作流
- 05_session_management -
/clear记忆净化详解 - 03_subagent - 大规模任务可调用 subagent