loop-library 是什么?

Loop Library 0.1.1 是带内置目录的 Agent 循环推荐与适配 CLI,也可作为 Skill 使用;它不负责调度或自动执行生产任务。

⭐ 3,120 Stars 🍴 276 Forks JavaScript MIT 作者: Forward-Future
来源:github.com/khoantd/loop-library 查看 GitHub 仓库 → 📘 使用教程 →

为什么值得关注

npm 最新版 0.1.1 发布于 2026-06-22;GitHub 没有 release,仓库主分支 package.json 可能仍显示 0.1.0。Loop Library 0.1.1 是带内置目录的 Agent 循环推荐与适配 CLI,也可作为 Skill 使用;它不负责调度或自动执行生产任务。

来源:github.com/khoantd/loop-library

核心功能

循环目录查询

recommend、search、show、list 从内置 catalog 查找工作流,可输出 JSON 或文本。

来源:github.com/khoantd/loop-library
任务适配

adapt 根据具体任务重写 loop 草案,仍需人工补足权限、预算和停止条件。

来源:github.com/khoantd/loop-library
Skill 接入

可通过 skills CLI 安装为 Agent Skill,指导宿主推荐流程。

来源:github.com/khoantd/loop-library

技术架构

Node CLI 读取随包发布的目录,--online 可取实时数据并在失败时回退;Skill 仅向宿主提供选择说明,真正工具调用由宿主执行。

来源:github.com/khoantd/loop-library

项目知识图谱

知识图谱:项目核心节点(中心)+ 核心功能(内环六边形)+ 关键技术依赖(外环 chip) Node.js 20+ 可选 skills CLI 具体 loop 所需宿主工具具体 loop 所需… 循环目录查询 任务适配 Skill 接入 loop-library 项目本体 核心功能 关键依赖

技术栈

语言JavaScript/Node.js框架零运行依赖 CLI + Agent Skill
Node.js 20+可选 skills CLI具体 loop 所需宿主工具
默认内置离线 catalog;--online 才访问网络
来源:github.com/khoantd/loop-library/blob/main/package.json

快速上手

路径一用 npx loop-library@0.1.1 recommend/search/show/adapt 并检查 JSON;路径二用 npx skills add 安装为全局 Skill,在临时仓库先只推荐不执行。
来源:github.com/khoantd/loop-library

使用场景

适合已有 Agent、需要为工程、评估、运维、内容或设计任务选择验证循环的用户;需要项目状态、Git worktree 和自动开发执行时应选完整工作流工具。

来源:github.com/khoantd/loop-library;https://github.com/open-gsd/gsd-pi

优势与局限

优势

  • 默认可离线查询
  • JSON 输出便于审阅与自动化
  • 覆盖多类任务且不绑定单一 Agent

局限

  • 推荐分数不证明流程适用
  • 不会提供安全沙箱或调度器
  • 实际权限和成本取决于宿主与 loop
来源:github.com/khoantd/loop-library

最新版本

npm 最新版 0.1.1 发布于 2026-06-22;GitHub 没有 release,仓库主分支 package.json 可能仍显示 0.1.0。

来源:www.npmjs.com/package/loop-library;https://github.com/khoantd/loop-li…

实测与证据

status: official_docs_checked_not_installed  |  checked_at: 2026-09-23  |  environment: 静态核对 README、package.json 与 npm 元数据  |  limitations: 未执行 npx、安装 Skill 或运行循环  |  observed_output: 确认 npm 最新 0.1.1、Node 20+、recommend/search/show/list/adapt、JSON 字段、--online 回退和 Skill 安装

来源:github.com/khoantd/loop-library

同类项目对比

GSD Pi 是维护 .gsd 状态、计划、验证证据和 worktree 的可运行开发 Agent;Loop Library 是跨领域循环目录,不执行任务或保存项目状态。

来源:github.com/open-gsd/gsd-pi;https://github.com/khoantd/loop-library

总结评价

流量持续且内容能解决明确问题。使用价值在于把验证、反馈和停止条件写清,不能把目录推荐误写为自动执行或安全保证。

来源:github.com/khoantd/loop-library

常见问题

Loop Library 0.1.1 会自动执行循环吗?

不会。CLI 负责推荐、搜索、查看和适配循环,Skill 负责指导 Agent 选择工作流;它不会自行启动生产任务、发送消息或获得额外权限。真正执行时仍受宿主 Agent 的工具和批准规则约束。

Loop Library 离线能用吗?

可以。0.1.1 CLI 带有内置 catalog;只有显式加入 --online 才尝试取实时目录,并在失败时回退内置数据。需要严格离线时不要使用 --online,也要检查宿主 Agent 本身的网络权限。

怎样判断推荐的 loop 合适?

检查 JSON 输出中的 slug、useWhen、prompt、matchedFields 和 scores,再审读循环的验证动作、权限、预算与停止条件。先用可回滚小任务跑有限轮数,不能只看匹配分数。

Loop Library 如何升级而不破坏现有流程?

先保存当前 npm 版本、loop slug 和适配后的文本,再安装固定的新版本并对同一任务重复 recommend、show 和小样本运行。仓库 package.json 与 npm 版本可能不同,应以实际安装的 npm 版本为准。

资料与核验范围
本文依据项目公开资料整理。版本、安装命令和功能边界可能随上游更新,请以所列来源和项目当前版本为准。 资料核对时间: 2026-09-23 13:55.

参考材料:README、GitHub API、依赖文件