原始笔记

Plan Mode 与 AskUserQuestion 双剑合璧

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. 风险点和回滚方案

相关链接

Switch to English