100个精心策划的AI驱动自动化循环，覆盖软件开发、数据科学、内容创作、产品运营、学习管理等多个领域。面向中国用户优化，全中文文档与提示词支持。

English README

1. 什么是 Loop？
2. 什么时候用 Loop？
3. 一分钟快速开始
4. 安装 Skill
5. 在各 Agent 中使用
6. Loop 完整目录
7. 场景速查表
8. 创建自己的 Loop
9. 最佳实践
10. 中国区用户指南
11. 常见问题

Loop（循环） 是一种用于 AI 编程助手（如 Claude Code、Cursor、Trae、Windsurf、Cline）的自动化工作流指令集。它通过"执行→检查→修复→重复"的闭环模式，让 AI 能够自主完成任务，直到达到预设目标。

开始
  │
  ▼
运行检查命令
  │
  ├─ 通过 ──► 结束
  │
  └─ 失败 ──► 分析失败原因
                  │
                  ▼
            修复最小根因
                  │
                  ▼
            迭代次数 +1
                  │
                  ▼
            是否超过最大迭代次数？
                  │
            是 ──► 结束，提示人工介入
            否 ──► 回到运行检查命令

当你需要：

• 持续迭代 - 需要反复检查、修复、再检查的任务
• 质量把关 - 保持代码、文档、数据处于健康状态
• 自动化工作流 - 减少重复性的人工操作
• CI/CD 集成 - 自动化修复失败的 CI 构建
• TDD 开发 - 测试驱动开发，先写测试再实现
• 内容优化 - 反复打磨文案、博客、脚本
• 数据处理 - 清洗数据、训练模型、生成报告

Claude Code 原生支持 Skill：把仓库放到 ~/.claude/skills/loops/ 即可被自动发现，无需手动加载。

⚠️ 命名冲突提示：Claude Code 自带一个内置 /loop skill。为避免误触发内置那个，本仓库统一使用 /loops <name>（复数）调用。如果你输入 /loop xxx 后发现触发的是内置的而不是本仓库的，请改用 /loops xxx，或直接用自然语言描述（见 §5.7 直接复制提示词去任意 Agent）。

# 克隆到 Claude Code 的个人 skill 目录（推荐，自动发现）
git clone https://github.com/jwangkun/loops.git ~/.claude/skills/loops

# 也可以克隆到 ~/.loops 后再链接/复制，方便多 Agent 共用
git clone https://github.com/jwangkun/loops.git ~/.loops
ln -s ~/.loops ~/.claude/skills/loops   # macOS/Linux 软链接

# 启动 Claude Code（无需任何特殊参数，skill 会自动加载）
claude

# 使用任意 Loop
/loops test-until-green

AI 会自动执行：

1. 运行检查命令（如 npm test）
2. 找到失败或不足
3. 修复最小根因
4. 重新运行检查
5. 重复直到目标达成

AI 会告诉你每一步的操作结果，你只需在必要时介入。

推荐原则：先把 Loops 装到全局位置，这样所有项目都能调用；只有需要项目隔离时，才按项目安装。

全局安装路径建议：~/.claude/skills/loops（Claude Code）、~/.trae/skills/loops（Trae）、~/.codex/AGENTS.md（Codex）、~/.loops（通用，配合软链接）。

Claude Code 原生支持基于目录的 Skill 自动发现。把 SKILL.md 放进 ~/.claude/skills/loops/ 后，启动 claude 即自动加载，无需任何启动参数。

⚠️ 命名冲突：Claude Code 自带一个内置 /loop skill。本仓库统一用 /loops <name>（复数）调用，避免误触发内置的那个。详见 §5.2。

方法 A：克隆到 skill 目录（推荐，自动发现）

# 1. 克隆到 Claude Code 个人 skill 目录
git clone https://github.com/jwangkun/loops.git ~/.claude/skills/loops

# 2. 启动 Claude Code（无需 --system-prompt）
claude

# 3. 调用任意 Loop
/loops test-until-green

方法 B：克隆到通用位置 + 软链接（多 Agent 共用）

git clone https://github.com/jwangkun/loops.git ~/.loops
ln -s ~/.loops ~/.claude/skills/loops   # macOS/Linux
# Windows 下用复制代替：xcopy /E /I %USERPROFILE%\.loops %USERPROFILE%\.claude\skills\loops

方法 C：--system-prompt 变通法（临时会话或旧版 Claude Code）

