文档提示工程人工智能【免费下载链接】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 的自主循环Autonomous Loop允许 Agent 在用户离开时持续推进工作而 PushNotification 通知指南 定义了这类循环中何时应该打扰用户的完整判据只有循环无法继续、出现用户需要立即行动的状态变化或重大更新时才通知自己取得的进展永远不是触发条件。本文结合该提示词片段、PushNotification 工具描述与各自主循环 tick 提示词系统讲解自主循环的通知触发边界、去重原则与底层实现帮助你理解并复用于自己的 Agent 工作流设计。这份文档是什么自主循环通知指南在提示词体系中的位置system-prompts/system-prompt-autonomous-loop-notification-guidance.md是 Claude Code 系统提示词体系中的一个可复用片段fragment用于在自主循环 tick 提示词中注入通知纪律。其头部元数据定义了两个模板变量PUSH_NOTIFICATION_TOOL_NAME实际推送通知工具的名称即 PushNotification由运行时按版本解析注入LOOP_NOTIFICATION_TRIGGER_EXAMPLES通知触发场景的具体示例列表由运行时按配置注入。正文只有一句话的核心指令但它在体系中的位置很关键该片段通过LOOP_NOTIFICATION_GUIDANCE_FN函数占位符被追加到多个自主循环 tick 提示词的末尾包括cron 型自主循环 tick动态步进型自主循环 tickloop.md 任务型 tickcron 版 与 loop.md 任务型 tick动态步进版。也就是说凡是用户不在场、Agent 按定时器自主推进的循环都会携带这套通知纪律。什么时候该通知三类触发条件指南原文将触发条件归纳为三类对应变量${LOOP_NOTIFICATION_TRIGGER_EXAMPLES}展开的具体示例1. 循环无法继续推进必须等待用户。当 Agent 走到一个没有用户输入就无法前进的节点——例如需要用户做决策、批准或提供信息——这是最强信号。此时通知不是打扰而是让工作不被静默卡死。2. 出现了用户此刻就想行动的状态变化。即something landed that theyd want to act on now——用户不在场时发生的事实一旦知道就会立刻想处理。这与 后台 Monitor 通知指南 的口径一致推送那些会改变用户下一步该做什么的事件——出现了新错误、等待中的状态翻转了。3. 重大更新落地。指南给出两个代表性例子CI 变红CI went red构建失败意味着 PR 处于需要关注的状态符合自主循环检查提示词中诊断失败 CI、能重排队就重排队的职责边界见 autonomous loop check评审改变了计划a review changes the plan新的评审意见推翻了既定方向用户需要回来决定如何调整。这三类条件的共同点是事件的价值密度高、时效性强、且只有用户能处置。什么时候不该通知自我进展不是触发条件指南明确划出一条红线Progress you made yourself isnt a trigger — the transcript covers that.即Agent 自己完成的推进改了文件、跑了测试、修了 CI永远不构成通知理由。原因是这类信息已经完整落在会话转录transcript里用户回来后翻阅记录即可知晓不需要被实时打断。如果每个 tick 的进展都推送通知就会变成任务状态播报既没有行动价值又持续消耗用户注意力。这一原则与 autonomous loop check 中的另一条纪律互为呼应连续多轮无事可做时应缩窄为一次快速 CI 检查并单行汇报而不是逐轮叙述检查了什么——两者共同服务于不让转录被噪音填满、不让用户注意力被浪费的目标。一次状态一次通知去重原则指南收尾的约束是全文最容易被忽略却最重要的工程原则One ping per state, not per tick.自主循环按固定节奏反复触发cron 每 N 分钟一次或动态步进自行调度下一拍。如果循环每 tick 都检查CI 还是红的并每次都推送用户会在同一状态下收到无数条内容相同的通知。正确做法是以状态为粒度去重——同一个阻塞、同一个失败、同一个待决策事项只推一次只有当状态真正发生迁移红→绿、待决策→新决策时才产生新通知。这与 ScheduleWakeup noop 状态指南 的去噪思路一脉相承动态步进循环中连续noop: true的 tick 会在终端视图中被折叠合并为一条 streak避免长时间静默等待撑爆滚动区。通知与 tick 汇报共用同一哲学按状态变化汇报而非按时间频率汇报。PushNotification 工具通知机制的底层实现触发判据落地到具体工具上是 PushNotification 工具描述PUSH_NOTIFICATION_TOOL_NAME变量所指所规定的行为。它从实现层面支撑了上述通知纪律传递渠道。该工具在用户终端发送桌面通知若连接了 Remote Control远程控制还会同步推送到用户手机。无论哪条渠道它都在把用户从正在做的事会议、其他任务、晚饭中拉回当前会话——这正是通知的成本所在。信息格式硬约束。通知消息必须少于 200 字符、单行、无 markdown且以用户会采取行动的内容开头——build failed: 2 auth tests 比 task done 或一段状态转储信息量大得多。这从格式层面强制通知聚焦于行动价值而非过程汇报。在线跳过机制。当用户正活跃在终端前时Agent 的输出本身已经触达用户叠加通知反而冗余因此工具会自动跳过发送并明确说明。not sent 是一个正常且预期内的结果仅表示本次通知冗余、被关闭或无处可去——不应被当作失败去重试。默认倾向。工具描述给出与指南一致的默认值err toward not sending one——倾向于不发。不需要的通知会造成累积性的厌烦annoying in a way that accumulates只有当用户很可能已经走开且确有值得回来处理的事或用户明确要求通知时才发送。这个成本/收益不对称是整条通知纪律的出发点。与自主循环 tick 的集成方式通知指南不是独立运行的指令而是通过模板函数LOOP_NOTIFICATION_GUIDANCE_FN()在运行时展开追加到各 tick 提示词末尾。以 cron 型 tick 为例完整指令流为依据会话中既有的循环指令执行自主检查找不到则视为 no-op tick下一次 tick 由 recurring cron 自动触发不得在本 tick 内调用 ScheduleWakeup追加展开后的通知指南本片段。而 动态步进型 tick 略有差异它必须在本轮用哨兵值${AUTONOMOUS_LOOP_DYNAMIC_SENTINEL}再次调用 ScheduleWakeup 以续命循环并依noop取值标记本轮是否产生变化见 ScheduleWakeup 工具描述——随后同样追加通知指南。注意 loop.md 任务型 tick 中LOOP_NOTIFICATION_GUIDANCE_FN(!0)的参数形式说明不同 tick 类型可以携带不同参数化变体。在自主循环中实践通知纪律综合本片段与其配套提示词可在任何自主 Agent 循环中落地为四条可操作规则通知只发给用户回来才能处理的事需要决策的阻塞、失败的任务、改变计划的评审意见——三类缺一不可自己的进展写进转录不写进通知每次 tick 的工作记录由 transcript 承担通知只承载新状态同一状态只推一次以状态而非时间为粒度状态未迁移就不重复打扰格式服务行动单行、200 字符、无 markdown先写用户该做什么再写背景。这套策略的价值在于自主循环越可靠、tick 越频繁通知纪律就越重要——它能确保 Agent 离开期间的能力发挥不转化为对用户注意力的持续征税。而 Claude Code 以提示词片段 运行时变量注入的方式而非硬编码承载这套纪律也体现了其提示词体系高度可组合、可随版本演进的工程化设计相关变更记录见仓库 CHANGELOG 中 PushNotification 工具与自主循环提示词的演进条目。赞分享文档提示工程人工智能【免费下载链接】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 artifact-diagramming 技能解析Artifact 内联 SVG 制图的决策准则与实现机制Claude Code artifact diagramming 技能解析Artifact 内联 SVG 制图的决策准则与实现机制 本文基于 system_p文档知识库GHelper 完全指南华硕笔记本性能控制、风扇曲线与充电上限 3 步上手GHelper 完全指南华硕笔记本性能控制、风扇曲线与充电上限 3 步上手 GHelper 是一款面向华硕笔记本的单 exe 轻量控制工具免安装、无后台服务桌面应用系统编程Claude Code 定时循环任务实战/loop 技能、Cron 工具与钩子机制完整解析Claude Code 定时循环任务实战/loop 技能、Cron 工具与钩子机制完整解析 Claude Code 的 /loop 是内置的定时任务技能让文档教程AI 技能创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考