LoopX Skill：让 AI Agent 长周期任务可控、可审计、可交接的状态内核

总结

LoopX 是一个轻量级的 AI Agent 循环工程状态内核，为 Codex、Claude Code、Cursor 等主流 Coding Agent 提供本地控制平面。它解决的核心问题是：长周期任务中目标漂移、证据过期、Agent 间交接断层、人工审批节点难以追踪。LoopX 不替代 Agent 运行时，而是将目标、Gate、待办、证据、配额、交接包持久化为一层紧凑状态，让人类始终掌握判断权。今日 GitHub Trending 拿下 854 stars，正处于快速爆发期。

功能与原则

LoopX 的设计原则是「保持循环运转，保持判断在人类手中」。

核心能力包括：

• 持久化目标与 Gate：每个目标携带条件门控（Gate），未经人工审批不得进入下一阶段；
• 可执行待办清单：Agent 的 todo 项可被 LoopX 校验、追踪、完成度量化；
• 证据日志：每个循环轮次写下证据快照，形成可审计的决策链；
• 配额感知自动唤醒：quota 耗尽自动暂停，节省 token 成本；
• 可验证交接：多 Agent 协作场景下，handoff 包包含完整的上下文继承信息。

LoopX 不是一个全自动生产控制器——危险权限、发布权限、生产写入权限始终保留在人类手中。

认可度

• GitHub Star：2,736（截至 2026-08-06）
• 今日新增 Stars：854（GitHub Trending 日榜）
• Forks：204
• 语言：Python
• 创建时间：2026-05-31（上线仅约 2 个月，仍处于高速增长阶段）
• Trending：今日进入 GitHub 全语言 Trending 榜单

链接

GitHub：https://github.com/huangruiteng/loopx

原作者

huangruiteng（GitHub username: huangruiteng），专注 Agent 工程化工具链，长期活跃于 Codex/Claude Code 生态。LoopX 是其继 OpenViking 开源贡献项目之后的第二个明星项目，有完整的中文文档和飞书操作手册。

介绍

LoopX 本质上解决的是「AI Agent 做长活时，管理与可审计性几乎为零」的问题。大多数 Agent 工具设计为一轮会话内的单次任务优化，但真实工作场景——比如跨多天的功能开发、持续数周的 benchmark 调研、涉及多人协作的 issue-fix 流程——天然跨越数十甚至数百个bounded turns，目标漂移、上下文断层、交接丢失几乎必然发生。

LoopX 引入了一层状态内核（state kernel）：目标（objective）、Gate、待办（todos）、证据（evidence）、配额（quota）、交接（handoff）六项全部持久化。每轮 Agent 执行前，LoopX 检查 quota 是否允许运行；执行后，Agent 将证据写回 LoopX 状态，并决定是否需要人类介入 Gate。整个人类审批流、Agent 工作流、交接流都在同一层状态上可见，而不是散落在各个 Agent 的聊天记录里。

官方还给出了一个非常直观的类比：LoopX 是「Agent 原生的 Kanban」。每个任务卡片携带身份、权限、证据和续接信息，移动卡片是经过校验的操作（如 claim、gate、monitor、writeback），而非简单的文本编辑。Kanban 面板只是投影，LoopX 状态才是事实来源。

特点

• Agent 无感知接入：支持 Codex、Claude Code、Cursor、OpenCode 等主流 Agent，无需针对某个运行时做定制；
• 状态持久化：退出会话不丢上下文，下次启动直接恢复；
• 人类 Gate 机制：关键节点强制人工审批，防止 Agent 越界；
• 配额感知：自动追踪 token/调用消耗，quota 耗尽自动休眠，避免深夜跑空；
• 证据与交接：每轮产出可审计，接力棒的上下文继承清晰，适合多 Agent 协作场景；
• 轻量无依赖：纯 Python + 一个 CLI，pip 安装即可，不绑运行时；
• 已有真实长周期案例：OpenViking Issue-Fix 轨迹跨越 200+ 小时实际项目时间。

使用方法

安装

curl -fsSL https://raw.githubusercontent.com/huangruiteng/loopx/main/scripts/install-from-github.sh | bash
export PATH="$HOME/.local/bin:$PATH"
loopx doctor

连接项目

cd /path/to/your-project
loopx connect
loopx status

在 Agent 里发起任务

在 Claude Code / Codex 的聊天框中直接输入：

/loopx <complex task>

例如：

/loopx 在 3 天内完成这个 PR 的 review，要求所有测试通过且无 blocking 意见

LoopX 会自动创建目标、设置 Gate，并在每一轮 Agent 执行后等待人工审批或继续。

核心命令一览

使用场景与人群

适用场景：
– 多日工程任务（如大型功能重构、持续集成 benchmark）；
– Issue/PR 循环需要保留上下文和 reviewer 偏好；
– 定期心跳监控类任务；
– 涉及私有数据或安全 Gate 的项目；
– 多 Agent 协作（peers 之间需要明确交接边界）。

目标用户：
– 深度使用 Claude Code / Codex 的工程师；
– 需要将 AI Agent 纳入团队工作流的 tech lead；
– 关注 Agent 工程化（Agentic Ops）的开发者与研究者。

输入与输出案例

案例 1：多日 PR 开发流程

输入（Agent）：

/loopx 在本周完成这个 feature branch 的开发和测试，要求 CI 全部绿灯

LoopX 状态演进：
– Goal 创建 → Objective 记录 → Gate（CI 绿灯）挂起；
– Agent 执行第一轮 → 证据写入：修改了哪些文件，跑了哪些测试；
– LoopX 发现测试失败 → Gate 未通过 → 暂停，等待人工审批；
– 人类审阅证据后决定：可以继续，调整测试策略 → Gate 解锁；
– Agent 继续，最终 CI 绿灯 → Gate 通过 → 任务完成。

整个过程有完整的证据链和决策时间戳可查。

案例 2：多 Agent 协作交接

输入（Agent A）：

/loopx 调研竞品的定价策略，输出报告

LoopX 行为：
– 创建目标 → Agent A 执行调研，写入证据包；
– 调研完成后，handoff 包包含所有引用链接、分析摘要；
– Agent B 被调度接收 handoff 包，直接继续：「基于上一轮调研，撰写定价报告」；
– 无需重复上下文传递，交接无断层。

作者：Skill超级捕获手 | 定位：Skills 市场 + GitHub + 社媒热门 Skill 追踪者，专注爆款、新晋 trending 与社群讨论热点

GitHub: https://github.com/huangruiteng/loopx