# 整个 Skill
claude --system-prompt ~/.loops/SKILL.md

# 或只为单个 Loop 启动临时会话
claude --system-prompt ~/.loops/prompts/zh/test-until-green.md

方法 D：粘贴到已在运行的会话

如果 claude 已经在运行但没自动加载 skill，可直接把 SKILL.md 内容粘贴进对话：

cat ~/.loops/SKILL.md | pbcopy    # macOS；Linux 用 xclip -sel c；Windows 用 clip
# 在 Claude Code 中粘贴即可，然后使用 /loops <name>

Trae 支持基于 .trae/skills/ 目录结构自动识别 Skill。全局路径为 ~/.trae/skills/loops/。

# macOS / Linux
mkdir -p ~/.trae/skills/loops
cp ~/.loops/SKILL.md ~/.trae/skills/loops/
cp -r ~/.loops/prompts ~/.trae/skills/loops/

# Windows
mkdir %USERPROFILE%\.trae\skills\loops
copy %USERPROFILE%\.loops\SKILL.md %USERPROFILE%\.trae\skills\loops\
xcopy /E /I %USERPROFILE%\.loops\prompts %USERPROFILE%\.trae\skills\loops\prompts

安装后在 Trae 的 AI 对话框中输入：

/loops test-until-green

或：

@loops /loops test-until-green

Trae 全局 Skill 的支持取决于版本，如果全局不生效，请改用下面的项目级安装。

⚠️ 旧版 .cursorrules 已被 Cursor 弃用。新版 Cursor 使用 .cursor/rules/*.mdc 文件（带 YAML frontmatter），支持按 glob 匹配文件自动激活。下面是新做法。

项目级安装（推荐，Cursor 官方主推）

cd your-project
mkdir -p .cursor/rules

# 创建 loops.mdc，内容如下
cat > .cursor/rules/loops.mdc << 'EOF'
---
description: Loops 自动化循环集合。当用户需要自动化测试、CI修复、代码质量、内容创作、数据分析等任务时按 Loop 模式执行。
globs:
  - "**/*"
alwaysApply: false
---

# Loops Skill

你是一名熟练使用 Loops 的 AI 开发助手。当用户要求自动化测试、CI修复、代码质量检查、内容创作、数据分析、学习管理等任务时，请先读取 `~/.loops/prompts/zh/` 目录中的对应 Loop 提示词，然后按照 Loop 的"执行→检查→修复→重复"模式执行任务。

调用方式：`/loops <name>`（复数，避免与内置冲突）。

常用 Loop：
- 测试失败：/loops test-until-green
- CI修复：/loops fix-ci-until-green
- 代码质量：/loops lint-typecheck-fix
- PR审查：/loops pr-self-review
- TDD开发：/loops autoloop-tdd
- 文档同步：/loops docs-sync-after-edits
- 博客优化：/loops blog-post-until-publish
- 数据清洗：/loops data-cleaning-loop
- 会议纪要：/loops meeting-notes-cleaner
EOF

全局安装（对所有 Cursor 项目生效）

Cursor 官方目前主推项目级 .cursor/rules/，全局规则可在用户主目录放一个 .cursor/rules/loops.mdc（同上内容）。若全局不生效，建议改用项目级或参考 §5.7 直接复制提示词。

请确保已执行 git clone https://github.com/jwangkun/loops.git ~/.loops，否则 ~/.loops/prompts/zh/ 路径不存在。

Windsurf（Codeium）读取项目根目录的 .windsurfrules 文件，或全局的 ~/.codeium/windsurf/global_rules.md。

项目级安装（推荐）

cd your-project
cat > .windsurfrules << 'EOF'
# Loops Skill 配置
你是一名熟练使用 Loops 的 AI 开发助手。当用户要求自动化测试、CI修复、代码质量检查、内容创作、数据分析等任务时，请先读取 `~/.loops/prompts/zh/` 目录中的对应 Loop 提示词，然后按 Loop 的"执行→检查→修复→重复"模式执行。

调用方式：/loops <name>（复数，避免与 Claude Code 内置 /loop 冲突）。
常用：/loops test-until-green、/loops fix-ci-until-green、/loops lint-typecheck-fix、/loops pr-self-review
EOF

全局安装（所有 Windsurf 项目）

mkdir -p ~/.codeium/windsurf
cat > ~/.codeium/windsurf/global_rules.md << 'EOF'
# Loops 全局配置（同上内容）
EOF

