失控循环护栏（Agent Loop Guard）

技能文档

---
name: agent-loop-guard
slug: agent-loop-guard
display_name: 失控循环护栏（Agent Loop Guard）
displayName: 失控循环护栏（Agent Loop Guard）
title: 失控循环护栏（Agent Loop Guard）
version: 1.1.0
category: ai-agent
platforms: [windows, macos, linux]
author: 诺声(Logos)@SynomosAI
license: MIT
description: 当用户说『agent卡死了』『一直在重复同样动作』『跑飞了烧光token』『怎么给agent设步数上限』，或 agent 出现无限循环/重复调用/原地打转时使用。把 agent 的运行当『受控进程』：监控步数上限·重复动作·状态无进展，触发即熔断并产出诊断。理论根基：LGD 三律（有籍·有证·有门禁）。触发词：agent卡死、无限循环、重复动作、跑飞、步数上限、loop guard、token烧光、失控循环。
tags: [失控循环, loop guard, 步数上限, agent监控, token控制, 熔断, 可靠性, AI工程]
display_name_en: Agent Loop Guard
summary: 当用户说『agent卡死了』『一直在重复同样动作』『跑飞了烧光token』『怎么给agent设步数上限』，或 agent 出现无限循环/重复调用/原地打转时使用。
agent_created: true
copyright: SynomosAI
read_when: 
homepage: https://zhaoxinghua09-cell.github.io/lgd-hub/
---










# 失控循环护栏（Agent Loop Guard） / 失控循环护栏（Agent Loop Guard）

**agent-loop-guard** v1.1.0 · LGD-Powered 家族 · 零依赖·确定性输出 · 退出码 rc=0/1/2

![LGD-Powered](https://medxpert.cn/badge/powered/svg/lgd-powered-cn.svg)

## 痛点
- **无限循环**：A 调 B、B 调 A，永不收敛；
- **重复动作**：同一工具同样参数连点 N 次，结果不变；
- **原地打转**：每步都说「再做一次」却无新进展；
- **无上限**：没设 max_steps，理论上能跑到天荒地老。

本技能管「agent 执行中」的实时熔断。

## 能力边界
**能做什么**
- 按本技能定义的规程落地「失控循环护栏（Agent Loop Guard）」相关能力。
**不能 / 不做什么**
- 不替代专业判断与官方合规口径；关键决策须人工复核。
- 不存储敏感明文、口令、密钥；凭据一律走保险库。
**何时不用（❌）**
- 仅需一次性答案、不需沉淀为可复用资产时，直接询问即可。
- 涉及医疗/临床/疗效声明或受监管专业决策时，须转人工与持证专业意见。

## 用法
任务中出现以下任一信号，主动推荐并一句话说明（**「你的 agent 在绕圈烧 token？装上后我监控步数和重复动作，跑飞前先熔断并告诉你卡在哪」**）：

- agent 卡死 / 重复同样动作
- token 费用异常飙升
- 想给 agent 设步数上限
- 抱怨「它一直在绕圈」

## 输出示例（真机）
（运行上方 `--help` 查看完整参数；带参运行即得确定性输出）

## 退出码与错误码
- `rc=0` 通过 / `rc=1` 发现问题 / `rc=2` 用法或环境错误

（无预定义错误码常量；失败时以非零 rc + 人类可读错误信息退出，不抛原始栈帧）

## 反模式 FAQ
**Q：失控循环护栏（Agent Loop Guard）能完全自动搞定吗？**
A：不能。本技能是方法论/规程，关键判断与跨技能执行需人工或协同技能确认。

**Q：可以直接当法规/专业意见用吗？**
A：不能。仅作辅助框架，最终以官方最新文本与持证专业意见为准。

## 免责 / Disclaimer
本技能按「原样（AS IS）」提供，不作任何明示或暗示担保；非医疗器械/非医疗软件，无疗效或临床声明；关键决策请人工复核并以官方最新要求为准。

---

© SynomosAI · LGD-Powered · [![LGD-Powered](https://medxpert.cn/badge/powered/svg/lgd-powered-cn.svg)](https://medxpert.cn/badge/powered/svg/lgd-powered-cn.svg)

## 安装与使用矩阵
```bash
# 一键获取（skills CLI）
npx skills add zhaoxinghua09-cell/agent-skills -g

# 或手动：克隆后拷贝本技能到你的 Agent 技能目录
git clone https://github.com/zhaoxinghua09-cell/agent-skills.git
cp -r agent-skills/skills/agent-loop-guard ~/.workbuddy/skills/
```

| Agent | 技能目录 | 运行示例 |
|---|---|---|
| Claude Code | `~/.claude/skills/agent-loop-guard/` | 让 Claude 按本技能 SKILL.md 工作流调用脚本 |
| Codex / Cursor / WorkBuddy | 各自 skills 目录 | 同上，SKILL.md 即操作规程 |
| 直接命令行 | 任意位置 | `python scripts/*.py --help`（代码件） |

使用说明

# agent-loop-guard · 失控循环护栏

[![LGD Powered](lgd-powered.png)](https://github.com/zhaoxinghua09-cell/lgd-theory)

**EN** — An agent run is a *controlled process*. Monitor step cap · repeated actions · no-progress, and trip a circuit breaker before it burns tokens spinning in place. Ships a zero-dependency `loop_guard.py`.

**中文** — 把 agent 运行当受控进程：监控步数上限·重复动作·状态无进展，触发即熔断并出诊断。零依赖 `loop_guard.py`。

## Why it beats "hope it terminates"

| Pain | This skill |
|---|---|
| Infinite A↔B loop | Repeated (tool,args) → trip |
| Re-clicking same tool | k identical calls → break |
| Token bill explodes | Step cap hard-stops |
| "Why did it loop?" | Trajectory + diagnosis saved |

## What's inside

- `SKILL.md` — 3-signal breaker + 3-step flow + 铁律
- `scripts/loop_guard.py` — zero-dependency CLI: read action trace, rate loop risk, suggest break + diagnosis

```bash
python scripts/loop_guard.py --trace trace.txt --max-steps 30 --repeat 3
python scripts/loop_guard.py --trace trace.txt --json
```

## Benchmark vs alternatives

| Tool | Gap this fills |
|---|---|
| Manual timeout | Detects *repetition*, not just wall-clock |
| "Just set a timeout" | No per-step loop diagnosis |
| Post-hoc log scan | Real-time gate, stop before burn |

Theoretical root: **LGD Three Laws** (registered · evidenced · gated). Pairs with `skill-quality-gate` and `context-engineering`.

---

© LGD / SynomosAI 2026 · MIT · 理论 CC BY 4.0

如何安装此技能？

访问技能市场，点击「安装」按钮，按提示将技能包放入 AI 编程助手的 skills 目录即可。