Loops

Loops - AI驱动的自动化循环集合

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

本 Skill 提供 100 个经过验证的 AI 自动化循环，覆盖软件开发、测试、CI/CD、代码质量、数据科学、内容创作、产品运营、学习管理、系统运维、安全合规等场景。

目录

1. 安装 Skill
2. 在 Agent 中使用
3. 快速开始
4. Loop 使用语法
5. 完整 Loop 目录
6. 场景速查表
7. 最佳实践
8. 故障排除
9. 创建自己的 Loop
10. 中国区用户须知

1. 安装 Skill

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

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

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

1.1 Claude Code 安装（推荐，全局可用）

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

方法 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：用 --append-system-prompt 在启动时注入（已运行的会话用方法 D 粘贴）

⚠️ claude --system-prompt <文件> 是错误写法：--system-prompt 接受字面文本且会完全替换默认系统提示，读取文件的 --system-prompt-file 仅支持 -p 打印模式。临时会话请用 --append-system-prompt 追加内容：

# 整个 Skill（保留默认能力，仅追加 Loops 指令）
claude --append-system-prompt "$(cat ~/.loops/SKILL.md)"

# 或只为单个 Loop 启动临时会话
claude --append-system-prompt "$(cat ~/.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>

1.2 Trae IDE 安装（全局 Skill）

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

# 1. 确保 Loops 已在 ~/.loops
git clone https://github.com/jwangkun/loops.git ~/.loops

# 2. 复制到 Trae 全局 Skill 目录
mkdir -p ~/.trae/skills/loops
cp ~/.loops/SKILL.md ~/.trae/skills/loops/
cp -r ~/.loops/prompts ~/.trae/skills/loops/

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

/loops test-until-green

或：

@loops /loops test-until-green

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

1.3 Cursor 安装（.cursor/rules/loops.mdc）

⚠️ 旧版 .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（同上内容）。若全局不生效，建议改用项目级或参考 §2.7 直接复制提示词。

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

1.4 Windsurf 安装（.windsurf/rules/ 或 .windsurfrules）

