1,756· 153 forks· JavaScript· MIT开发工具

Loopy: AI Agent 循环工作流库与技能包

Forward-Future/loopy

为 AI Agent 提供可复用的循环工作流模式库,让智能体学会从结果中学习、迭代改进并自主判断何时停止

成熟度维护活跃,最近提交0天前,仅1个 open issue,新项目处于快速迭代期

项目体检

许可 · MIT 协议,可自由商用、修改和分发

活跃 · 项目活跃度高(今日仍有提交),3位贡献者,创建仅15天已获1756星

解决什么

传统 AI 提示词只能让智能体执行单次任务,缺乏从结果中学习和迭代改进的能力。开发者想让 AI Agent 持续优化网站性能、修复生产错误或提升测试覆盖率时,往往陷入"改了一次就结束"的困境。Loopy 通过引入循环工作流(Loop)概念,为智能体提供四要素框架:明确目标、验证结果、决策下一步、判断何时停止。这让 AI 从"执行者"变成"持续改进者",能像人类工程师一样多轮迭代直至达标。

为何火

项目上线15天即获1756星,核心原因是击中了 AI Agent 落地的痛点。据 GitHub 数据,该项目在 agentic-workflowsai-agents 话题下热度攀升,恰逢 2026年 AI 编程工具(Cursor、Codex)普及期。开发者发现单次提示词难以应对复杂工程任务,而 Loopy 提供的"可审计、可复用、有边界"的循环模式,让智能体行为变得可预测。其公开目录(catalog.json)设计也降低了 Agent 间协作门槛,任何智能体都能直接调用已发布的工作流,形成生态效应。

核心功能

双层架构:Loop Library 网站是公开的工作流目录,无需安装即可浏览;Loopy 技能包是可选安装的 AI Agent 助手,两者解耦但协同。

八大工作路径:

  • Discover(发现):扫描代码库和对话历史,识别重复性工作并生成循环
  • Find(查找):从在线目录匹配已发布的工作流
  • Audit/Repair(审计/修复):检查循环的安全性、停止条件,仅修复关键问题
  • Adapt(适配):调整已有循环以适配特定工具和成功标准
  • Craft(创建):通过对话引导用户定义新循环
  • Run(执行):分批次运行循环并返回执行凭证
  • Debrief(复盘):分析执行结果并推荐最小改进
  • Publish(发布):检查重复性后生成发布草稿,需人工审批

循环四要素:每个 Loop 必须回答"做什么、如何验证、下一步、何时停"。例如性能优化循环:"找最慢页面→做一次改进→重新测量→仅保留有效改动→重复直到达标或无明显提升"。

安装

需 Node.js 环境,通过 npx 安装到 AI 编程工具:

# 安装到 Cursor
npx skills add Forward-Future/loopy --skill loopy --agent cursor -g -y

# 同时安装到多个工具
npx skills add Forward-Future/loopy --skill loopy \
  --agent codex --agent cursor --agent claude-code -g -y

参数说明:-g 为全局安装(所有项目可用),-y 跳过交互确认。安装后需重启对应 AI 工具。调用方式因平台而异:Codex 用 $loopy,Cursor 用 /loopy,Claude Code 同样用 /loopy

适合谁

目标用户:

  • 使用 Cursor/Codex/Claude Code 的开发者,需要 AI 执行多轮迭代任务
  • DevOps 工程师,希望自动化性能优化、日志分析等重复性工作
  • 技术团队,想建立可复用的 AI 工作流库供团队共享

不适合:

  • 使用国产 AI 编程工具(如通义灵码、文心快码)的用户,目前仅支持海外工具
  • 需要离线运行的场景,在线目录依赖外网访问
  • 期望 AI 完全自主决策的场景,Loopy 强调人工审批关键动作(如发布、生产变更)

社区评价

基于 Hacker News 508点讨论(84条评论),社区对该项目的系统思维可视化能力高度认可。核心争议集中在符号语义理解:多位用户反馈"焦虑-抑郁"示例中的负号(-)行为不直观,建议用"更多(🡩)/更少(🡫)/反转(↕)"三选项替代当前的+/-二元设计。正面观点包括:"让模拟对话成为可能,从系统思考到系统对话的跨越"(引用 Bret Victor 推文);"与 Steve Keen 的 Minsky 经济学软件理念一致"。技术建议层面,用户期望增加节点数值图表(点击节点显示直方图或李萨如图形),认为当前箭头密度的可读性不足。整体评价为"优雅易用,但符号系统需优化以降低认知负担"。

选型对比

vs 传统 Prompt 工程:普通提示词是"一次性指令",Loopy 是"带反馈的剧本",后者适合需要多轮验证的场景(如逐步提升测试覆盖率从60%到90%)。

vs Langchain/AutoGPT:这些框架侧重 Agent 底层能力(工具调用、记忆管理),Loopy 聚焦工作流模式复用。两者可结合:用 Langchain 构建 Agent,用 Loopy 定义其迭代逻辑。

vs n8n/Zapier:后者是无代码自动化平台,适合 API 编排;Loopy 是代码级 AI 工作流,由智能体在开发环境中执行,更适合工程任务。

已知坑

  1. 平台锁定:仅支持 Codex/Cursor/Claude Code,国内主流 AI IDE(如豆包 MarsCode)无法使用,需等待社区适配或官方扩展
  2. 网络依赖:在线目录(catalog.json)托管在 signals.forwardfuture.com,国内访问可能需要梯子,离线场景受限
  3. 权限边界模糊:README 强调"不会静默发布或变更生产",但 Audit/Repair 路径的"修复"范围未明确界定,建议在生产环境先人工审查修复建议
  4. 循环终止判断:依赖 AI 自主判断"无明显改进"的阈值,可能因模型差异导致过早或过晚停止,建议在 Loop 定义中显式设置最大迭代次数
  5. 中文支持:目录和文档均为英文,中文 Prompt 的解析准确度取决于所用 AI 模型的多语言能力

安装方式:npx