循环预算守护
在每次循环运行前后检查 token 预算与运行日志，超支或无任务时自动提前退出。
证据：该技能本身不请求额外权限，也未发现恶意行为或数据外泄风险。仓库包含SECURITY.md，建议最少权限和路径拒绝列表，且MIT许可。但技能要求读取并可能修改loop-budget.md和loop-run-log.md，未提供明确的用户确认机制或回滚方案；外部效果（如退出循环）可能影响自动化流程，但未明确限制。因此减去以反映缺乏明确的用户确认和恢复机制。
证据：技能指令相对清晰（开始和结束时读写文件），但未提供测试套件或执行证据。仓库有CI工作流和测试脚本，但技能路径的测试覆盖未知。静态阅读无法验证关键路径，且异常输入处理（如文件不存在或格式错误）未说明，失败反馈机制不明确。故可靠性较低。
证据：技能针对明确的场景（预算检查）设计，适用于循环工程。触发条件（开始和结束时）语义明确，受众（使用AI编码代理的开发人员）清晰。但未明确能力边界和非适用场景，也未提及对中国大陆网络环境的支持。技能核心功能依赖于本地文件，不依赖海外服务，因此环境兼容性较好。
证据：技能文件结构简单，有描述和步骤，但缺乏版本、更新历史和维护责任说明。仓库有README.md和SECURITY.md，但技能本身缺少详细的示例、FAQ和已知限制。未发现明确的版本控制或变更日志。因此扣分。
证据：技能描述了预期任务（预算检查、运行日志记录），但未提供实际输出示例或验证其直接可用性。边际价值可能有限，因为用户可能手动监控预算。静态阅读无法验证结果正确性。故得分低。
证据：仓库有CI工作流（audit.yml）和测试脚本，但技能本身无直接测试证据。关键声明（如自动退出）未经过第三方验证。静态阅读无法独立复现。故得分低。
- 该技能可能修改loop-budget.md和loop-run-log.md文件，运行前请确保有备份或版本控制。
- 技能未明确处理文件缺失或格式错误等异常情况，需要用户自行监控。
- 静态审查无法验证技能的实际效果，建议在受控环境中测试后再用于生产。
这个 Skill 能做什么，适合哪些场景？
这是一个专为 AI 编码代理循环运行设计的预算管理技能。它要求在每个循环迭代的开始和结束时运行，通过读取 `loop-budget.md` 和 `loop-run-log.md` 来监控每日 token 消耗。当花费达到每日上限的 80% 时，进入仅报告模式；达到 90% 且存在高优先级任务时，可交由预算协商技能处理；达到 100% 或有暂停标志时立即退出。同时，它还会在无任务可做时快速退出，并在结束时向运行日志追加一条 JSON 记录。该技能用于防止 token 超支，确保循环运行高效且可控。
读取 loop-budget.md 获取每日上限和暂停标志；读取 loop-run-log.md 最近 24 小时记录；汇总当前模式的 token 估算值；根据消费比例决定是否进入仅报告模式、提前退出或调用预算协商技能；检查 STATE.md 中是否有可操作项，若无则快速退出；每次运行结束时向 loop-run-log.md 追加一条包含运行时长、项目数、行动数、升级数、token 估算值及结果的 JSON 记录；在自我限流时向 loop-budget.md 的“本周期警报”部分追加一行。
- 使用 Claude Code 或 Codex 运行高频循环（如 CI 清理、PR 保姆）的开发者，希望在无任务时避免浪费 token 并确保快速退出。
- 需要严格执行每日 token 预算的团队，通过预算守护在达到 80% 和 90% 时触发不同响应，防止超支。
- 运行多模式循环的工程师，希望在每个循环开始和结束时自动记录 token 消耗，便于成本分析。
- 自动化循环中需要紧急停止机制的用户，通过设置 `loop-pause-all` 标志或达到 100% 消费时立即退出。
- 希望确保循环运行不仅高效而且可审计的开发者，通过 JSON 日志记录每次运行的关键指标。
这个 Skill 有哪些优点和局限？
- 明确的预算阈值（80%、90%、100%）提供分阶段响应，避免突然中断。
- 支持通过 `loop-pause-all` 标志实现紧急停止。
- 在无任务时强制快速退出（<5k tokens），节省资源。
- 每个循环后记录结构化 JSON，便于审计和成本分析。
- 可与其他技能（如 budget-negotiator）集成，提供更智能的预算协商。
- 要求项目包含 `loop-budget.md`、`loop-run-log.md` 和 `STATE.md`，未提供这些文件时技能无法工作。
- 依赖 token 估算，实际消耗可能不同，导致预算控制不精确。
- 缺少独立的测试套件，可靠性未经验证。
- 技能描述简略，未提供配置文件格式的详细说明，可能需要参考仓库其他文档。
如何安装这个 Skill？
该技能位于 monorepo 的 skills/loop-budget/ 目录。若要单独使用，请将该文件夹复制到您的 Agent Skills 目录（如 ~/.claude/skills/），或按照仓库通常的安装方式使用 npx @cobusgreyling/loop-init 脚手架来初始化技能、状态和预算文件。由于 README 未提供单独的安装说明，具体安装方式请参考仓库的快速入门文档。
如何使用这个 Skill？
在每个循环迭代开始时和结束时，指示您的 AI 代理执行此技能。例如，在 Claude Code 或 Codex 中提示：“运行 loop-budget 技能，在循环开始前检查预算，结束时记录日志。”技能将自动执行步骤：读取预算文件、计算消费、决定是否进入仅报告模式或退出，并在结束时追加 JSON 记录。
这个 Skill 与同类方案有什么区别？
它与同仓库中的 budget-negotiator 技能合作：当消费达到 90% 且有高优先级任务时，本技能让位给预算协商技能。但仓库未提供其他直接竞争技能。