ARTICLE DETAIL

资讯详情

深耕编程入门与网站建设的一线实战洞察。

Claude Code 云代理启动确认协议:解读 “Cloud agent launched“ 系统提醒的机制与边界

Claude Code 云代理启动确认协议:解读 “Cloud agent launched“ 系统提醒的机制与边界 文档提示工程人工智能【免费下载链接】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 系统提示词体系中的 system-reminder-cloud-agent-launched.md当 Claude Code 在云端基础设施中成功启动一个云代理Cloud Agent时该系统提醒会携带内部元数据返回给当前会话并约束 Claude 只向用户给出简短、自然的启动确认而不得泄露内部字段、不得在完成通知到达前报告或预测结果。读完本文你将理解这条提醒的完整语义、三个元数据字段的含义、它与异步代理启动提醒的差异以及在云代理调度与运行链路中的位置。文档定位云代理启动链路的即时反馈节点该文档在仓库中的正式身份是System Reminder: Cloud agent launched其元信息注释YAML frontmatter给出了三项关键声明nameSystem Reminder: Cloud agent launcheddescription向 Claude 报告新启动云代理的内部元数据并指示其只给出简短的用户可见启动确认variables声明唯一模板变量CLOUD_AGENT_RESULT由宿主host在运行时注入启动结果对象。仓库根目录的 README.md 索引清单将本文档标记为242 tkstoken 成本约 242说明它在按版本维护的完整提示词清单中是一个体量适中、职责单一的运行时注入型提醒。结合 CHANGELOG.md 的版本记录该提醒与Async agent launched metadata提醒同期引入定位是将启动 ID 与结果位置标记为内部信息禁止在完成前暴露或预测结果并要求云代理启动只得到简短的用户确认后结束响应。核心机制拆解启动结果中的三个内部元数据字段提醒正文的第一句即划定边界Cloud agent launched. (This tool result is internal metadata — never quote or paste any part of it, including the ID below, into a user-facing reply.)随后呈现由${CLOUD_AGENT_RESULT}注入的三个字段system-prompts/system-reminder-cloud-agent-launched.md字段注入表达式语义taskId${CLOUD_AGENT_RESULT.taskId}云代理任务的内部标识符用于宿主侧追踪禁止出现在面向用户的回复中session_url${CLOUD_AGENT_RESULT.sessionUrl}云会话的访问地址属于内部运行元数据output_file${CLOUD_AGENT_RESULT.outputFile}结果输出文件路径仅在完成通知到达后才包含最终结果此前其中只有部分、仍在增长的运行事件日志output_file的语义值得特别注意文档明确指出final results land here only after the completion notification; until then it holds a partial, still-growing event log。也就是说这个文件在代理运行期间是一个持续增长的事件日志其内容不是最终结论Claude 若在完成通知前读取或引用它得到的将是未完成、不稳定的中间状态。行为约束等待完成通知禁止抢先报告提醒的第二段规定了时间线上的纪律The agent is running in the cloud. You will be notified automatically when it completes. Do not report or predict its results before that notification arrives.这构成了三个硬性规则不报告完成前不得把代理的阶段性成果当作结论告知用户不预测不得根据会话状态、事件日志或任何推断猜测最终结果等通知结果的可信来源只有自动到达的完成通知completion notification通知未到即视为结果未知。从实现角度看这是一种异步任务结果编排的防串扰机制启动动作的调用方当前会话与执行方云代理会话分离调用方通过通知而非轮询获取终态从而避免在上下文窗口内反复拉取增长中的日志、也避免向用户输出可能被后续推翻的中间结论。用户面对话协议转述而非回显简短即止提醒的最后一段规定了对用户的实际措辞方式In your own words, briefly tell the user what you launched — do not echo this tool result — and end your response.即用 Claude自己的话简要说明启动了什么例如启动了一个云端例程或后台云代理不得回显工具结果原文taskId、session_url、output_file 等均属禁止引用的内部内容说完即结束本轮回复不做额外展开。这条约束与仓库中内部元数据与用户可见输出分离的一贯设计一致类似地system-reminder-async-agent-launched-metadata.md 也声明agentId为内部 ID、禁止向用户提及system-reminder-async-agent-launched.md 则进一步禁止读取子代理的完整 JSONL 转录输出文件reading it will overflow your context。两者共同说明启动类提醒的核心价值是告诉 Claude 发生了什么、你能对外说什么、你不能碰什么而非把内部运行细节灌入上下文。姊妹机制对比云代理与异步代理的启动协议差异同一版本ccVersion 2.1.211中并存着三条启动类提醒对照阅读能更准确理解本文档的边界依据各文档的 frontmatter 与正文提醒文档核心对象关键规则system-reminder-cloud-agent-launched.md云端运行的云代理不引用元数据不报告/预测结果简短确认后结束回复system-reminder-async-agent-launched-metadata.md异步启动的子代理不暴露agentId可通过 SendMessage 以 agentId 继续该代理结果未知前不得报告/假设/预测system-reminder-async-agent-launched.md异步启动的子代理不重复该代理的工作不读取其 JSONL 转录输出文件避免上下文溢出可见云代理与异步代理共享不预测结果、等待通知的核心纪律区别在于云代理运行在隔离的云环境对应 agent-prompt-schedule-slash-command.md 中描述的 CCR 会话独立 git checkout、自带工具与可选 MCP 连接而非本地 cron 任务而异步子代理仍隶属于当前会话协作体系可通过 SendMessage 交互。云环境隔离与设备工具禁用提醒的呼应云代理运行在云端意味着它不在用户的电脑上。仓库中的 system-reminder-cloud-session-device-tools-disabled.md 从另一侧印证了这一点云会话无法在用户电脑上执行工具当用户请求操作本地电脑时必须明说该会话无法访问你的电脑而是在云环境中工作不得将该环境描述为用户电脑也不得重试或另寻路径。这与本文档agent is running in the cloud的定位互相印证——云代理/云会话的边界就是云环境本身本地设备不在其能力范围内。设计意图小结一条提醒为何同时包含信息与禁令从文档措辞与仓库结构可以推断这条提醒的设计意图推断基于上述文档证据非外部资料为何仍要注入元数据宿主需要让 Claude 感知到启动成功这一事实与结果落点output_file以便在收到完成通知前后做出正确的上下文衔接而不是凭空猜测为何禁止引用与预测taskId、session_url是宿主侧追踪用的内部标识回显会给用户带来噪声且无实操价值而代理运行中的事件日志是partial, still-growing的中间态抢先报告会造成事实偏差为何要求简短确认并结束启动动作本身已完成用户只需知道已启动、稍后通知过长或展开式回复会模糊异步任务的完成边界。综上system-prompts/system-reminder-cloud-agent-launched.md 是 Claude Code 云代理异步执行模型中的一个启动回执节点它以极小的 token 成本把运行事实告知模型、把内部细节挡在用户视野之外并用等通知的纪律保证最终结果只以权威方式交付。理解这一条提醒也就理解了整个云代理生命周期中启动 → 隔离运行 → 完成通知的上下文管理基调。赞分享文档提示工程人工智能【免费下载链接】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 后台任务代理协议claude 默认 Subagent 的状态机与纯文本汇报约定解读 Claude Code 后台任务代理协议 claude 默认 Subagent 的状态机与纯文本汇报约定 Anthropic/claude code/a文档知识库拆解 Claude Code 的 General Task Agent 提示词任务完成边界与精简汇报机制拆解 Claude Code 的 General Task Agent 提示词任务完成边界与精简汇报机制 导读 agent prompt general ta文档提示工程人工智能Serial Studio 双无人机遥测实战多源 TCP 数据流、卫星图传与双向命令控制全解析Serial Studio 双无人机遥测实战多源 TCP 数据流、卫星图传与双向命令控制全解析 本文以 Serial Studio 仓库自带的 Dual Dr文档提示工程人工智能上一篇解决Wedecode常见问题分包缺失、代码乱码等10大痛点解决方案下一篇LangChain4j中Qwen2.5模型工具调用JSON参数格式异常问题解析创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考
返回列表