looper

1. 基本信息

项目	内容
名称	looper
作者/维护者	Kevin Simback（GitHub：ksimback）
来源链接	https://github.com/ksimback/looper
许可证	MIT（GitHub API 实测，与仓库 LICENSE 文件原文一致）
GitHub Stars	687（GitHub API 实测，2026-07-21）
Forks	62（同上）
最新版本	v0.4.0（2026-07-07 发布的 GitHub Release）
安装方式	一键安装脚本（macOS/Linux 用 curl，Windows 用 PowerShell），也提供手动 git clone 步骤

2. 功能介绍与亮点

looper 是一个“循环设计教练”：在你真正启动一个会反复迭代的 agent 循环（审代码、修 bug、写文档、跑研究）之前，先帮你把目标、验证方式、复核角色和终止条件想清楚、写成一份可执行、可复用的规格。

七阶段访谈式设计：依次澄清目标、验证标准、执行模型、复核委员会、终止/控制条件、确认预览、是否立即运行，每个阶段都对照内置的最佳实践 rubric 逐条批注，推着含糊的目标往“结果、范围、上下文、完成状态”四要素收敛。
五套现成模板：security-scan、code-review、bug-hunt、docs-sync、research-synthesis，可直接从模板起步，只需按提示填空即可编译出可运行的循环。
跨模型复核委员会：允许把 Codex、Gemini 等其他厂商的模型接入复核/裁判角色，形成“不是同一个模型自己检查自己”的交叉验证；跨厂商前会先展示外发范围和默认脱敏规则（.env、secrets/**、*.key 等），需用户确认后才发送。
强制终止护栏：每个循环必须同时具备最大迭代数、单个环节的重试上限、“无进展”停止信号，以及预算或人工止损点中的至少一项，不允许写出一个没有退出条件的自动循环。
静态校验工具：looper.py lint 可对任何 loop.yaml 做规则检查，捕捉“全靠感觉验证、裁判和执行者共享同一模型家族、遗漏终止上限”等设计反模式，无需重新走一遍访谈。
产出物透明可控：写出的 loop.yaml/run-loop.py 都是用户自己拥有、可编辑的文件，不依赖闭源后端。

3. 适用场景

所属分类：元技能与 Agent 增强。适合已经在用 Claude Code 跑重复性任务（代码评审、漏洞排查、文档同步、调研整理等）、但苦于循环要么“一轮就停”要么“跑飞了不知道什么时候该停”的开发者；也适合团队希望在把某个 agent 循环固化为可复用流程之前，先有一道复核关卡与统一的终止标准。

4. 跨 Agent 兼容性

Claude Code：✅ 原生支持——技能以 ~/.claude/skills/looper 形式安装，配套 ~/.claude/commands/looper.md 提供 /looper 斜杠命令，SKILL.md 中的执行说明明确针对 Claude Code CLI 优化
Codex：⚠️ 部分支持——循环示例与模型注册文件（agents/openai.yaml）支持把 Codex CLI 设为循环内的执行模型或复核成员之一，但技能本体未见 Codex 专属的安装打包路径，只能作为 Claude Code 技能间接调用 Codex
OpenClaw：❓ 未验证——仓库中未见相关适配文件或安装说明
Hermes Agent：❓ 未验证——仓库中未见相关适配文件或安装说明

判断依据：仓库安装文档与目录结构（.claude/skills、.claude/commands、agents/openai.yaml）。

5. 推荐理由

把 Agent 循环设计成可审查、可终止的安全闭环，而不是“跑起来再说”。

6. 评分

维度	分数	说明
受欢迎程度	6	仓库创建约 5 周内积累 687 Star、62 Fork，增长速度较快；目前可查到的独立传播渠道主要是作者本人在 X 上的一条介绍帖，尚未形成多个独立信息源的广泛讨论
可用性	9	提供一条命令的安装脚本（含手动步骤备选），SKILL.md、README、CHANGELOG、CONTRIBUTING 与 5 套预置模板文档齐全；最近一次发布 v0.4.0 在约两周前，此前三周内连续发布四个版本；核心功能不依赖任何付费服务
安全性	9	见下方安全检查清单

安全检查清单：

检查项	结果
① Shell 命令及权限范围	有限——仅通过参数数组调用自带的 Python 脚本完成编译/校验，SKILL.md 明文要求“写参数数组而非拼接 shell 字符串”
② 运行时是否联网外发数据	默认不外发；仅当用户主动选择跨厂商模型作为复核/裁判时才会外发上下文，且会先展示外发范围与默认脱敏规则，经确认后才发送
③ API key/凭据存储方式	明文禁止把密钥写入 `loop.yaml` 或模型注册表，认证信息留在各 CLI 自身的配置/密钥链中
④ 可疑指令/Prompt Injection 迹象	已通读 SKILL.md 与核心脚本 `looper.py` 原文，未发现要求越权操作、外发数据或篡改流程的可疑指令
⑤ 作者/组织信誉	维护者为具名个人开发者 Kevin Simback，GitHub 与 X 身份一致公开，仓库有清晰的版本发布记录
⑥ License	MIT，清晰明确
⑦ 最近维护时间	最近一次提交/发布在 2026-07-07，距今约 2 周

综合评分（三项均值）：8.0

7. 跟同类 Skills 相比的优势

对比对象	定位	与 looper 的差异
Agent-Loop-Skills（gaasher）	开箱即用的任务型循环合集（自动调研、科研写作、数据分析、代码/SQL/Prompt 优化、红队测试），号称可移植到 Codex、Cursor 等多个 Skills host	提供的是“写好的循环”，装上就能跑；looper 提供的是“设计循环的方法和访谈流程”，产出你自己的循环规格，两者可以互补——用 looper 的护栏思路去审查移植过来的现成循环
superloopy（beefiker）	轻量级 Codex/Claude 循环执行框架，强调“证据关卡”	更偏执行期的轻量 harness，规模与文档深度都更小；looper 把设计期的访谈、批注、跨模型复核委员会做得更完整，附带静态 lint 工具
loop-engineering（maxmilian）	面向 Claude Code / Codex / Copilot / Gemini 的循环设计与复核技能	命名与定位相近的直接同类项目，但项目规模明显更小；looper 有版本化发布记录、条款化的终止护栏清单，以及结构化的规格产出格式（`loop.resolved.json`/`LOOP.md`）

8. 用户评价

looper 目前在第三方平台尚无独立于作者本人之外的具名用户评价；已知的公开介绍来自作者 Kevin Simback 在 X 上的一条发帖。

9. 其他补充

仓库同时提供 looper-spec.md（循环规格的正式定义）与 conformance/（一致性测试用例），供希望自行实现兼容运行器的开发者参考；文档目前只有英文版本。

10. 安装使用方式

# macOS / Linux
curl -fsSL https://raw.githubusercontent.com/ksimback/looper/main/install.sh | bash

# Windows PowerShell
irm https://raw.githubusercontent.com/ksimback/looper/main/install.ps1 | iex

手动安装（不想跑一键脚本时）：

git clone https://github.com/ksimback/looper "$HOME/.claude/skills/looper"
mkdir -p "$HOME/.claude/commands"
cp "$HOME/.claude/skills/looper/commands/looper.md" "$HOME/.claude/commands/looper.md"

安装后无需重启 Claude Code，在对话中输入 /looper 即可启动访谈式设计；也可用 /looper my-review --template code-review 直接从预置模板开始。安装程序会在技能目录内建一个私有 .venv 并安装 PyYAML，供随附的编译/校验脚本使用。

11. 注意事项

技能本体只打包为 Claude Code 技能，Codex 仅能作为循环内部可调用的模型，不能独立安装该技能
单一开发者维护，项目历史约 5 周，长期维护记录尚短
循环真正落地执行仍依赖使用者自己配置好的模型 CLI（如需要 Codex 参与复核，需另行安装并完成 Codex 自身的鉴权）
跨厂商复核会外发部分会话上下文，虽有确认与脱敏机制，涉及敏感代码库时仍建议先确认脱敏规则覆盖范围