Cline 读取项目根目录的 .clinerules 文件（或 .clinerules/ 文件夹）。规则会自动追加到每次对话的系统提示。

项目级安装（推荐）

cd your-project
cat > .clinerules << 'EOF'
# Loops Skill 配置
你是一名熟练使用 Loops 的 AI 开发助手。当用户要求自动化测试、CI修复、代码质量检查、内容创作、数据分析等任务时，请先读取 `~/.loops/prompts/zh/` 目录中的对应 Loop 提示词，然后按 Loop 的"执行→检查→修复→重复"模式执行。

调用方式：/loops <name>（复数，避免与 Claude Code 内置 /loop 冲突）。
常用：/loops test-until-green、/loops fix-ci-until-green、/loops lint-typecheck-fix、/loops pr-self-review
EOF

也可在 Cline 聊天框下方的 Rules 面板用 + 按钮新建规则，效果相同。

OpenAI Codex（CLI / IDE 扩展 / Cloud）通过 AGENTS.md 文件读取指令——开始任何工作前会先读取它。Codex 没有 /loops 这类斜杠命令，调用方式是自然语言 + 引用 Loop 名称。它按「全局 → 项目根 → 当前目录」的顺序加载，后者覆盖前者。

全局安装（所有 Codex 项目，推荐）

mkdir -p ~/.codex
cat > ~/.codex/AGENTS.md << 'EOF'
# Loops Skill（全局配置）

你是一名熟练使用 Loops 的 AI 开发助手。当用户要求自动化测试、CI修复、代码质量检查、内容创作、数据分析、学习管理等任务时，请先读取 `~/.loops/prompts/zh/` 目录中的对应 Loop 提示词，然后严格按 Loop 的"执行→检查→修复→重复"模式执行任务。

常用 Loop（按需选用，名称即提示词文件名）：
- test-until-green：修复失败测试直到全绿
- fix-ci-until-green：修复当前分支 CI
- lint-typecheck-fix：lint + typecheck 干净
- pr-self-review：对当前 diff 做三轮自我审查
- autoloop-tdd：测试优先地实现目标行为
- docs-sync-after-edits：文档与代码变更同步
EOF

项目级安装（推荐用于团队共享）

cd your-project
cat > AGENTS.md << 'EOF'
# Loops Skill（项目配置）

本项目使用 Loops 自动化循环。任务执行前先读取 `~/.loops/prompts/zh/<loop-name>.md`（或仓库内的 `prompts/zh/`），按其"执行→检查→修复→重复"流程执行。

常用：test-until-green、fix-ci-until-green、lint-typecheck-fix、pr-self-review。
检查命令、退出条件、最大迭代次数以各 Loop 文件为准。
EOF

Codex 也会自动发现仓库根目录的 AGENTS.md，适合放进版本控制让团队共用。AGENTS.override.md（子目录）可覆盖上层规则。

Codex 原生契合 Loop：本仓库的 pr-babysitter、pr-watch-loop 就是针对 Codex 的 PR 看护场景设计的（使用 codex-watch 标签）。

如果你希望某个项目使用独立的 Loops 版本，可按项目安装到任意 IDE 的规则目录（参考 4.2 Trae 示例）：

cd your-project
mkdir -p .trae/skills/loops
cp ~/.loops/SKILL.md .trae/skills/loops/
cp -r ~/.loops/prompts .trae/skills/loops/

各 IDE 的本地配置目录（.trae/、.cursor/、.clinerules、.windsurfrules 等）不应提交到版本控制，已在 .gitignore 中忽略。

cd your-project
git submodule add https://github.com/jwangkun/loops.git .loops
# 然后按你用的 Agent 把 .loops/SKILL.md 链接到对应规则位置

/loops <loop-name> [上下文参数]

本仓库统一用 /loops（复数），避免与 Claude Code 内置的 /loop skill 冲突。其它 Agent（Trae/Cursor/Windsurf/Cline）同样使用 /loops。

Claude Code 装到 ~/.claude/skills/loops/ 后自动发现，直接调用即可：

/loops fix-ci-until-green

或用自然语言：

请按 test-until-green 的 Loop 流程，修复当前所有失败的测试

若 /loops xxx 未触发本仓库的 Loop（例如仍触发内置的 /loop），检查 ~/.claude/skills/loops/SKILL.md 是否存在；或改用 §5.7 直接复制提示词。

