Loop Library: 可复用 AI Agent 工作流库
发现、改编并设计可重复的 Agent 工作流,内置反馈循环,让任务可验证、可控。
证据显示:README明确说明Loopy不会静默启动计划、更改生产、发布内容或发送消息,需要正常权限和批准;发布流程要求显式批准和预览;数据流透明性体现在保存循环时记录来源URL和修改日期,以及LOOPS.md被视为不可信参考数据;敏感数据处理方面,拒绝保存含秘密的提示,并要求提供净化版本;依赖安全方面,CI使用npm ci和锁文件,但未提供依赖漏洞扫描证据;外部影响方面,发布和运行操作需显式请求;回滚方面,数据库有备份和恢复命令;来源归属方面,保存的循环记录来源URL。扣分原因:依赖安全缺乏漏洞扫描证据,外部影响和回滚的文档描述多于实际代码验证。
证据显示:README和测试文件在描述上一致,测试覆盖了表单防护、投票、循环路由等关键功能;依赖可用性方面,使用npm ci和锁文件,但未提供运行时依赖的可用性保证;失败消息方面,测试断言了错误状态码和错误码,如401、403、400、404、409、429等。扣分原因:依赖可用性缺乏实际运行验证,失败消息的覆盖范围有限。
证据显示:README明确列出了九种使用路径,并提供了示例请求;能力边界清晰,如发现需要至少两次线程出现,运行需要有限边界;触发精度方面,提供了不同平台的调用方式;环境适配方面,支持Codex、Cursor、Claude Code等。扣分原因:未提供不同环境的详细配置说明,能力边界在代码中未完全验证。
证据显示:README结构清晰,包含安装、调用、使用、探索贡献等部分;安装说明详细,提供了不同平台的命令;命名稳定性方面,提到旧技能名称作为兼容别名;示例和FAQ方面,提供了多个示例请求;已知限制方面,README提到了一些限制,如需要Node.js和npx,但未系统列出;许可证为MIT;版本控制方面,有CI和测试,但未提供CHANGELOG;维护责任方面,README提到是Forward Future项目。扣分原因:已知限制不全面,版本控制缺乏明确的变更日志。
证据显示:输出可用性方面,循环提供提示、验证、步骤等结构化输出;边际价值方面,循环库和技能提供了可复用的工作流;成本效益方面,安装和使用成本低,但未提供性能或资源消耗数据。扣分原因:成本效益缺乏量化数据。
证据显示:声明可追溯性方面,README中的声明与代码和测试部分对应;跨来源佐证方面,测试文件提供了部分验证,但未提供外部独立验证;事实与推断分离方面,README区分了功能描述和设计意图。扣分原因:跨来源佐证不足,缺乏独立验证。
- 依赖安全:未提供依赖漏洞扫描或审计证据,建议在CI中加入安全扫描。
- 已知限制:README未系统列出所有已知限制,建议补充。
- 版本控制:缺少CHANGELOG,建议添加以跟踪变更。
- 跨来源佐证:测试覆盖有限,建议增加更多集成测试和外部验证。
这个 Agent 能做什么,适合哪些场景?
Loop Library 是一个包含公共目录网站和可安装技能(Loopy)的仓库,用于发现、适配和创建可重复的 AI Agent 工作流(称为“循环”)。网站(位于 loop-library/ 目录)提供公开的循环目录,无需安装即可浏览和复制提示词。Loopy 技能(skills/loopy/)为 AI Agent 提供指导,帮助其发现、查找、审计、修复、定制、运行、复盘、保存和发布循环。它面向 Codex、Cursor 和 Claude Code 平台,通过 npx 安装。每个发布循环包含“何时使用”、“提示词”、“验证”、“步骤”、“注意事项”和“相关循环”等部分,强调有界执行和人工审批。
Loopy 技能提供九个操作路径:发现(扫描代码库或线程历史中的重复工作)、查找(搜索实时目录)、循环医生(审计并修复循环)、适配(定制循环)、制作(访谈并创建新循环)、运行(有界执行并返回回执)、复盘(分析运行回执并建议改进)、保存(将循环保存到 LOOPS.md)、发布(准备并提交循环到目录)。它通过 npx skills add 命令安装,需要 Node.js。运行时,Loopy 读取代码库、线程历史、LOOPS.md 和实时目录(通过 signals.forwardfuture.com/loop-library/ 的 catalog.json 和 catalog.txt),执行循环,并返回带证据的回执。
- 开发者在代码库中发现重复的工程任务,如测试失败修复或文档更新,并希望将其转化为可重复的工作流。
- AI 使用者需要查找现成的循环来解决特定问题,如“保持文档最新”,并希望获得推荐。
- 工程师希望审计和修复现有循环中的薄弱检查或不安全的操作。
- 研究者希望将已发布的循环适配到自己的工具和成功标准。
- 团队希望将有界循环集成到代理中,并需要运行回执以供审查。
- 贡献者希望通过提交循环到公共目录来分享有效的工作流。
这个 Agent 有哪些优点和局限?
- 结构化的循环方法包含明确的检查、停止条件和人工批准边界,使流程更安全。
- 为多个代理(Codex、Cursor、Claude Code)提供现成的技能,安装简单。
- 公共目录允许在无需安装的情况下共享和重用循环。
- 提供了审计和修复循环的功能,提高了可靠性。
- 需要 Node.js 和 npx,增加了环境依赖。
- 平台支持限于 Codex、Cursor 和 Claude Code,其他代理需要交互式安装。
- 循环的创建和维护需要理解循环的四个关键问题的概念,存在学习曲线。
- 目录由 Forward Future 托管,存在外部依赖,且需要网络访问。
如何安装或部署这个 Agent?
需要 Node.js 和 npx。对于 Codex,运行:npx skills add Forward-Future/loopy --skill loopy --agent codex -g -y。对于 Cursor:npx skills add Forward-Future/loopy --skill loopy --agent cursor -g -y。对于 Claude Code:npx skills add Forward-Future/loopy --skill loopy --agent claude-code -g -y。要安装到所有三个代理,使用多 --agent 标志。对于其他代理,运行交互式安装程序:npx skills add Forward-Future/loopy --skill loopy -g。如果代理已打开,安装后需重启。
如何使用这个 Agent?
在 Codex 中,输入 /skills 选择 Loopy,或直接使用 $loopy 提及。在 Cursor 中,在 Agent 聊天中键入 /,搜索 loopy,然后添加请求,或直接输入 /loopy。在 Claude Code 中,键入 /loopy 后跟请求。例如,/loopy Find a published loop for keeping our documentation current. Loopy 会识别请求并选择路径,例如“发现”、“查找”或“运行”。也可以通过描述匹配任务来触发自动加载。
这个 Agent 与同类方案有什么区别?
文档未命名具体竞争对手,但暗示了与传统单次提示方法相比的优势。