为什么值得关注

它采用以证据为先的方法，每个任务声明都对应真实的人工制品，避免虚假的“完成”状态，并能与 Superpowers 无缝协作，实现端到端的工作流协调。

适合谁使用

Codex 和 Claude Code 高级用户
构建复杂多步骤工作流的开发者
需要可验证任务完成的团队
插件作者和 CLI 工具集成者

典型使用场景

自动化软件开发并为每个子任务提供完成证明
为大型项目编排并行子代理团队
克隆网站并保留完整的页面拓扑和资产证据
生成零依赖的幻灯片并附带可视化质量检查证据

项目优势

命令支持的标准会在结束时重新执行，确保可重现性
轻量级，无运行时依赖，状态保存在本地仓库
可选的子代理团队可并行工作并独立报告
与 Superpowers 互操作且职责不重叠

使用前须知

需要特定 CLI 版本（Codex ≥0.131.0）和 Node.js ≥20
无命令的手动标准依赖人工审查来保证正确性
插件安装和模型解析对部分用户来说可能较为复杂

README 快速开始

🌀 Superloopy

Loop engineering for Codex and Claude Code. Type loopy — an agent does the work, proves each piece with real evidence, and only then says it's done.

English · 한국어 · 中文(简体) · 日本語 · Español

the crew — optional subagents, one job each

Use it

After installing, type your task in Codex or Claude Code with a leading loopy:

loopy add the payments module

The agent plans it, proves each piece with a real file, and reports back — you don't run any commands yourself. The packaged Stop hook stays quiet unless SUPERLOOPY_STOP_HOOK=on.

Why Superloopy?

Superloopy is for Codex and Claude Code work where "done" needs to mean more than a confident status sentence.

Evidence-first: every pass points at a real artifact under .superloopy/evidence/.
Lightweight by default: one small CLI, repo-local state, zero runtime dependencies.
Agent-friendly: skills, hooks, and optional crew lanes guide the agent without hiding the final gate.

Guarantee scope. Command-backed criteria are the strong guarantee: at completion Superloopy re-runs each command in-process and requires it to reproduce, so a stale or fabricated pass cannot reach "done". Manual (commandless) criteria are verified as a non-empty evidence artifact plus auditor/human judgment — their correctness rests on review, not the deterministic re-run.

Skills

Superloopy keeps the command layer small. Skills carry the specialist workflow: when to use it, what the agent should inspect, and what proof must be left under .superloopy/evidence/.

Skill	Use it when	What it produces
`superloopy-loop`	You type `loopy` or `loopy team` for a full loop; use `loopywork`, `lpy`, or `$lpy` for guidance-only context.	Full loops produce a lightweight plan, guided next actions, command-backed proof, a quality gate, and a final evidence report. Guidance aliases do not mutate state.
`superloopy-doctor`	You diagnose install, wrapper, plugin cache, hook/bootstrap, agent, Codex/Claude Code host wiring, or stale-version problems.	A read-only health report with wrapper/cache/version evidence, failing checks, and the exact repair command to run only if approved.
`superloopy-research`	You explicitly invoke Codex `$superloopy:superloopy-research` or Claude Code `/superloopy:superloopy-research`, o

项目描述

Lightweight Codex loop harness with strict evidence gates.

superloopy