ARTICLE DETAIL

建站实战干货

来自一线的建站与推广经验沉淀,每一条都经过真实交付验证。

Claude Code 自主循环持久化指南:解析 CLAUDE_CODE_LOOP_PERSISTENT 系统提示的设计与执行策略

2026/10/7 12:14:38 拓冰建站 浏览量
Claude Code 自主循环持久化指南:解析 CLAUDE_CODE_LOOP_PERSISTENT 系统提示的设计与执行策略 文档提示工程人工智能【免费下载链接】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 在用户离开期间定时被唤醒、持续推进已开启的工作。本文以本仓库收录的 Autonomous loop persistence guidanceCLAUDE_CODE_LOOP_PERSISTENT 系统提示为主体结合其配套的 loop tick、通知、心跳与操作准则等提示系统讲解持久化循环的触发场景、行动优先级、可逆性判据与收尾条件。读完本文你将理解 Claude Code 如何让 Agent 在无人值守时把已启动的事持续做完并掌握这一整套提示在源码中的组织方式与配套关系。一、持久化模式它解决什么问题在 Claude Code 的提示体系中自主循环存在两种互补的系统提示Autonomous loop check1484 tokens基础版循环检查定义用户离开时基于定时器被调用的通用行为定位是steward管家而非 initiator发起者Autonomous loop persistence guidanceCLAUDE_CODE_LOOP_PERSISTENT1630 tokens本篇文章的关联文档即持久化版指导。它在基础版之上强化了persistence持久性原则——当一切安静时不要立刻收手而是先拓宽一次搜索范围、检查是否有被推迟的事项并保持循环存活只有原始任务被证明彻底完成或用户明确要求停止时才允许停止。两者在仓库中通过 frontmatter 的name与description字段加以区分两文件均标注ccVersion: 2.1.246。持久化版本的标题级是## What to act on要行动的事项与## Repeated invocations重复调用正文开篇即点明其核心价值主张用户把你放飞到他们的工作上你提供的价值来自可靠地推进他们已经启动的事情。二、核心张力可逆行动要果断不可逆行动要克制持久化提示在开篇就用一整段阐述了自主运行中最关键的判断张力这是整个提示的决策基石信任是双向的用户信任你到足以让你自主运行但这种信任很容易丢失。对会话已确立的内容采取行动是安全且有价值的——这属于延续既有工作continuing established work。不可逆行动push、delete、send必须要求 transcript 中有明确的授权或者使用可逆的替代方案草稿draft、本地提交local commit、排队消息queued message。可逆行动编辑、测试、草稿、探索则偏向直接行动一次不必要的本地编辑成本几乎为零而一次停滞的循环stalled loop成本很高。不确定归属时的默认倾向当你不确定某件事属于延续既有工作还是发明新工作时只要 transcript 给了你任何合理线索就倾向于继续。这一判据与配套的 Autonomous operation guidelines 一脉相承后者同样要求对可逆的、跟随原始请求的行动直接执行不问 Want me to…?并只在破坏性操作或真正的范围变更scope change前停下等待用户决定。两者的区别在于持久化提示把可逆性成本做了更精细的量化表述——等待一个循环的代价远低于在不可逆事项上犯错。三、要行动的事项三级优先级持久化提示给出了明确的行动优先级从最高信号到最低信号依次递减1. 当前会话 transcript最高信号当前对话是你最高信号的来源——重读上面的 transcript因为那里的每件事都是用户曾积极参与过的。具体按以下强度排序信号强度内容行动方式最强正在一起构建的进行中 PR处理并解决 review 评论、诊断失败的 CI若是 flaky 可重新入队、修复合并冲突次强上次对话留下的未完成实现把半成品做完次强对话承诺过但未兑现的 Ill also… / next Ill…兑现承诺较弱但仍真实悬而未决的问题、被跳过的验证步骤、提及但未处理的边界情况、不需要新决策的自然延续回答 / 执行 / 处理提示特别强调一个执行原则找到这一类事项就去做——实际完成工作而不是描述可以做什么。运行测试而不是说你可以运行测试。自主运行的全部意义就在于用户离开期间工作真的被推进。2. 当前分支的 PR/MR次优来源当 transcript 没有剩余内容时提示指引转向 SCM 上的拉取/合并请求——这是有价值的维护工作但优先级低于延续用户的活跃工作。具体检查三项CI 状态对失败的 CI先拉取失败任务的日志再诊断——flaky 形态的失败超时、runner 挂掉、瞬时网络问题可以重新入队真实失败需要复现和最小修复未解决的 review 线程拉取评论、回应反馈、推送、并通过例如 GitHub GraphQL 的resolveReviewThreadmutation 解决线程或其他 SCM 的等价操作分支是否落后于 base推送前先检查是否有其他人在这期间推送到该分支——若有用rebase而非 merge保持历史干净。目标定义得很清晰让 PR 进入只待人工 review 即可合并的状态——用户回来时不应发现 PR 卡在那些本可由你处理的事情上。3. 分支清扫空闲时间的最佳用途当 CI 全绿、线程清空、还有空闲时间时提示建议对分支做一次清扫bug 猎杀或简化bug-hunt / simplification passes。这类工作能在 reviewer 发现之前先发现问题为所有人省下一次往返。四、持久性安静不是停止的理由这是持久化版本区别于基础版的核心差异。基础版 Autonomous loop check 在一切安静时要求用一句话说明并停止连续三次无事可做就降级为快速 CI 检查后停止而持久化版本明确反转了这一取向如果一切确实安静——没有对话工作、没有 PR 维护——用一句话说明并保持循环存活。在停止之前拓宽一次重读原始任务框架检查早期 tick 是否推迟过什么Ill wait for X查看用户拥有的兄弟 PR/分支。持久性是自主模式的意义所在。只有当原始任务被证明彻底完成或用户明确说要停止才允许停止。同时提示明确了一个边界节奏pacing即下一次 tick 前等待多久由附加到本 preamble 上的 per-mode reminder 处理不要在此处自行管理延迟。这指向仓库中另外一组动态节奏提示——例如 Autonomous loop tick (dynamic pacing) 要求每轮通过${SCHEDULE_WAKEUP_TOOL_NAME}重新武装传入字面量 sentinel、noop字段本轮无变化为true有变化为false否则循环将在本 tick 后结束Monitor fallback heartbeat guidance 则规定 Monitor 为主唤醒信号、delaySeconds保持 1200–1800 秒作为兜底心跳停止时需以stop: true关闭 ScheduleWakeup 并停掉 Monitor。可见保持循环存活不是一句空话而是有具体的工具调用协议支撑的。五、重复调用随调用历史调整范围持久化提示在## Repeated invocations一节定义了多次 tick 时的自适应策略看到更早的自主检查时相应调整范围上次检查遗留了用户未回答的问题行动成本取决于可逆性——可逆行动本地编辑、运行测试按你的最佳判断继续不可逆行动push、delete、send继续等待因为在不可逆的事情上犯错代价远高于多等一个周期连续三次及以上检查都无事可做先拓宽一次范围再考虑停止——重读原始任务、检查兄弟工作、寻找被跳过的验证或打磨步骤。提示给出的结论性判断是一个在工作一安静就退出的循环不如一个会等待的循环有价值。这与基础版连续三次无事可做就快速检查并停止形成了鲜明对照——持久化版本把等待本身视为一种价值产出这正是CLAUDE_CODE_LOOP_PERSISTENT名字中 PERSISTENT持久二字的落脚点。六、行动边界读分析自由、编辑测试谨慎、提交推送克制提示在结尾给出了最终的行动边界可概括为三层自由层读与分析完全自由——理解事物的状态没有爆炸半径has no blast radius谨慎层当你确信在延续既有工作时做编辑、跑测试克制层只有当明确延续用户已授权的事项或工作模式使意图显而易见例如修复你一直在共同构建的 PR 的 CI时才提交与推送。这一边界同样在仓库的其他提示中得到呼应例如 Autonomous operation guidelines 要求在结束 turn 前检查最后一段——如果它是计划、分析、问题、下一步列表或未完成工作的承诺Ill…现在就调用工具把它做完以及 Action safety and truthful reporting 对不可逆/外向行动的确认要求。它们共同构成了自主模式大胆推进、谨慎外放的完整安全模型。七、配套提示体系速览一张完整的自主循环提示地图从仓库结构看与本文关联文档配套的自主循环提示形成一个层次分明的体系理解它们有助于把握持久化指导在实际运行中的位置提示文件定位system-prompt-autonomous-loop-check.md基础版循环检查steward 定位安静即停system-prompt-autonomous-loop-persistence-guidance-claude-code-loop-persistent.md持久化版循环检查本文主体保持存活、拓宽后再停system-prompt-autonomous-loop-tick.md基于 cron 的 tick 注入沿用会话早期建立的循环指令找不到则视为 no-op且禁止在本 tick 内调用 ScheduleWakeupsystem-prompt-autonomous-loop-tick-dynamic-pacing.md动态节奏 tick本轮内必须重新调用 ScheduleWakeup 才能延续循环system-prompt-autonomous-loop-notification-guidance.md通知准则仅在循环无法推进或出现用户需要立即行动的状态变化如 CI 变红、review 改变计划时使用 PushNotification自己取得的进展不是触发条件每个状态只通知一次而非每个 tick 一次system-prompt-monitor-fallback-heartbeat-guidance.md动态循环的心跳与停止协议Monitor 主唤醒、1200–1800s 兜底、stop: true 收尾system-prompt-autonomous-operation-guidelines.md自主会话总体准则不问权限、先做完承诺的工作、证据不支持就不改系统状态其中 tick 系列提示还区分了两种运行载体cron 定期触发如 Autonomous loop tick 明示recurring cron 会自动触发下一次 tick不要在本 tick 内调用 ScheduleWakeup与ScheduleWakeup 动态自步进如 Autonomous loop tick (dynamic pacing) 要求以字面量 sentinel 作为prompt重新武装。持久化指导所强调的保持循环存活在动态载体下就直接落实为每轮重新调用 ScheduleWakeup这条硬性工具协议。八、落地实践建议基于上述提示设计可以提炼出几条可操作的工程实践适用于任何在无人值守场景下运行 Agent 循环的团队或个人以 transcript 为第一现场每次 tick 先重读会话记录优先处理进行中的 PR 与未完成的实现而不是急着寻找新工作把可逆性作为决策主轴本地编辑、测试、探索直接做push、delete、send 只在有明确授权时做否则用草稿、本地提交、排队消息替代PR 维护要有检查清单CI 状态 → review 线程 → 分支落后程度三层依次排查推前先查是否有人抢先推送冲突一律 rebase给循环设定拓宽后停止的收尾条件安静时先重读原始任务、检查被推迟事项、扫一眼兄弟分支再决定是否停止避免一安静就退出节奏交给专门的 pacing 层不要在循环逻辑里自行管理延迟动态模式下依赖 ScheduleWakeup 重武装与 Monitor 心跳cron 模式下依赖调度器自动触发通知遵循一状态一通知只为真正的阻塞或用户需要立即行动的变化发推送避免用自己取得的进展刷屏。结语CLAUDE_CODE_LOOP_PERSISTENT是 Claude Code 自主运行体系中关于持久性的一次明确设计取舍当基础版循环选择安静即止、避免噪音时持久化版本选择安静时拓宽、保持存活、除非证明完成。两者并存于 system-prompts 目录 中各自服务不同的无人值守场景。理解这套提示的决策逻辑——可逆性判据、三级行动优先级、PR 维护清单、以及持久性是自主模式的意义所在这一核心命题——不仅有助于解读 Claude Code 的行为也为设计自己的自主 Agent 循环提供了可借鉴的提示工程范式。文中所有提示内容均直接引用自本仓库system-prompts/目录下的对应 Markdown 文件frontmatter 中的ccVersion字段标注了各提示对应的 Claude Code 版本仓库 CHANGELOG.md 持续追踪这些提示随版本的演进。赞分享文档提示工程人工智能【免费下载链接】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 /loop tick 机制深度解析从 loop.md 任务执行到动态自步调循环的系统提示词设计Claude Code /loop tick 机制深度解析从 loop.md 任务执行到动态自步调循环的系统提示词设计 /loop tick 是 Claude文档提示工程人工智能Claude Code Auto Mode 系统提示词深度解析持续自主执行的权限边界、安全护栏与工作流设计Claude Code Auto Mode 系统提示词深度解析持续自主执行的权限边界、安全护栏与工作流设计 导读 Auto Mode自动模式是 Claud文档提示工程人工智能Ralph E2B 云沙箱执行指南在云端隔离环境运行 Claude Code 自主循环Ralph E2B 云沙箱执行指南在云端隔离环境运行 Claude Code 自主循环 本篇技术指南围绕 Ralph 项目Autonomous AI dev人工智能AI 应用自主智能体CLI开发工具创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考