你是否曾为让Claude自动执行复杂任务而反复调试、担心它“跑偏”或修改错误文件?Looper 是一款专为 Claude Code 用户打造的开源流程设计工具——它不直接运行AI,而是让你在代码执行前,用可视化方式画出完整的智能体循环逻辑,并设置人工与程序双重审查关卡,确保每一步都可追溯、可干预、可终止。
它把模糊的“让AI帮我整理会议纪要+生成周报”这类想法,变成一张清晰的 Mermaid 流程图:从目标定义、计划生成、人工评审、交付执行,到结果判断与自动熔断,所有环节都在运行前被显式建模和审查。真正实现“先设计,再执行;先确认,再改动”。
核心功能
- 可视化流程建模:基于 YAML 定义 AI 工作流节点(Goal/Plan/Deliver/Judge/Stop),自动生成 Mermaid 流程图,一目了然掌握整体逻辑结构
- 双轨审查机制:支持“人工评审门”(如指定 reviewer-1 手动批准计划)与“程序化校验门”(如检查输出文件格式、行数、关键词等),缺一不可才能进入下一阶段
- 状态与日志自动追踪:每次运行自动记录 state.json 和 run-log.md,保留上下文、中间产物与决策依据,便于复盘与审计
- 智能熔断保护:内置三重停止守卫——最大迭代次数(如≤12轮)、连续无进展(如两次输出无实质变化)、预算阈值(如API调用成本超限),防失控、防死循环
- Claude Code 深度适配:原生支持 codex/gpt-5 等模型作为执行引擎,YAML 配置直连 Claude 工具调用链,无需额外胶水代码
- 开箱即用示例库:附带真实场景模板(如 AI 工作流映射、文档重构、需求转测试用例),降低学习门槛,快速迁移至自身项目
适合哪些人用
这款工具特别适合:正在使用 Claude Code 进行工程化 AI 编程的技术负责人与高级开发者;需要将 AI 融入标准化研发流程的 DevOps/平台工程师;重视合规性与可审计性的企业级 AI 应用团队;以及希望摆脱“盲目提交提示词→看结果→反复重试”低效模式的 AI 原生应用探索者。如果你常对 AI 的“黑箱执行”心存疑虑,Looper 就是你手边最可靠的流程指挥官。
快速上手
只需三步即可启动第一个受控 AI 循环:
- 安装:运行
pip install looper(Python 3.9+) - 初始化:复制
examples/ai-workflow-mapping/loop.yaml到本地,按需修改 Goal 描述、Plan 提示词、Delivery 输出规则及 Judge 校验条件 - 运行:执行
looper run --loop loop.yaml,系统将自动渲染流程图、启动循环、暂停等待人工评审,并实时记录全过程日志
所有配置均采用简洁 YAML 语法,无需写 Python 代码;支持 VS Code 插件联动与 GitHub Actions 集成,轻松嵌入现有开发工作流。
项目信息
ksimback/looper
GitHub
Design visual, review-gated agent loops for Claude Code before you run them.
290
Stars
27
Forks
Python
MIT
编程语言:Python|Star 数:290|开源协议:MIT|GitHub 项目地址
它不是另一个 AI 执行器,而是帮你驯服 AI 的第一道设计护栏——让智能体循环从“试试看”走向“稳稳走”。


