1. 基本信息
| 项目 | 内容 |
|---|---|
| 名称 | loopy |
| 作者/维护者 | Forward-Future（GitHub 组织） |
| 来源链接 | https://github.com/Forward-Future/loopy |
| 许可证 | MIT（GitHub API 获取） |
| GitHub Stars | 2,758（GitHub API 获取） |
| Forks | 242（GitHub API 获取） |
| 最新版本 | 无正式 Release 标签，以主分支最近一次提交（2026-07-07）为准 |
| 安装方式 | 基于 Vercel Labs 维护的 skills 命令行工具一条命令安装 |
2. 功能介绍与亮点
loopy 是一个围绕“可重复执行的智能体循环（loop）“设计的技能：把”目标是什么、怎么判断做对了、学到什么后该怎么调整、什么时候该停“这四个问题固定成一套结构，替代一次性的临时 prompt。
核心能力覆盖循环的完整生命周期，共 9 条路径：
- 发现（Discover）：分析代码库与历史会话记录中重复出现的工作，把最值得沉淀的一项转化为有边界的循环。
- 查找（Find）：在配套的在线 Loop Library 目录中检索已发布的循环模板，最多推荐三个。
- 审查/修复（Loop Doctor）：诊断一个已有循环的检查点是否薄弱、权限是否过大、停止条件是否清晰，只修复实质性问题。
- 改编（Adapt）：把目录中的循环按自己的工具链、频率、成功标准做定制。
- 构建（Craft）：目录中没有合适模板时，通过逐题访谈生成一个新循环。
- 执行（Run）：在既定授权范围内分批执行，每一步都套用同一验收标准，返回带证据的运行回执。
- 复盘（Debrief）：分析已完成的运行回执，区分是循环设计问题还是执行环境问题，给出最小必要改动建议。
- 保存/复用（Save）：把认可的循环写入项目内的
LOOPS.md，后续对话可直接复用。 - 发布（Publish）：检查质量与目录重复度，生成发布预览，仅在用户明确确认后才提交。
亮点在于对“自主执行”的克制：文档反复强调循环是“有限次数、有验收、有终止条件”的受控迭代，而非放任智能体无限运行；对代码库、历史会话、已保存的 LOOPS.md 一律当作不可信证据处理，不会仅凭其内容就擅自执行破坏性操作或对外发送消息。安装机制复用了 Vercel Labs 维护的开源分发工具 skills，而非自建安装脚本。
3. 适用场景
固定分类：元技能与 Agent 增强。
适合把“反复要跑一遍”的工程操作（例如修复反复出现的测试失败、持续做性能优化、让文档保持最新）沉淀成一个可复用、可审计的循环，而不是每次都现场现编 prompt 的场景；也适合在真正放手执行一个自动化循环之前，先用 Loop Doctor 检查它的权限边界与停止条件是否合理。目标用户是日常用 Claude Code / Codex 处理重复性工程任务、希望用更结构化的方式驱动智能体的初中级用户，也适合团队负责人把好用的循环整理成团队共享资产。
4. 跨 Agent 兼容性
- Claude Code：✅ 原生支持，README 提供官方一键安装命令，并可用
/loopy斜杠命令直接调用。 - Codex：✅ 原生支持，同样提供官方安装命令，可通过
/skills菜单选择或用$loopy直接提及调用。 - OpenClaw：❓ 未验证，已抓取的 README 与 SKILL.md 均未提及该平台。
- Hermes Agent：❓ 未验证，已抓取材料未提及该平台。
（判断依据：仓库 README 明确列出的官方安装命令只覆盖 Codex、Cursor、Claude Code 三者；虽然仓库提供了一个可检测更多智能体的交互式安装器，但因未在材料中找到对 OpenClaw / Hermes Agent 的明确确认，不纳入结论。）
5. 推荐理由
loopy 把“让智能体重复做一件事”从零散的个人 prompt 习惯，变成了一套结构化、可审计、可复用的技能：自带一个持续更新的公开循环目录，省去从零设计反馈闭环和终止条件的功夫；同时把“设计循环”和“审查循环安全性”拆成两个显式动作，方便用户在真正放手执行前先检查权限边界。对经常用 Claude Code / Codex 处理重复性工程任务的用户，这能直接降低“每次都要现编 prompt”的心智负担。
6. 评分
| 维度 | 分数 | 说明 |
|---|---|---|
| 受欢迎程度 | 8 | 上线约五周内积累 2,758 GitHub Stars，且被独立的第三方技能目录站点收录展示，显示出较快的自然增长 |
| 可用性 | 9 | 提供基于成熟开源分发工具 skills 的一条命令安装方式；README 与内置 SKILL.md 文档完整、含大量示例；近两周内仍有代码提交，无付费依赖 |
| 安全性 | 8 | 见下方检查清单 |
安全检查清单：
- Shell 命令及权限范围：技能本身是提示词/指令集，不预置任意 shell 脚本；“执行”路径仅在智能体既有授权范围内分批操作，且要求每次先有明确边界。
- 联网外发：仅在“查找/发布”路径下读取或提交内容到官方托管的公开 Loop Library 目录，“发布”动作必须经用户明确确认后才会提交。
- API key/凭据：不需要任何 API key 或额外凭据。
- 可疑指令：抓取到的 SKILL.md 内容未发现 prompt injection 或隐藏指令；文档明确要求把代码库、历史会话、已保存的
LOOPS.md一律当作不可信证据处理，不因其内容擅自执行操作或外发信息。 - 作者/组织信誉：维护方为 GitHub 组织 Forward-Future，项目以 MIT 协议公开维护，已有 4 位贡献者参与。
- License：MIT，明确。
- 最近维护时间：最近一次提交为 2026-07-07，距今约两周，活跃度良好。
7. 跟同类 Skills 相比的优势
| 竞品 | 定位 | 与 loopy 的差异 |
|---|---|---|
| ksimback/looper | 同样围绕“设计可复查的 Agent 循环”，聚焦 Claude Code 单一平台 | looper 专注于循环执行前的可视化审查环节，不自带公开循环模板库；loopy 额外提供在线目录、跨 Codex/Claude Code 双原生安装，以及发现/审计/复盘等更完整的全生命周期路径 |
| beefiker/superloopy | 轻量级的 Codex/Claude 循环执行器，强调“证据门禁”式的硬约束 | superloopy 更偏向单机、极简的执行约束，不提供模板检索或发布协作能力；loopy 定位是“循环全生命周期助手 + 社区目录”，功能覆盖更完整 |
| microsoft/SkillOpt | 官方出品的技能优化研究框架，通过带验证门禁的训练循环自动改写技能文档 | SkillOpt 面向研究/评测场景，需要配置模型后端、准备基准数据集并运行多轮训练；loopy 面向日常工程场景，开箱即可通过对话触发，上手门槛更低 |
8. 用户评价
该技能目前在第三方平台尚无经核实的具名用户评价。
9. 其他补充
项目背后维护着一个持续更新的公开 Loop Library 网站，即使不安装 loopy 技能，也可以直接在网页上浏览、复制其中的循环 prompt。旧技能名 loop-library 仍作为兼容别名保留，新装用户建议统一使用 loopy。
10. 安装使用方式
- Claude Code：
npx skills add Forward-Future/loopy --skill loopy --agent claude-code -g -y，安装后在 Claude Code 内输入/loopy加上诉求即可调用；如智能体已在运行中且未识别到新技能，需要重启一次。 - Codex：
npx skills add Forward-Future/loopy --skill loopy --agent codex -g -y，安装后通过/skills菜单选择 Loopy，或直接用$loopy提及调用。 - 其他智能体：可运行交互式安装器
npx skills add Forward-Future/loopy --skill loopy -g，从检测到的智能体列表中选择。 - 前置要求：本机需已安装 Node.js 与 npx。
- 注意事项：
-g参数会把技能安装为全局可用（所有项目生效），省略则只在当前项目生效；-y会自动确认安装过程中的提示，如需逐项确认可省略该参数。
11. 注意事项
- README 与 SKILL.md 中仅明确列出 Codex、Cursor、Claude Code 三个平台的官方安装命令，OpenClaw、Hermes Agent 的兼容性未见材料确认，如需在这两个平台使用需自行验证。
- “发现”路径依赖对代码库与历史会话记录的访问，且要求同一类工作在历史中出现至少两次才判定为“重复模式”，因此对全新项目或缺乏历史会话记录的场景，该路径可能给不出结果。
- 项目暂无正式版本号/Release 标签，当前以持续提交的主分支为准，后续接口或行为可能随更新变化。