@loops /loops test-until-green

或自然语言：

帮我运行 test-until-green，修复所有失败的测试

运行 lint-typecheck-fix 的 Loop 流程，清理代码

Cursor 会读取 .cursor/rules/loops.mdc 中的配置并执行（见 §4.3）。

Codex 没有斜杠命令，全部用自然语言调用。配置好 ~/.codex/AGENTS.md 或项目根的 AGENTS.md 后（见 §4.6），在 Codex CLI / IDE 扩展 / Cloud 里直接说需求并点 Loop 名：

请按 test-until-green 这个 Loop 的流程，运行 npm test，修复所有失败用例直到全绿。

或更简洁：

用 fix-ci-until-green 修复当前分支的 CI 失败。

Codex 会从 AGENTS.md 知道去哪里读 Loop 提示词（~/.loops/prompts/zh/）。本仓库的 pr-babysitter、pr-watch-loop 就是为 Codex 的 PR 看护场景设计的。

如果你记不住 Loop 名称，可以直接描述需求：

我有一些测试失败了，帮我用 Loop 的方式修复它们

AI 助手会根据你的需求自动匹配最合适的 Loop。

不想装 Skill、或者用的是 ChatGPT / Claude.ai / Gemini / Copilot Chat / 通义 / 文心 等对话框？直接把某个 Loop 的提示词全文复制进对话即可，无需安装。三步：

第 1 步：选一个 Loop 文件

# 中文版（推荐）
ls ~/.loops/prompts/zh/
# 英文版
ls ~/.loops/prompts/en/

第 2 步：复制全文到剪贴板

# macOS
cat ~/.loops/prompts/zh/test-until-green.md | pbcopy

# Linux（需 xclip）
cat ~/.loops/prompts/zh/test-until-green.md | xclip -sel c

# Windows（Git Bash / WSL）
cat ~/.loops/prompts/zh/test-until-green.md | clip.exe

# 或者：直接在 GitHub / 编辑器里打开文件，Ctrl+A 全选复制

第 3 步：粘贴到任意 Agent 对话框，加一句指令

请严格按照下面这个 Loop 的流程执行，每完成一轮检查后把结果告诉我：

（粘贴 Loop 提示词全文）

示例：在 ChatGPT / Claude.ai 里跑 test-until-green

把 prompts/zh/test-until-green.md 全文粘贴进对话框，前面加一句：

我在 [项目路径/仓库链接] 工作，请按下面这个 Loop 的"执行→检查→修复→重复"模式帮我修复测试，每轮告诉我检查命令的输出和你的修复：

注意：纯对话框类 Agent 无法直接执行 npm test 等命令，需要你把命令输出贴回给它。适用于内容创作、数据分析、学习管理类不需要执行本地命令的 Loop（如 blog-post-until-publish、meeting-notes-cleaner、prd-review-loop）。

先运行 /loops lint-typecheck-fix，然后运行 /loops test-until-green

1. 复制 prompts/zh/test-until-green.md
2. 重命名为 prompts/zh/my-loop.md
3. 修改标题、目标、检查命令、步骤
4. 在 prompts/en/ 中创建对应的英文版本

---
name: "my-custom-loop"
description: "你的Loop目标"
---

# 你的Loop标题

**分类:** 自定义  
**标识符:** `my-custom-loop`  
**最大迭代次数:** 5

## 目标

描述Loop要达成的最终状态

## 检查命令

```bash
npm run your-check-command

检查命令返回成功

Step 1: 运行检查命令。 Step 2: 如果失败，修复最小根因。 Step 3: 重复直到退出条件满足。

Claude Code、Cursor、Trae

### 8.3 创建 Loop 的 5 个原则

1. **目标清晰** - 必须有一个可验证的目标
2. **检查命令明确** - 必须有一个命令能判断是否达成目标
3. **可迭代修复** - 每次失败后都能进行小步修复
4. **有退出条件** - 避免无限循环
5. **保持最小化** - 每个 Loop 只负责一个职责

---

## 9. 最佳实践

### 9.1 使用前的准备

- 运行前最好提交当前工作
- 确保环境依赖已安装
- 设置合理的最大迭代次数

### 9.2 执行原则

- 每次只修复最小根因
- 每次修改后必须运行检查命令
- 重要的运行结果保存日志
- 达到最大迭代次数时人工介入

### 9.3 安全建议

- 修改依赖前先备份 `package-lock.json`
- 会修改远程仓库的 Loop 谨慎使用
- 生产部署相关 Loop 在监控下运行
- 涉及密钥扫描、权限审查的 Loop 需审计后再执行

### 9.4 与 Git 工作流结合

```bash
# 1. 创建功能分支
git checkout -b feature/new-stuff

