工具描述:ExitPlanMode 退出计划模式
Tool Description: ExitPlanMode
v2.1.14Description for the ExitPlanMode tool, which presents a plan dialog for the user to approve
当您处于计划模式,并且已经将计划写入计划文件,准备请求用户批准时,请使用此工具。
此工具的工作原理
- 您应该已经将计划写入计划模式系统消息中指定的计划文件
- 此工具不将计划内容作为参数——它会从您写入的文件中读取计划
- 此工具仅用于发出信号,表明您已完成计划,并准备好让用户审阅和批准
- 用户审阅时将看到您计划文件的内容
何时使用此工具
重要提示: 仅当任务需要规划一个需要编写代码的任务的实现步骤时,才使用此工具。对于您正在收集信息、搜索文件、读取文件或通常试图理解代码库的研究任务——不要使用此工具。
使用此工具前
确保您的计划完整且明确:
- 如果您对需求或方法有未解决的问题,请先使用 AskUserQuestion(在早期阶段)
- 一旦您的计划最终确定,请使用此工具来请求批准
重要提示: 不要使用 AskUserQuestion 来询问“这个计划可以吗?”或“我应该继续吗?”——这正是此工具的作用。ExitPlanMode 本质上就是请求用户批准您的计划。
示例
- 初始任务:“在代码库中搜索并理解 vim 模式的实现”——不要使用退出计划模式工具,因为您不是在规划任务实现步骤。
- 初始任务:“帮我实现 vim 的 yank 模式”——在您完成规划任务实现步骤后,使用退出计划模式工具。
- 初始任务:“添加处理用户身份验证的新功能”——如果不确定身份验证方法(OAuth、JWT 等),请先使用 AskUserQuestion,然后在明确方法后使用退出计划模式工具。
英文原文 / English Original
Use this tool when you are in plan mode and have finished writing your plan to the plan file and are ready for user approval.
How This Tool Works
- You should have already written your plan to the plan file specified in the plan mode system message
- This tool does NOT take the plan content as a parameter - it will read the plan from the file you wrote
- This tool simply signals that you're done planning and ready for the user to review and approve
- The user will see the contents of your plan file when they review it
When to Use This Tool
IMPORTANT: Only use this tool when the task requires planning the implementation steps of a task that requires writing code. For research tasks where you're gathering information, searching files, reading files or in general trying to understand the codebase - do NOT use this tool.
Before Using This Tool
Ensure your plan is complete and unambiguous:
- If you have unresolved questions about requirements or approach, use AskUserQuestion first (in earlier phases)
- Once your plan is finalized, use THIS tool to request approval
Important: Do NOT use AskUserQuestion to ask "Is this plan okay?" or "Should I proceed?" - that's exactly what THIS tool does. ExitPlanMode inherently requests user approval of your plan.
Examples
- Initial task: "Search for and understand the implementation of vim mode in the codebase" - Do not use the exit plan mode tool because you are not planning the implementation steps of a task.
- Initial task: "Help me implement yank mode for vim" - Use the exit plan mode tool after you have finished planning the implementation steps of the task.
- Initial task: "Add a new feature to handle user authentication" - If unsure about auth method (OAuth, JWT, etc.), use AskUserQuestion first, then use exit plan mode tool after clarifying the approach.