Claude in Chrome shortcuts_execute 工具解析：在侧边栏中启动快捷方式与工作流的异步执行机制

文档提示工程人工智能【免费下载链接】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 系统提示词仓库中的 shortcuts_execute 工具描述讲解 Claude in Chrome 浏览器扩展中快捷方式shortcut执行工具的工作机制它如何在侧边栏窗口中以当前标签页为上下文启动预置的自动化流程、如何与shortcuts_list配合完成先查询、后执行的标准调用链以及立即返回、不等待完成这一异步语义对调用方Agent设计会话流程的深远影响。读完本文你将掌握 shortcuts_execute 的完整调用序列、与工作流的互换关系以及如何将其嵌入 Claude in Chrome 整体浏览器自动化体系。工具定位Claude in Chrome 工具族中的执行入口在 Claude Code 的系统提示词体系中浏览器自动化能力由一组以mcp__claude-in-chrome__*为前缀的 MCP 工具提供README.md 的提示词索引中列出了这组工具的完整清单包括tabs_context_mcp获取 MCP 标签页组上下文、tabs_create_mcp/tabs_close_mcp标签页管理navigate、read_page、get_page_text、find页面浏览与内容提取read_console_messages、read_network_requests调试与网络观察javascript_tool页面脚本执行、gif_creatorGIF 录制、switch_browser浏览器切换shortcuts_list/shortcuts_execute快捷方式查询与执行其中shortcuts_execute是唯一以启动预置流程为职责的执行类工具其官方描述为Execute a shortcut or workflow by running it in a new sidepanel window using the current tab (shortcuts and workflows are interchangeable). Use shortcuts_list first to see available shortcuts. This starts the execution and returns immediately - it does not wait for completion.即通过在当前标签页的上下文中打开一个新的侧边栏窗口来执行快捷方式或工作流快捷方式与工作流可以互换使用执行前应先用shortcuts_list查看可用快捷方式执行启动后会立即返回不会等待流程完成。从文件头部 frontmatter 可见该描述元数据为name: Tool Description: Claude in Chrome shortcuts execute、description: Describes the Claude in Chrome shortcuts_execute tool for starting a shortcut or workflow in a side panel对应 Claude Code 版本ccVersion: 2.1.173并在 README.md 中登记为 61 tokens 的提示词片段。核心语义一快捷方式与工作流Shortcut / Workflow的互换性工具描述中明确声明shortcuts and workflows are interchangeable快捷方式与工作流可互换。这意味着两者共享同一执行通道无论用户配置的是单步快捷方式还是多步工作流对shortcuts_execute而言都是同一个启动动作工具本身不区分二者的结构差异面向结果的统一抽象调用方只需传入目标的名称标识无需关心目标内部编排了多少步骤、调用了哪些浏览器操作——这是将复杂多步流程封装为可复用指令的关键设计从语义推断可以推断快捷方式/工作流本质上是用户在 Claude in Chrome 侧边栏中预置的、可被反复调用的自动化流程模板shortcuts_execute的作用类似于按下预置流程的启动按钮。这一点对该工具的使用方式有直接指导意义Agent 不应把 shortcuts_execute 当作通用浏览器操作工具如导航、点击、读取页面而应将其视为触发用户预置流程的入口。核心语义二以当前标签页为上下文在新侧边栏窗口中运行工具描述包含两个重要的环境限定using the current tab使用当前标签页执行时以对话当前所处的标签页作为流程运行的上下文页面。这与仓库中 tabs_context_mcp 工具描述 强调的会话规范一致——每个新会话应通过tabs_create_mcp创建自己的标签页而不是复用旧会话的标签页 ID。因此在调用 shortcuts_execute 之前Agent 应当清楚当前标签页究竟是哪一个避免在错误的页面上触发流程。in a new sidepanel window在新的侧边栏窗口中执行过程会打开一个新的侧边栏窗口承载流程运行。这是一个值得注意的界面语义它意味着流程的运行界面与当前标签页分离侧边栏独立渲染用户可以在主页面不受干扰地看到流程执行情况。核心语义三异步启动——立即返回不等待完成工具描述最后一句是全文最关键的语义约束This starts the execution and returns immediately - it does not wait for completion.即shortcuts_execute是异步fire-and-forget启动语义调用该工具后Agent 会立即收到返回结果而不是等到整个快捷方式/工作流跑完流程的实际执行发生在侧边栏窗口的独立运行环境中与 Agent 的主对话循环并行推进因此Agent 不能把 shortcuts_execute 的返回结果当作流程的最终产物也不能据此宣称任务已完成。这直接呼应了仓库中 Claude in Chrome 浏览器自动化系统提示词 的通用原则自动化过程中的结果验证必须通过可观测手段完成。就 shortcuts_execute 而言这意味着流程产出页面变化、数据结果、日志输出需要 Agent 通过后续的浏览器自动化工具如read_page、read_console_messages主动观察与核实而不是依赖工具返回值。调用方在设计会话流程时应当把启动与验证完成拆分为两个阶段。标准调用链从启用到执行综合仓库中相关工具描述一次完整的 shortcuts_execute 调用遵循如下调用链这也是 Claude in Chrome 工具族的通用会话规范启用扩展若会话中尚无claude-in-chrome__或Claude_in_Chrome__前缀的工具应先调用一次 启用 Claude in Chrome 工具将浏览器自动化能力挂载到当前会话获取标签页上下文按 tabs_context_mcp 工具描述 的要求至少先调用一次tabs_context_mcp获知当前 MCP 标签页组内存在哪些标签页 ID如需在特定页面执行按 浏览器自动化系统提示词 的建议用tabs_create_mcp新建专属标签页除非用户明确要求复用现有标签页批量加载工具如果mcp__claude-in-chrome__*工具是延迟加载的按 延迟工具加载系统提示词 的要求在一次ToolSearch 调用中批量加载查询串支持逗号分隔的工具名列表并视任务需要加入 task-specific 工具切勿逐工具调用查询可用快捷方式调用shortcuts_list获取当前可用的快捷方式/工作流清单确认目标名称存在且拼写准确启动执行调用shortcuts_execute传入目标快捷方式/工作流工具在当前标签页上下文中打开新的侧边栏窗口并立即返回异步跟进流程运行期间或结束后通过read_console_messages、read_page等工具观察执行结果确认流程真实产出再向用户汇报。嵌入浏览器自动化体系配套的使用纪律shortcuts_execute 虽然语义简单但在使用时仍需遵守 Claude in Chrome 整体的使用纪律这些约束明确记录在 Claude in Chrome 浏览器自动化系统提示词 中避免兔子洞与死循环如果快捷方式执行后页面行为异常、工具调用连续 23 次失败、扩展无响应或页面加载超时应停止并向用户说明情况、征询处理方式而不是反复重试同一失败动作警惕阻塞性对话框浏览器弹窗alert/confirm/prompt会阻塞扩展接收后续命令若流程涉及可能触发确认框的元素如带删除确认的按钮应先提醒用户如已触发并失去响应需告知用户手动关闭对话框不跨会话复用标签页不要复用其他会话的标签页 ID标签页失效或导航出错时应重新调用tabs_context_mcp获取最新状态。这些纪律之所以对 shortcuts_execute 同样适用是因为它触发的是在侧边栏中独立运行的多步流程其副作用比单步工具调用更大、更不可控调用方更需要保持对浏览器状态的感知。在系统提示词仓库中的来源与证据关联文档本体tool-description-claude-in-chrome-shortcuts-execute.mdfrontmatter 标注ccVersion: 2.1.173正文即工具描述全文README 索引README.md 收录该提示词片段标注 token 数为 61并给出与本文一致的功能概括配套体系文档Claude in Chrome 浏览器自动化系统提示词含非延迟版本 system-prompt-claude-in-chrome-browser-automation-non-deferred-tools.md、延迟工具加载系统提示词、启用工具描述、标签页上下文工具描述。需要说明的事实边界仓库中目前仅此一个文件提及shortcuts_execute与shortcuts_list并未包含 shortcuts_list 的独立工具描述或快捷方式的创建/管理细节本文对二者协作关系的说明以工具描述原文为依据对快捷方式内部结构步骤编排方式仅作可以推断层面的表述不构成仓库外的事实断言。小结shortcuts_execute是 Claude in Chrome 工具族中面向预置流程触发的执行入口它以当前标签页为上下文、在新侧边栏窗口中启动快捷方式或工作流快捷方式与工作流通过同一通道互换执行其立即返回、不等待完成的异步语义要求调用方将启动与结果验证分离借助shortcuts_list先行确认目标、再配合其他浏览器自动化工具跟进观测。理解并遵循这一调用链与使用纪律是安全、可靠地把用户预置自动化流程接入 Claude Code 会话的关键。赞分享文档提示工程人工智能【免费下载链接】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点击查看免费下载相关推荐Conductor START_WORKFLOW 任务详解在工作流内部异步启动新的工作流执行Conductor START_WORKFLOW 任务详解在工作流内部异步启动新的工作流执行 Conductor 的 START_WORKFLOW 系统任务允后端流程编排工作流自动化微服务Operit 工作流启动前异常状态修复执行边界、持久化运行记录与调度重试机制Operit 工作流启动前异常状态修复执行边界、持久化运行记录与调度重试机制 导读 本文围绕 OperitAndroid 平台上的 AI Agent / AAI Agent人工智能大模型AI 应用工具调用本地部署MCP ClientsAgent 记忆GUI 自动化基于 Rube MCP 的 Fixer IO 自动化实战awesome-claude-skills 中工具发现—连接—执行三步工作流解析基于 Rube MCP 的 Fixer IO 自动化实战awesome claude skills 中工具发现—连接—执行三步工作流解析 这篇技术指南讲解AI 技能AI 插件人工智能工作流自动化上一篇browser-use 自动下载10 分钟把重复下载变成一句话任务下一篇SPDK未来发展方向存储技术趋势与SPDK路线图分析创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考