文档提示工程人工智能【免费下载链接】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 系统提示词仓库中的 Data: Query result pending command count 文档并结合仓库内中断interrupt系列与 SDK 帧时间戳系列文档系统讲解 Claude Code 查询结果query result中pending command count字段的准确定义、取值语义、缺失条件及其在客户端宿主中的实际应用场景。读完本文你将理解如何正确判断是否还有用户轮次会自动到来避免把计数为 0误当成会话已经结束。一、字段定位查询结果携带的队列回执Claude Code 在与宿主host应用、SDK 客户端交互时会以结构化结果query result的形式返回每一次模型调用turn的产物。pending command count正是这类查询结果上携带的一个字段其官方定义为User-initiated sends still waiting in the command queue when this result was produced.即在当前结果产生的那一刻仍然停留在命令队列中、由用户发起但尚未被消费的发送send数量。它本质上是命令队列快照回答了一个宿主界面非常关心的问题当这一轮结果送达用户后是否还会在没有用户再次输入的情况下自动产生下一轮对话。该文档条目在仓库中收录于 system-prompts/data-query-result-pending-command-count.md其 front matter 标注了ccVersion: 2.1.242属于 Claude Code 2.1 系列版本的协议描述。仓库的 CHANGELOG.md 中也记录了该字段文档随版本新增与 Rate limit unified windows、Upload device hook template request 一同发布并在 README.md 的 Data 分类下列出167 tokens。二、取值语义大于 0 与等于 0 意味着什么大于 0还有轮次会自动到来当该字段取值大于 0 时意味着至少还有一个用户轮次以及对应的结果会在没有进一步输入的情况下紧随其后。这里有一个前提限定barring cancellation——除非中间发生取消。也就是说排队中的用户消息仍然可能被中断请求interrupt取消因此大于 0并不构成必然还会有一轮的硬保证而是在没有取消动作的前提下会有一轮。等于 0两种可能取值 0 时存在两种语义确实没有待处理的用户发送——队列已清空当前这一轮就是最后一轮直到用户再次输入会话正在结束——会话通过end_session显式收尾或一个关闭shutdown在轮次中途被闩锁latched此时积压的命令队列会被直接丢弃因此计数为 0。第二点非常关键0 并不必然意味着会话自然结束也可能意味着会话被强制收尾并丢弃了队列。宿主应用在渲染会话是否结束的状态时不应把 0 当作唯一的判定依据而应结合会话生命周期信号如end_session、关闭闩锁综合判断。三、计数粒度统计的是待处理发送不是剩余结果数该字段最容易被误读的一点在于其计数粒度Queued sends may coalesce into fewer turns, so this counts pending sends, not remaining results.Claude Code 的命令队列允许将多个排队中的用户发送合并coalesce进更少的轮次。因此队列中可能有 3 条待处理的用户发送但经过合并后只会产生 1 个或 2 个后续轮次该字段报告的数值是待处理的发送条数pending sends而不是即将到来的剩余结果数remaining results。这一点与仓库中 Data: Interrupt receipt still queued field 文档描述的队列行为互相印证一旦一批命令被出队并合并进单个轮次代表该批次的 UUID 就成了该轮的代表成员取消非代表成员的 UUID 不会改变其内容仍然运行的事实。也就是说合并发生在出队与轮次装配阶段而pending command count是在结果产生时对仍停留在队列中的发送所做的快照统计因此它反映的是队列入口状态而非下游轮次数。四、计数范围仅限用户发起的发送字段语义明确排除了一类条目System-generated queue entries are not counted.命令队列并非只承载用户消息。从仓库内相关文档可以推断队列中还会出现系统生成的条目例如定时触发器cron triggers投递的自动唤醒提示会话恢复auto-resume产生的延续指令后台任务通知等其他由 harness 内部入队的命令。这些系统生成的队列条目不计入pending command count。因此该字段是用户发起、且仍在等待的发送数的专用指标宿主界面可以据此判断用户还有多少输入在路上而不会被系统内部活动干扰。这一点与 Data: Interrupt receipt still queued field 中仅列出带 UUID 戳记的主线程消息、内部入队的 UUID 可能出现的覆盖性说明形成呼应——中断回执still_queued覆盖的范围是UUID 戳记的主线程命令而pending command count覆盖的范围是用户发起的发送两者的口径并不完全一致使用时需要区分。五、缺失条件什么情况下字段不出现该字段并非在所有查询结果上都存在官方文档明确了两种缺失场景Absent on fatal startup results and on surfaces without a command queue.致命启动错误结果fatal startup results当会话在启动阶段发生致命错误、连正常轮次都无法执行时其结果上不携带该字段——此时队列状态本身已无意义没有命令队列的表面surfaces without a command queue并非所有宿主表面都实现了命令队列机制。在没有命令队列的表面上运行的结果自然不会有该字段。据此宿主在解析查询结果时应将字段缺失与字段为 0视为两种不同状态缺失说明该表面/该结果不提供队列信息0 则说明队列当前为空或会话正在收尾。六、与其他队列相关字段的协作关系与中断回执字段的关系命令队列的取消与存活语义由中断interrupt协议侧的三个字段承载与pending command count构成队列生命周期的完整视图Data: Interrupt receipt still queued field列出在一次中断后仍然存活将运行的 UUID。它详细描述了首个命令 prewait 窗口内的闩锁latch行为、合并批次的取消粒度以及列表为空不代表没有命令会运行等覆盖性注意事项Data: Interrupt receipt cancelled field仅当请求设置了cancel_queued:true时出现列出被这次中断取消的 UUID每个 UUID 会同步发出终态cancelled生命周期Data: Interrupt cancel queued parameter定义cancel_queued请求参数——置为 true 时中断会取消队列中及 prewait 窗口内的全部 UUID 戳记主线程命令。从源码结构看pending command count与上述三个字段都源自同一个命令队列状态机still_queued/cancelled是中断瞬间对队列的逐 UUID 快照而pending command count是查询结果产生瞬间对用户发起发送的计数快照。两者互补中断回执回答哪些命令会/不会运行计数字段回答还有多少用户输入在排队。与 SDK 帧时间戳字段的关系仓库中另外两个 SDK 时序字段也间接描绘了命令队列的存在Data: SDK frame_received_wall_ms field记录触发发送的帧到达会话的时刻配合frame_enqueued_wall_ms与turn_started_wall_ms可将服务器持久化到轮次开始之间的时段拆分为传输transit、输入循环处理、在命令队列上的等待以及轮次自身工作四段Data: SDK frame_intake_phases_ms field将帧从接收到入队的耗时按步骤拆解其中user_frames_ahead表示输入循环花在处理更早用户帧上的时间。这些字段的存在证实了命令队列 用户帧排队确实是 Claude Code 会话主循环的标准结构也是pending command count语义成立的基础设施前提。七、实际应用宿主如何正确使用该字段综合以上语义宿主应用、thin client 或 SDK 集成方在使用该字段时应遵循以下判断准则场景字段状态正确解读正常轮次结束后续无输入0队列为空等待用户下一次输入用户连发多条消息 0无需用户再输入至少还会自动产生一轮除非被取消会话正在收尾end_session / shutdown 闩锁0队列被丢弃不应期待后续轮次致命启动错误结果缺失无队列信息可用无命令队列的表面缺失该表面不提供该指标三个易错点不要把 0 当作会话结束的唯一信号——0 也可能是队列清空后的正常空闲状态必须结合会话生命周期信号区分不要用该字段预测剩余轮次数——由于发送可能合并进更少轮次该字段只反映待处理发送数不要把它当作系统活动指示器——系统生成的队列条目cron 触发、自动恢复延续等不计入该字段。八、小结pending command count是 Claude Code 查询结果协议中一个精确定义的队列快照字段统计用户发起的、仍在命令队列中等待轮次的发送数量。它大于 0 预示后续轮次自动到来等于 0 则可能是队列清空或会话收尾在致命启动结果与无命令队列的表面上缺失且不统计系统生成的条目、不以剩余结果数为粒度。对于构建 Claude Code 宿主界面、SDK 客户端或自动化编排工具的开发者而言正确理解该字段的取值边界是准确呈现会话进行状态、避免误判会话结束的前提。如需进一步探究相关协议细节可继续阅读仓库中的 Data: Interrupt cancel queued parameter、Data: Interrupt receipt still queued field、Data: Interrupt receipt cancelled field 三篇中断协议文档以及 Data: SDK frame_received_wall_ms field 与 Data: SDK frame_intake_phases_ms field 两篇队列时序文档它们共同勾勒出 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点击查看免费下载相关推荐Claude Code 中断回执 cancelled 字段全解析批量取消排队命令的同步清单与生命周期语义Claude Code 中断回执 cancelled 字段全解析批量取消排队命令的同步清单与生命周期语义 本文基于 Claude Code 系统提示词仓库文档提示工程人工智能OpenClaw 命令队列Command Queue深入解析多会话并发、队列模式与消息转向机制OpenClaw 命令队列Command Queue深入解析多会话并发、队列模式与消息转向机制 本文系统讲解 OpenClaw 进程内的命令队列CommAI 应用AI Agent交互助手后端即时通讯网关Claude Code rewindFiles 的 skippedLinks 字段链接安全拒绝的计数语义与 dry-run 行为解析Claude Code rewindFiles 的 skippedLinks 字段链接安全拒绝的计数语义与 dry run 行为解析 本文深入解析 Claud文档提示工程人工智能创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考