Superloopy
让 Codex、Claude Code 与 Antigravity 的"完成"必须落在真实证据上，而不只是一句自信的状态汇报。
- Star 数
- ★ 115
- 最近更新
- 7 天前
- License
- MIT
- 主语言
- JavaScript
- FA 评分
- 55/100 · 缺口较多
30 秒速览
- 运行形态
- 可在哪里用
- 兼容但需适配Codex · Claude Code
- 费用
- 软件免费，模型调用费用自付
- 上手难度
- 低 · 几分钟可跑通
- 开始前需要
- 典型场景
- 在 Codex 或 Claude Code 上做多步骤重构，需要每一步都留下可复现证据的开发者
- 不适合
- 希望完全脱离 Codex / Claude Code 等宿主、独立跑的团队
- 需要证据门禁以外完整项目管理功能的团队
- 不愿在仓库内外产生 .superloopy 状态与证据文件的团队
- 源码审查
- 55/100 · 缺口较多
这个 Agent 能做什么，适合哪些场景？
Superloopy 是一个轻量的循环执行外壳（loop harness），面向 Codex、Claude Code 和 Google Antigravity。用户输入以 loopy 开头的任务后，代理会先规划，再逐项用真实产物证明进度，全部通过后才宣布完成。它以插件形式分发：Codex 通过插件市场安装并由 SessionStart 钩子完成一次性引导，写入 superloopy 命令与六个 crew 子代理；Claude Code 则完全插件内置，技能、agents/*.md 与 hooks/hooks.json 都在插件里，不写 ~/.codex。核心状态和证据保存在仓库内的 .superloopy/evidence/ 目录，命令行工具零运行时依赖，仅需 Node.js。最强保证来自命令型验收标准：完成时逐步在进程内重跑命令，无法复现即不能算完成；无命令的人工标准则依赖审计者或人工复核。
安装后，在宿主中输入 loopy <task> 即启动一个完整循环：代理制定轻量计划、执行任务、把每个通过项的产物写入 .superloopy/evidence/，最后生成证据报告。loopy team <task>（或 loopy crew、loopycrew、ultrawork <task>）进入 crew 模式，把工作并行分派给六个可选的子代理 forge、sentinel、probe、arbiter、assayer、pathfinder。loopywork、lpy、$lpy 只注入起步指引而不改动状态；结构化 SUPERLOOPY_STEER 指令可调整进行中的循环。superloopy loop handoff、superloopy loop fleet --json、superloopy loop finish --artifact 分别记录子代理交接、查询舰队状态与提交 JSON 质量门禁输出。技能层包括 superloopy-loop、superloopy-doctor、superloopy-research、superloopy-backend、superloopy-clone、superloopy-frontend、superloopy-slides、humanize-korean、i-have-adhd、say-it-straight，各自规定何时启用、检查什么、留下什么证据。superloopy doctor 执行只读健康检查，通过 codex plugin list --json 探测已安装插件版本，并给出修复命令而不擅自修改。封装好的 Stop 钩子只在用户以 loopy 启动或恢复循环后维持会话续跑，可用 SUPERLOOPY_STOP_HOOK=on|off 覆盖。
- 在 Codex 或 Claude Code 上做多步骤重构，需要每一步都留下可复现证据的开发者
- 希望把"完成"变成可审计质量门禁，而不是相信代理自述的团队负责人
- 需要并行拆分大任务、由多个专职子代理分头处理并汇总证据的工程团队
- 要对现有网站做授权克隆与还原，并用桌面/移动浏览器截图做视觉验收的前端工程师
- 使用
superloopy-backend处理迁移、运行时数据库代理等后端工作，并要求命令级证据的团队 - 需要为韩文产品文案去 AI 腔、或要生成单文件 HTML 演示文稿的内容与演示作者
如何安装或部署这个 Agent？
需要 Node.js ≥ 22。一条命令可识别 PATH 上的 claude、codex、agy、omp，逐个询问后通过各宿主自己的插件命令安装：
npx superloopy@latest无交互安装并随后自检：
npx superloopy@latest setup --host claude,codex --yes
npx superloopy@latest update
npx superloopy@latest doctorCodex 手动安装（需 Codex CLI ≥ 0.131.0），安装后需重启 Codex 并批准钩子：
codex plugin marketplace add https://github.com/beefiker/superloopy
codex plugin add superloopy@beefikerClaude Code 手动安装（需 ≥ 2.1.280），安装后重载插件并批准钩子：
/plugin marketplace add beefiker/superloopy
/plugin install superloopy@beefiker从源码检出安装：
node src/cli.js install --json如何使用这个 Agent？
安装完成后在宿主会话里以 loopy 开头键入任务，自行不需要运行命令：
loopy add the payments module需要并行拆分时切换到 crew 模式：
loopy team <task>保存证据与完成门禁相关的状态位于仓库内的 .superloopy/evidence/。命令型验收标准在 superloopy loop finish 时会被进程内重跑，提交 JSON 质量门禁输出：
superloopy loop finish --artifact <gate.json>排查安装、包装脚本、插件缓存、钩子或版本问题时运行只读诊断：
superloopy doctor可选环境变量：SUPERLOOPY_STOP_HOOK=on|off 控制 Stop 钩子续跑，SUPERLOOPY_SUPERPOWERS=on|off 覆盖 Superpowers 检测，SUPERLOOPY_CALQUE_NUDGE=on 在下一轮提示时提示上一条韩文回复中的英语式借译。
这个 Agent 有哪些优点和局限？
- 命令型验收标准在完成时进程内重跑，陈旧的或伪造的通过结果无法抵达"完成"
- 零运行时依赖，只需 Node.js，状态与证据保存在仓库内的 .superloopy/ 下
- 同一仓库同时支持 Codex、Claude Code 与 Google Antigravity，各宿主只加一层薄插件清单与钩子
- 明确划清与 Superpowers 的分工：前者管脑暴、计划、TDD，Superloopy 管终点的证据门禁
- superloopy doctor 只读诊断，能发现包装脚本/插件"脑裂"并给出修复命令而不擅自改写
- 人工（无命令）验收标准无法确定性重跑，其正确性依赖审计者或人工复核，不如命令型保证强
- 仓库状态与证据写在 .superloopy/ 内，会在工作区留下额外文件
- Codex 安装依赖 Codex CLI ≥ 0.131.0 与批准钩子，版本过旧时插件与钩子流程可能失败
- omp 上不运行 Claude 格式 hooks.json，因此没有自动 Stop 续跑、子代理回执检查与 SessionStart 引导
- 未暴露宿主 agent_type 与模型证明时会处于 model_unverified，不能视为已验证的运行时模型门禁
这个 Agent 与同类方案有什么区别？
Superpowers：Superloopy 在 README 中明确表示二者处理同一工作的不同半边。Superpowers 负责循环前端——脑暴、计划及其 TDD 与代码审查方法；Superloopy 负责收尾——完成时重跑的命令型验收标准。检测到 Superpowers 时，Superloopy 会把设计与计划让给它，自己保留外层证据门禁，可用 SUPERLOOPY_SUPERPOWERS=on|off 覆盖。
与相关度最高的同类 agent 并排比较关键指标。
| Agent | 源码审查 | 形态 / 费用 | Star | 最近更新 | 主语言 | 完整支持的平台 |
|---|---|---|---|---|---|---|
| Superloopy 当前 | 55 · 缺口较多 | Agent 插件 / 技能免费 + 模型费 | ★ 115 | 7 天前 | JavaScript | Codex · Claude Code |
| Autoprompt Skill | 69 · 存在缺口 | 命令行工具免费 + 模型费 | ★ 1.2k | 1 个月前 | JavaScript | Codex · Claude Code |
| Smart Ralph | 73 · 存在缺口 | Agent 插件 / 技能免费 + 模型费 | ★ 566 | 8 天前 | Shell | Codex · Claude Code |
| OSpec | 50 · 缺口较多 | 命令行工具免费 + 模型费 | ★ 391 | 2 个月前 | JavaScript | Codex · Claude Code |
FollowAgents 如何评估这个 Agent？
查看各维度的扣分理由
SECURITY.md 明确承认证据捕获会以调用者权限执行 agent 选择的任意命令，无白名单、无沙箱，属设计取舍，故 least_privilege 仅 1；用户确认方面，安装/更新/卸载需批准 hook，doctor 修复命令需批准，但核心 prove 执行无逐次确认，得 1；数据流透明度仅说明证据写入 .superloopy/，未系统描述数据流向，得 1；敏感数据处理无专门机制，仅提及报告不含真实密钥，得 1；依赖安全为零运行时依赖、仅 Node，且 CI 固定 action SHA，得 2；外部副作用（写 ~/.codex、~/.local/bin、npm 全局）有文档但无隔离，得 1；回滚有卸载步骤与失败提交恢复测试（agent-retirement 测试验证回滚），得 2；来源归属有 author、repository、MIT 版权但版权年份无署名主体，且发布者身份未验证，得 1。
self_consistency：README 与 package.json、hooks 测试、CI 相互一致，得 2；dependency_availability：零运行时依赖、engines 明确 Node>=22，得 2；failure_messages：doctor 提供只读健康报告与精确修复命令，测试覆盖多种失败消息，得 2。
audience_and_scenarios：面向 Codex/Claude Code/Antigravity 多宿主，场景表详尽，得 2；capability_boundaries：明确命令型与手工型证据的保证范围差异，得 2；trigger_precision：skill 触发条件与排除项描述细致并有测试，得 2；environment_fit：跨 OS/Node 矩阵 CI 与多宿主 wiring 检查，得 2。
information_architecture：README 结构清晰但极长且多语言重复，得 2；install_notes：安装/更新/卸载/排障分宿主详尽，得 3；naming_stability：存在 agent 重命名（franky→forge 等）与 legacy 清理，命名曾变动，得 1；examples_and_faq：有 Q&A 与 demo，但缺独立 FAQ 章节，得 2；known_limitations：明确手工证据依赖人工判断、backend 效果未测量，得 2；license：MIT 完整，得 2；versioning_changelog：有版本号、version-guard 与发布流程，但无 CHANGELOG 文件，得 2；maintenance_responsibility：仅个人作者，发布者未验证，得 1。
output_usability：证据写入 .superloopy/evidence 并有 gate JSON，得 2；marginal_value：提供证据门控与多 skill，但部分效果自述未独立验证，得 2；cost_benefit：backend skill 自述增加 1.7–1.8× 输出 token，成本明显，得 1。
claim_traceability：README 引用 docs 与 demo 链接，但关键效果数字无原始数据，得 1；cross_source_corroboration：测试与 CI 部分佐证行为，但效果声明无交叉来源，得 1；fact_inference_separation：README 区分测量效果与未测量指导，得 2。
- 证据捕获会以调用者权限执行 agent 选择的任意命令，无沙箱，仅在可接受该风险的环境使用。
- 发布者身份未经验证，安装前应自行审查源码与 hook 行为。
- backend skill 自述显著增加输出 token 成本，需权衡收益。
- agent 曾重命名，升级时可能残留旧文件，需按文档手动清理。
常见问题
它需要 API 密钥或额外付费吗？
没有 Superpowers 能单独用吗？
SUPERLOOPY_SUPERPOWERS=on|off 可覆盖检测结果。什么情况下"完成"的保证会变弱？
在 omp 或 Antigravity 上功能完整吗？
hooks.json，因此没有自动 Stop 续跑、子代理回执检查和 SessionStart 引导；superloopy loop finish 的完成门禁仍会重跑所有命令型证明。Antigravity 通过插件目录更新并用 agy plugin validate 校验。doctor 会不会自动改我的环境？
superloopy doctor 是只读健康检查，只报告版本、校验结果、失败项与确切的修复命令，需要批准后才执行。