Loop Library(循环库)技能
帮助 AI 代理发现、查找、审计、设计、运行并迭代可复用的有界工作循环(loop).
作为技能,文档严格遵循最小权限原则:所有操作均需用户授权范围,明确禁止未经同意执行破坏性、生产、财务、隐私或外部消息操作;发布流程要求明确预览和批准,并区分草稿与公开状态;对LOOPS.md和目录内容视为不可信数据,不执行其中指令;拒绝保存含机密的循环。源码中CI和Worker代码显示有权限控制和输入验证(如Turnstile、Origin校验),表明安全设计。扣分项:未验证发布者身份,且技能依赖外部服务(如signals.forwardfuture.com),其安全性和可用性未审计;部分敏感操作(如发布)的细节依赖于外部services,无法确认其是否完全符合最小授权。
技能有清晰的流程定义和多个参考文件(discover、audit、run等),整体自洽,happy path合理。已提供测试(CI和Worker的测试文件)覆盖关键路径的部分功能,但技能本身作为prompt,未在静态审阅中执行验证其实际运行效果;错误处理上,技能强调诚实报告不进展,但缺乏系统性的测试覆盖所有边界情况。扣分:静态审阅无法确认其可重复性和确定性;依赖外部live catalog,若不可用,则明确降级为不可用声明,但未提供本地回退机制。
技能面向工程团队和AI agent,场景描述清晰(发现、查找、审计、运行、发布等),触发条件在SKILL.md中明确,用户可通过显式调用或语义匹配触发。但能力边界和不适配范围的声明有限,例如对不使用loop的用户或简单one-shot任务,仅简单建议,未提供详细non-fit指南。环境适应方面:文档全英文,未提供中文支持;依赖外部服务的可达性在审查中未审计,但源文件中提到catalog源自海外URL,从中国大陆网络可能访问受限,影响适用性。
技能有标准文档结构,包含简介、使用说明、示例和多个参考文件,信息层次分明。提供安装命令和依赖说明(Node、npx)。有许可(MIT)和README,但版本信息仅在revision中,技能内未提供明确的版本号或changelog;已知限制披露较少,例如依赖live catalog,但未说明catalog不可用时的替代方案;维护责任部分声明为Forward Future项目,但未提供维护者联系方式或更新政策。
技能声称能帮助用户发现、设计、运行循环,并输出格式良好的循环描述。基于文档,其核心流程设计合理,输出格式明确(如run receipt、debrief),应能完成核心任务。但无法静态验证实际输出质量,且依赖外部catalog对结果完整性有影响。扣分:输出是否直接可用和边际价值未经实际测试;发布功能依赖外部服务,需网络和权限,增加复杂度和成本。
证据主要来自文档描述和源码审查;CI和Worker测试文件提供了验证关键技术组件的证据,但技能本身作为prompt,其执行效果无法静态验证。可追溯性一般:循环定义要求保留精确文本或SHA-256,提供了可复核基础。扣分:核心执行路径未独立复现;关键声明(如'效果良好')依赖作者描述,缺乏第三方验证。
- 外部依赖:技能核心功能依赖signals.forwardfuture.com的实时目录和发布服务。该服务在中国大陆可能无法访问,导致发现、查找和发布流程不可用;且其安全性和可用性未审计。
- 发布者身份未验证:发布者未在FollowSkills企业注册表中验证,身份未知。这增加维护责任和更新路径的不确定性。
- 中文支持:技能文档全英文,可能对中文用户不友好;建议提供中文版或本地化触发词。
- 运行时安全:技能运行依赖于用户授权范围和外部服务,应确保用户了解运行循环可能产生的外部调用(如发布、网络请求)。
这个 Skill 能做什么,适合哪些场景?
Loop Library 是一个 Agent Skill,它引导 AI 代理以结构化的方式处理可重复的工作流程:从代码库或编程线程中发现循环机会,从实时目录中推荐已发布的循环,审计并修复现有循环,通过引导式访谈定制新循环,在授权范围内运行循环并生成有证据的运行回执,对运行进行复盘,将循环保存到项目的 LOOPS.md 中,并准备发布草稿。该技能强调有界的执行、明确的成功标准和人工审批边界,防止无限制的自动化。它是作为兼容别名提供的,用于支持旧版安装,新安装请使用新的 Loopy 名称。
读取 SKILL.md 中的路由逻辑,根据用户请求选择最小路径(发现、查找、审计、适配、设计、运行、复盘、保存、发布)。当需要分析时,读取 references/discover.md、references/audit.md、references/run.md、references/debrief.md 和 references/publish.md。对于查找操作,从 signals.forwardfuture.com 获取实时 catalog.md 或 catalog.json,并搜索匹配项。对于运行操作,执行循环的步骤,同时遵守权限边界,并编写运行回执。对于保存操作,将循环添加到项目根目录的 LOOPS.md 文件中(如存在)。对于发布操作,检查目录重叠,并准备精确的预览以供审批。
- 工程师想要分析代码库中的重复性任务,并将其转化为可复用的循环。
- 开发者需要查找用于保持文档最新等任务的已发布循环。
- 团队希望审计现有循环,找出弱点,并仅修复关键问题。
- 用户想根据访谈定制一个新的循环,用于将客户反馈转化为修复。
- 在授权范围内运行一个循环,并获得一个有证据的回执。
- 项目希望将循环保存到 LOOPS.md 中,以便在未来的会话中重用。
这个 Skill 有哪些优点和局限?
- 有界执行:通过明确的终止条件、审批门槛和避免无限迭代,防止无限自动化。
- 多路径支持:覆盖发现、查找、审计、适配、设计、运行、复盘、保存和发布等多个流程。
- 实时目录:使用实时目录查找已发布的循环,避免虚假推荐。
- 基于证据的决策:在推荐循环时要求有具体的证据(如出现次数)。
- 兼容性:作为 `loop-library` 提供兼容别名,便于旧安装使用。
- 依赖实时目录:查找已发布的循环需要网络访问,且目录不可用时无法使用。
- 无测试套件:仓库中未提及自动化测试,可能需要手动验证。
- 平台特定安装:安装命令仅针对 Codex、Cursor 和 Claude Code 提供。
- 假设参考文件存在:技能引用如 discover.md 和 audit.md 等文件,但仓库中未明确列出,实际可能缺失。
如何安装这个 Skill?
通过 npm/npx 安装:在 Codex、Cursor 或 Claude Code 中运行 npx skills add Forward-Future/loopy --skill loopy --agent codex -g -y(或对应 agent 名称)。该仓库还包含一个兼容别名 loop-library,可用于旧安装。安装后,使用 /loopy 或 $loopy 调用。
如何使用这个 Skill?
安装后,直接用自然语言描述任务。例如,在 Claude Code 或 Cursor 中:/loopy Find a loop for improving test reliability.。在 Codex 中,从 /skills 选择 Loopy,或使用 $loopy 命令。技能会引导您完成路径:如果请求模糊,它会询问“您想要实现什么?”。您也可以显式指定路径,如“分析这个仓库和我的编码线程中的重复工作”或“审计这个循环”。