多彩编程 多彩编程MZPH · CODE BLOG
ARTICLE DETAIL

文章详情

深耕前端与后端开发技术的一线实战笔记与踩坑复盘。

Claude Code 计划批准提醒(Plan Approved)机制解析:从批准到编码的完整衔接

Claude Code 计划批准提醒(Plan Approved)机制解析:从批准到编码的完整衔接 文档提示工程人工智能【免费下载链接】claude-code-system-promptsAll parts of Claude Codes system prompt, 27 builtin tool descriptions, sub agent prompts (Plan/Explore/Task), utility prompts (CLAUDE.md, compact, statusline, magic docs, WebFetch, Bash cmd, security review, agent creation). Updated for each Claude Code version.项目地址https://gitcode.com/gh_mirrors/cl/claude-code-system-prompts点击查看免费下载导读计划模式Plan Mode是 Claude Code 中先规划、后编码的核心工作流Agent 先以只读方式探索代码库并撰写计划文件用户批准后再进入实现阶段。system-reminder-plan-approved.md正是这条流程的批准信号——当用户通过 ExitPlanMode 确认计划后系统立即注入该提醒向 Agent 宣告可以开始编码同时把计划文件路径与批准后的计划全文回传给上下文。本文以该提醒文件为主线结合仓库中完整的计划模式提示词体系工作流、阶段指引、工具描述、Explore/Plan 子代理提示词系统讲解批准提醒的触发链路、变量语义、编辑态处理及其在计划模式闭环中的位置帮助读者理解 Claude Code 计划模式的状态机设计与提示词工程实现。一、批准提醒在整个计划模式闭环中的位置Claude Code 的计划模式并不是一个孤立开关而是一套由多个系统提醒System Reminder串起来的五阶段状态机。system-reminder-plan-approved.md处于这条链路的终点出口它标志着规划态正式结束实现态正式开始。从仓库中的提示词文件可以完整还原这一闭环进入规划态Agent 调用 EnterPlanMode 工具请求进入计划模式参见 tool-description-enterplanmode.md。该工具说明明确指出对于非平凡的实现任务新功能、多方案可选、涉及多文件改动、架构决策、需求不明确、用户偏好重要等场景应优先使用而打字错误、单函数改动、纯研究任务则不需要规划。只读探索system-reminder-plan-mode-is-active.md 提醒 Agent 处于只读阶段禁止写任何文件应按探索代码库 → 识别相似特性 → 评估多种方案 → 必要时用 AskUserQuestion 澄清 → 设计具体实现策略 → 用 ExitPlanMode 提交计划的顺序工作。五阶段工作流system-reminder-plan-mode-workflow.md 给出了完整工作流其中 Phase 1初始理解见 system-reminder-plan-mode-is-active-5-phase.md并行启动 Explore 子代理探索代码库、Phase 2设计见 system-reminder-plan-mode-phase-2-design.md启动 Plan 子代理设计实现方案、Phase 3评审、Phase 4撰写最终计划见 system-prompt-phase-four-of-plan-mode.md以及 Phase 5调用 ExitPlanMode。提交批准tool-description-exitplanmode.md 描述 ExitPlanMode 工具——它不接收计划内容作为参数而是从已写入的计划文件读取计划向用户展示批准对话框。批准生效用户点击批准后注入system-reminder-plan-approved.mdAgent 获准开始编码。仓库中还包含两个状态迁移的配套提醒重新进入计划模式时使用 system-reminder-plan-mode-re-entry.md要求先读取既有计划文件判断是覆盖还是增量修改退出计划模式时使用 system-reminder-exited-plan-mode.md通知 Agent 现在可以编辑、运行工具、执行操作。二、批准提醒的模板结构与四个注入变量system-reminder-plan-approved.md的正文非常精炼全部内容围绕四个模板变量展开变量名注入时机与含义PLAN_FILE_PATH计划文件的保存路径实现阶段可随时回查TEAM_PARALLELIZATION_NOTE团队协作场景下的并行化提示可选注入仅在团队并行化上下文存在时出现PLAN_WAS_EDITED布尔标志标记用户是否在批准前手动编辑过计划APPROVED_PLAN批准后的计划全文直接注入上下文模板的完整正文如下原文结构User has approved your plan. You can now start coding. Start with updating your todo list if applicable Your plan has been saved to: ${PLAN_FILE_PATH} You can refer back to it if needed during implementation.${TEAM_PARALLELIZATION_NOTE} ## ${PLAN_WAS_EDITED?Approved Plan (edited by user):Approved Plan}: ${APPROVED_PLAN}值得注意的三个设计细节第一句就明确授权User has approved your plan. You can now start coding. 直接解除了规划态的只读约束并顺势要求如果适用先更新你的 todo list——这与 Claude Code 中任务管理优先的工程习惯一致也呼应了仓库中 tool-description-todowrite-reminder.md 等任务管理提醒的存在。计划文件持久化提醒明确告知计划已保存到PLAN_FILE_PATH实现过程中可以随时回查。这意味着批准提醒与计划文件Plan File是解耦的——ExitPlanMode 不携带计划参数批准后 Agent 依然可以按需重新读取计划文件内容。编辑态区分如果用户在批准前手工修改了计划PLAN_WAS_EDITED为真标题会显示为Approved Plan (edited by user)否则显示Approved Plan随后紧跟APPROVED_PLAN全文。这个细节在提示词工程上很有价值它让 Agent 明确意识到最终以用户编辑后的版本为准避免按旧版本计划实现造成偏差。从模板文件的元数据头name、description、ccVersion、variables可以看出这类系统提醒由 Claude Code 运行时按版本注入ccVersion: 2.1.235表明该模板随 Claude Code 各版本持续演进。本仓库即以此为定位维护全部系统提示词详见 README.md。三、从批准到编码Agent 的后续动作链批准提醒本身是授权开关但它之后的行为模式由配套提示词共同约束。综合仓库内容Agent 收到批准提醒后的典型动作链如下第一步更新 todo list如果适用。提醒原文直接给出该指令与任务管理类系统提示词system-reminder-todowrite-reminder.md、system-prompt-tool-usage-task-management.md相衔接。第二步回查计划文件。通过PLAN_FILE_PATH重新读取计划全文如果用户编辑过PLAN_WAS_EDITED则以注入的APPROVED_PLAN编辑版为准。仓库中的 system-reminder-plan-file-reference.md 展示了计划文件的另一种引用形态——当计划文件作为附件注入时会同时携带ATTACHMENT_OBJECT.planFilePath与ATTACHMENT_OBJECT.planContent并指示如果该计划与当前工作相关且尚未完成继续推进它这与批准提醒的语义相互补充。第三步按计划执行编码。计划文件本身的撰写规范见 system-prompt-phase-four-of-plan-mode.md已经为可执行性做好了铺垫要求计划以Context 段落开篇说明改动动机只保留推荐方案而非罗列备选命名关键待修改文件对重复模式描述一次并列出代表性路径不逐文件逐行枚举引用已找到的可复用函数与工具及其路径并包含端到端验证章节运行代码、使用 MCP 工具、跑测试。第四步验证收尾。计划中的验证章节与 system-reminder-plan-mode-workflow.md 中在实现前理清所有遗留问题的目标首尾呼应确保批准后进入的实现阶段是可验证、可回归的。四、批准约束为什么批准只能通过 ExitPlanMode 表达要理解批准提醒的触发时机必须先理解计划模式的批准纪律。system-reminder-plan-mode-approval-tool-enforcement.md 对此有硬性规定Agent 的一轮对话只能以两种方式结束调用AskUserQuestion澄清问题或调用ExitPlanMode请求批准工作坊模式下另有第三种结束方式严禁以文本提问、AskUserQuestion或其他任何方式询问这个计划可以吗我该继续吗——这类请求必须统一走ExitPlanMode。同样tool-description-exitplanmode.md 强调 ExitPlanMode 仅适用于需要编写代码的实现类任务纯研究、理解代码库的任务不应触发。并且它不从参数读取计划而是读取 Agent 已写入的计划文件——这正是批准提醒中PLAN_FILE_PATH存在的原因批准对话框展示的就是计划文件内容批准后该路径被回传给 Agent 供实现时引用。从源码级提示词结构可以推断PLAN_WAS_EDITED标志对应的是用户在与 ExitPlanMode 对话框交互时对计划文本的编辑行为用户可直接修改批准弹窗中的计划修改后APPROVED_PLAN注入的即为编辑后版本同时标题切换为带 (edited by user) 后缀的形态防止 Agent 误用过期方案。五、配套组件Explore 子代理与 Plan 子代理批准提醒虽然是流程终点但计划质量取决于前序探索与设计阶段。仓库中与之配套的两类子代理提示词值得一并理解Explore 子代理agent-prompt-explore.md文件搜索专家严格只读禁止创建/修改/删除文件、禁止重定向写文件、禁止任何改变系统状态的命令可用 glob、正则搜索、read 及只读 shell 命令ls、git status、git log、git diff、find、grep、cat、head、tail 等。Phase 1 中由主 Agent 并行启动最多PLAN_V2_EXPLORE_AGENT_COUNT个任务范围确定时通常 1 个即可范围不确定或多区域涉及时才用多个并各自分配搜索焦点参见 system-reminder-plan-mode-is-active-5-phase.md。Plan 子代理Phase 2 设计阶段见 system-reminder-plan-mode-phase-2-design.md基于 Phase 1 的探索结果设计实现方案可并行启动最多PLAN_V2_AGENT_COUNT个对大多数任务默认至少启动 1 个用于校验理解与权衡备选只有打字错误、单行改动、简单重命名等琐碎任务才可跳过复杂任务可启用多个从简单性 vs 性能 vs 可维护性根因 vs 变通 vs 预防最小改动 vs 干净架构等不同视角输出方案。这些子代理的输出汇聚为最终计划文件再经 Phase 4 的撰写规范打磨最终由 ExitPlanMode 提交给用户——批准提醒正是在这个完整链条上解锁编码的那一声令下。六、实战视角如何围绕批准提醒设计自己的 Agent 工作流对于基于本仓库提示词体系自建或定制 Claude Code 工作流的开发者批准提醒文件提供了几个可直接借鉴的模式用授权信号解耦只读约束规划态的所有只读约束见 system-reminder-plan-mode-is-active.md 的Do NOT write or edit any files yet由批准提醒显式解除。在设计自己的多阶段 Agent 时应让阶段切换由明确的运行时信号驱动而非依赖 Agent 自行推断状态。计划持久化 可回查计划写入独立文件PLAN_FILE_PATH批准后仍保留路径供实现引用。这保证了计划与执行解耦、可重复读取、可被重入流程复用参见 system-reminder-plan-mode-re-entry.md重新进入规划态时先读旧计划文件判断不同任务则覆盖、同任务继续则清理过期部分后修改。显式标记用户编辑态PLAN_WAS_EDITED用条件表达式生成不同标题将用户介入程度显式注入上下文。这种做法在提示词工程中很有参考价值——凡是用户可能在中间环节改动产物的流程都值得用一个布尔标志 条件标题让 Agent 明确感知最终权威版本。执行入口先更新任务清单批准后的第一条指令是更新 todo list与任务管理工具TodoWrite体系衔接保证长任务在实现阶段有可跟踪的进度结构。七、小结system-reminder-plan-approved.md看似只有寥寥数行却是 Claude Code 计划模式状态机中最关键的批准 → 编码转折信号它以PLAN_FILE_PATH提供计划回查锚点以PLAN_WAS_EDITED区分用户是否干预过计划以APPROVED_PLAN注入最终权威内容并以更新 todo list 后开始编码衔接实现阶段。结合本仓库完整的计划模式提示词族五阶段工作流、阶段指引、EnterPlanMode/ExitPlanMode 工具描述、Explore/Plan 子代理提示词、重入与退出提醒可以清晰看到Claude Code 通过一套精细的运行时注入提示词把先规划后编码的产品理念落实为可约束、可追踪、可回查的工程化流程。这正是本仓库system-prompts 目录所维护的核心资产值得系统提示词工程与 Agent 工作流设计者深入研读。赞分享文档提示工程人工智能【免费下载链接】claude-code-system-promptsAll parts of Claude Codes system prompt, 27 builtin tool descriptions, sub agent prompts (Plan/Explore/Task), utility prompts (CLAUDE.md, compact, statusline, magic docs, WebFetch, Bash cmd, security review, agent creation). Updated for each Claude Code version.项目地址https://gitcode.com/gh_mirrors/cl/claude-code-system-prompts点击查看免费下载相关推荐Claude Code Plan Mode 五阶段工作流深度解析从只读探索到计划批准的完整管线Claude Code Plan Mode 五阶段工作流深度解析从只读探索到计划批准的完整管线 本篇技术指南以 Claude Code 系统提示仓库clau文档提示工程人工智能Claude Code 团队协作中的计划审批等待机制深入解析 Plan Awaiting Team-Lead Approval 系统提醒Claude Code 团队协作中的计划审批等待机制深入解析 Plan Awaiting Team Lead Approval 系统提醒 导读 本文聚焦 Cl文档提示工程人工智能Claude Code System Prompts 解析Plan File Reference 系统提醒与计划文件续作机制Claude Code System Prompts 解析Plan File Reference 系统提醒与计划文件续作机制 Plan File Refere文档提示工程人工智能创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考
返回列表