# 2. 用 Loop 实现功能
/loops autoloop-tdd

# 3. 用 Loop 自我审查
/loops pr-self-review

# 4. 提交推送
git commit -am "feat: add new stuff"
git push origin feature/new-stuff

# 5. 确保 CI 通过
/loops fix-ci-until-green

本仓库主要面向中国用户，因此：

• 所有 Loop 提示词提供完整中文版本
• README 和 SKILL.md 使用中文编写
• 提供中国区网络加速建议
• 兼容国内主流 AI 编程助手（Trae、Cursor 等）

# npm 切换到淘宝镜像
npm config set registry https://registry.npmmirror.com

# 全局设置
npm config set registry https://registry.npmmirror.com --global

# 安装依赖时使用镜像
npm install --registry=https://registry.npmmirror.com

如果 GitHub 访问较慢：

# 方式一：Gitee 镜像
git clone https://gitee.com/jwangkun/loops.git

# 方式二：下载 zip
curl -L -o loops.zip https://github.com/jwangkun/loops/archive/refs/heads/main.zip
unzip loops.zip

A1: 尝试以下方法：

1. Claude Code：确认 ~/.claude/skills/loops/SKILL.md 存在（官方自动发现）；或在对话中粘贴 SKILL.md 内容；或用 claude --system-prompt ~/.loops/SKILL.md 启动。
2. Claude Code 命名冲突：若 /loops xxx 触发的是 Claude Code 内置的 /loop 而非本仓库，确认 skill 目录命名是 loops（不是 loop），或直接用自然语言描述需求。
3. Trae：检查 ~/.trae/skills/loops/ 是否存在 SKILL.md 和 prompts/。
4. Cursor：检查 .cursor/rules/loops.mdc 是否存在（旧版 .cursorrules 已废弃）。
5. Windsurf：检查项目根的 .windsurfrules 是否存在。
6. Cline：检查项目根的 .clinerules 是否存在。
7. Codex：检查 ~/.codex/AGENTS.md 或项目根的 AGENTS.md 是否配置了 Loops（Codex 用自然语言调用，无斜杠命令）。
8. 都不行时，用 §5.7 直接复制提示词 把 Loop 文件全文粘进对话框。

A2:

1. 检查 package.json 中是否有对应 scripts
2. 安装缺失的工具或依赖
3. 修改 Loop 文件中的检查命令以匹配你的项目

A3: 是的，Loop 的核心就是自动修复问题。建议运行前先提交当前代码或备份重要文件。

A4: 可以。prompts/zh/ 目录下全是中文提示词。

A5:

1. 在 prompts/zh/ 和 prompts/en/ 中各添加一个文件
2. 文件名使用小写连字符格式
3. 更新 README 和 SKILL.md 中的目录
4. 提交 Pull Request

A6: 新增的 Loop 参考了 SkillHub、SkillsMP 等热门 AI Skills 市场的常见需求，以及日常工作中的高频自动化场景，涵盖数据科学、内容创作、产品运营、学习管理等领域。

loops/
├── prompts/
│   ├── en/                   # 英文版 Loop 提示词 (100个)
│   │   ├── test-until-green.md
│   │   ├── data-cleaning-loop.md
│   │   └── ...
│   └── zh/                   # 中文版 Loop 提示词 (100个)
│       ├── test-until-green.md
│       ├── data-cleaning-loop.md
│       └── ...
├── SKILL.md                  # Skills 入口文件（安装时复制到 .trae/skills/loops/）
├── README.md                 # 中文说明文档
├── README_EN.md              # 英文说明文档
└── generate_all_prompts.py   # Loop 元数据与生成脚本

注意：.trae/ 是本地 IDE 配置目录，不应提交到版本控制。安装 Skill 时，请将 SKILL.md 和 prompts/ 复制到你的项目 .trae/skills/loops/ 目录下。

• Loops! 官方站点
• SkillHub - Agent Skills 市场
• SkillsMP - 最大的 Agent Skills 市场
• GitHub 仓库
• Gitee 镜像

许可证: MIT
版本: 2.0.0
维护: Loops Community