Windsurf（Codeium）读取项目里的规则文件。新版用目录 .windsurf/rules/*.md（带 YAML frontmatter，支持 always_on / model_decision / glob / manual 四种激活模式）；旧版 .windsurfrules（项目根）仍被兼容。全局规则放在 ~/.codeium/windsurf/memories/global_rules.md（注意中间有 memories/ 目录，单文件约 6000 字符上限）。

项目级安装 —— 方式 A：新版 .windsurf/rules/（推荐）

cd your-project
mkdir -p .windsurf/rules
cat > .windsurf/rules/loops.md << 'EOF'
---
description: Loops 自动化循环集合。当用户需要自动化测试、CI修复、代码质量、内容创作、数据分析等任务时按 Loop 模式执行。
trigger: model_decision
---

# 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

项目级安装 —— 方式 B：旧版 .windsurfrules（兼容，单文件）

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

1.5 Cline 安装（.clinerules）

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 面板用 + 按钮新建规则，效果相同。

1.6 Codex 安装（AGENTS.md）

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 标签）。

1.7 项目级安装（通用）

如果你希望某个项目使用独立的 Loops 版本，可按项目安装到任意 IDE 的规则目录（参考 1.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、AGENTS.md 等）不应提交到版本控制（除非作为团队共享约定），已在 .gitignore 中忽略。

1.8 通过 Git 子模块安装（可选）

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

2. 在 Agent 中使用

2.1 Claude Code

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

/loops test-until-green

或用自然语言：

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

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

2.2 Trae

Trae 会自动识别 ~/.trae/skills/loops/ 中的 Skill。在 AI 对话框中输入：

/loops test-until-green

或：

@loops /loops test-until-green

也可以直接用中文：

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

2.3 Cursor

Cursor 会读取 .cursor/rules/loops.mdc 中的 Loops 配置（见 §1.3）。在 Composer 或 Chat 中：

运行 test-until-green 的 Loop 流程，修复当前测试

2.4 Windsurf

Windsurf 读取 .windsurfrules（见 §1.4）。在 Cascade 中：

/loops test-until-green

2.5 Cline

Cline 读取 .clinerules（见 §1.5）。在 Chat 中：

/loops test-until-green

2.6 Codex

Codex 没有斜杠命令，全部用自然语言调用。配置好 ~/.codex/AGENTS.md 或项目根的 AGENTS.md 后（见 §1.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 看护场景设计的。

2.7 直接复制提示词去任意 Agent

不想装 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 提示词全文）

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

2.8 通用调用格式

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

示例：
/loops test-until-green
/loops fix-ci-until-green
/loops pr-self-review
/loops data-cleaning-loop
/loops blog-post-until-publish

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

3. 快速开始

3.1 一分钟上手

1. 将本 Skill 安装到你的项目（见安装 Skill）
2. 打开你的 AI 编程助手
3. 输入任意 Loop 命令，例如：

/loops test-until-green

4. AI 会自动：
   • 运行检查命令
   • 找到失败或不足
   • 修复最小根因
   • 重新运行检查
   • 重复直到目标达成

3.2 推荐入门 Loop

4. Loop 使用语法

4.1 基本语法

/loops <loop-slug>

4.2 带上下文参数

某些 Loop 支持上下文参数（Agent 会自动识别）：

/loops flaky-test-triage --suite=auth.test.ts
/loops coverage-until-threshold --threshold=85
/loops npm-audit-fix-loop --level=high
/loops generate-unit-tests --file=utils.ts
/loops blog-post-until-publish --file=draft.md

具体参数由 Agent 根据 Loop 描述自动推断，你也可以在提示词中明确指定。

4.3 组合使用

Loop 可以串联使用：

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

5. 完整 Loop 目录

分类总览

测试 (Testing)

CI/CD

代码质量 (Code Quality)

API/规范

依赖管理

安全 (Security)

开发流程 (Development Process)

文档 (Documentation)

性能 (Performance)

无障碍 (Accessibility)

Pull Request

部署 (Deployment)

维护 (Maintenance)

Git钩子

代码生成与重构 (Code Generation)

数据库与数据 (Database)

前端与UI (Frontend)

后端与API开发 (Backend)

数据科学与分析 (Data Science)

内容创作与写作 (Content Creation)

产品与设计 (Product & Design)

运营与市场 (Operations & Marketing)

学习与知识管理 (Learning & Knowledge)

效率与生产力 (Productivity)

系统与 DevOps (System & DevOps)

安全与合规 (Security & Compliance)

6. 场景速查表

软件开发

数据与AI

内容创作

产品与运营

学习与效率

系统与安全

7. 最佳实践

7.1 使用 Loop 前的准备

1. 确保仓库干净：运行 Loop 前最好提交当前工作，避免意外覆盖
2. 检查环境依赖：确保检查命令所需的工具已安装
3. 设置合理的最大迭代次数：避免无限循环
4. 备份重要数据：内容创作、数据处理类 Loop 建议先备份原文件

7.2 Loop 执行原则

• 最小 diff 原则：每次只修复最小根因
• 不要跳过检查：每次修改后必须运行检查命令
• 保留证据：重要的 Loop 运行结果建议截图或保存日志
• 人工兜底：达到最大迭代次数仍未成功时，需要人工介入

7.3 安全建议

• 在运行 npm-audit-fix-loop、dependency-upgrade-one-by-one 等 Loop 前，先备份 package-lock.json
• fix-ci-until-green、ship-pr-until-green 等会修改远程仓库的 Loop，请在确定后再使用
• 涉及生产部署的 Loop（如 deploy-verification-loop）请在监控下运行
• 涉及密钥扫描、权限审查的 Loop 需审计后再执行
• 内容创作类 Loop 可能生成大量内容，建议先在小范围测试

7.4 与 Git 工作流结合

# 1. 创建新分支
git checkout -b feature/new-stuff

# 2. 让AI用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

8. 故障排除

8.1 Agent 不识别 Loop 命令

现象：输入 /loops test-until-green 后 Agent 没有按 Loop 执行。

解决：

1. Claude Code：确认 ~/.claude/skills/loops/SKILL.md 存在（官方自动发现）；或在对话中粘贴 SKILL.md 内容；或用 claude --append-system-prompt "$(cat ~/.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. 都不行时，用 §2.7 直接复制提示词 把 Loop 文件全文粘进对话框。

8.2 检查命令不存在

现象：Loop 运行时报 command not found。

解决：

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

8.3 Loop 陷入无限循环

现象：同一个错误反复出现，无法修复。

解决：

1. 检查是否达到最大迭代次数限制
2. 查看 reflexion-debug-loop 的失败记录
3. 人工介入，可能是需要重构或更深层次的问题

8.4 网络问题（中国区）

现象：npm audit、gh、Docker pull 等命令连接超时。

解决：见中国区用户须知。

9. 创建自己的 Loop

9.1 Loop 文件模板

复制 prompts/zh/test-until-green.md 并修改：

---
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

### 9.2 创建 Loop 的原则

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

### 9.3 贡献 Loop

如果你想贡献新的 Loop：

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

---

## 10. 中国区用户须知

### 10.1 网络加速

由于部分工具链依赖 GitHub / npm / Docker 官方源，建议配置镜像：

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

# 或使用 nvm 时
npm config set registry https://registry.npmmirror.com --global

# pip 使用清华镜像
pip config set global.index-url https://pypi.tuna.tsinghua.edu.cn/simple

# Docker 使用阿里云镜像（需配置 daemon.json）

10.2 常用命令替换

10.3 安装 Skill 的中国区方式

# 如果 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

10.4 获取帮助

• 中文文档：README.md
• 英文文档：README_EN.md
• 官方 Loops 站点：https://loops.elorm.xyz/loops
• SkillHub：https://www.skillhub.club/
• SkillsMP：https://skillsmp.com/

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