Loops 提供 100 个精心策划的 AI 驱动自动化循环模板，覆盖软件开发、数据科学、内容创作、产品运营、学习管理等领域。 https://github.com/jwangkun/loops 让 AI 助手自己反复“干→查→修→再干“，直到把活干完，不用你一步步盯着。

---

jwangkun/loops

Source: https://github.com/jwangkun/loops

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

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

English README

---

目录

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

---

1. 什么是 Loop？

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

Loop 的核心概念

概念	说明
目标 (Goal)	Loop 要达成的最终状态
检查命令 (Check)	验证目标是否达成的命令
最大迭代次数	Loop 最多执行多少轮
退出条件	何时停止（通常指检查命令返回成功）
执行步骤	每一轮的具体操作

Loop vs 传统指令

传统指令	Loop
“修复所有 lint 错误”	执行 lint → 修复最小 diff → 再次执行 → 直到 lint 干净
“修复 CI”	检查 CI 状态 → 读取日志 → 本地复现 → 修复 → 推送 → 验证
“优化一篇博客”	检查质量 → 修改一个问题 → 再次检查 → 直到达标
一次性任务	闭环自动化

Loop 的运作流程

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

---

2. 什么时候用 Loop？

当你需要：

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

适合使用 Loop 的场景

场景	示例 Loop
刚写完代码，想让测试全绿	test-until-green
CI 红了，不知道怎么修	fix-ci-until-green
提交前想确保质量	pre-commit-guard
要升级依赖	dependency-upgrade-one-by-one
要审查自己的 PR	pr-self-review
文档和代码不同步	docs-sync-after-edits
要优化博客文章	blog-post-until-publish
要清洗数据集	data-cleaning-loop
要训练模型	model-training-loop
要整理会议纪要	meeting-notes-cleaner

---

3. 一分钟快速开始（Claude Code 全局安装）

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

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

第 1 步：全局安装 Loops

# 克隆到 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 软链接

第 2 步：在 Claude Code 中调用

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

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

AI 会自动执行：

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

第 3 步：查看效果

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

---

4. 安装 Skill（默认全局安装）

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

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

4.1 Claude Code（推荐，全局可用）

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>

4.2 Trae IDE（全局 Skill）

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 的支持取决于版本，如果全局不生效，请改用下面的项目级安装。

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

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

4.4 Windsurf（.windsurfrules）

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

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

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

4.7 项目级安装（通用）

如果你希望某个项目使用独立的 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 中忽略。

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

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

---

5. 在各 Agent 中使用

5.1 通用调用格式

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

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

5.2 Claude Code

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 直接复制提示词。

5.3 Trae

@loops /loops test-until-green

或自然语言：

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

5.4 Cursor

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

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

5.5 Codex

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 看护场景设计的。

5.6 自然语言调用

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

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

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

5.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 提示词全文）

示例：在 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）。

5.8 组合使用

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

---

6. Loop 完整目录

分类总览

分类	数量	分类	数量
测试	7	代码生成与重构	8
CI/CD	9	数据库与数据	5
代码质量	4	前端与UI	4
API/规范	2	后端与API开发	4
依赖管理	4	数据科学与分析	6
安全	1	内容创作与写作	7
开发流程	5	产品与设计	4
文档	1	运营与市场	4
性能	1	学习与知识管理	5
无障碍	1	效率与生产力	4
Pull Request	2	系统与DevOps	5
部署	1	安全与合规	4
维护	1
Git钩子	1

测试 (Testing)

Loop	目标	检查命令	中文提示词	英文提示词
test-until-green	所有测试通过	npm test	查看	View
e2e-until-green	E2E 测试套件通过	npm run test:e2e	查看	View
flaky-test-triage	将失败测试分类为 flaky 或 real	npm test -- --testPathPattern=<failing-suite>	查看	View
visual-regression-until-match	视觉回归测试通过	npx playwright test --grep @visual	查看	View
coverage-until-threshold	覆盖率达标（默认80%）	npm test -- --coverage	查看	View
staging-smoke-test	预发布环境冒烟测试通过	npm run smoke:staging	查看	View
post-edit-test-guard	编辑后相关测试必须通过	npm test -- --findRelatedTests <files>	查看	View

CI/CD

Loop	目标	检查命令	中文提示词	英文提示词
ship-pr-until-green	PR 已打开且所有 CI 检查通过	gh pr checks	查看	View
fix-ci-until-green	当前分支的最新 CI 运行通过	gh run list ...	查看	View
ci-failure-watcher	当前分支的最新 CI 运行是绿色的	gh run list ...	查看	View
build-until-green	生产构建成功	npm run build	查看	View
pre-commit-guard	测试失败时阻止 git 提交	npm test	查看	View
pr-self-review	当前 diff 上完成三轮干净的自我审查	git diff main...HEAD	查看	View
pr-babysitter	标记为 codex-watch 的 PR 保持健康	gh pr list --label "codex-watch"	查看	View
pr-watch-loop	codex-watch PR 保持健康且无阻碍	gh pr list --label codex-watch ...	查看	View
spec-first-ship	spec.md 中的每个需求都已实现并打勾	npm test	查看	View

代码质量 (Code Quality)

Loop	目标	检查命令	中文提示词	英文提示词
lint-typecheck-fix	lint 和 typecheck 干净	npm run lint && npx tsc --noEmit	查看	View
format-until-clean	格式化工具运行干净	npm run format	查看	View
de-sloppify-pass	最近的变更干净、最小化	npm run lint && npm test	查看	View
knip-until-clean	knip 报告没有未使用代码或依赖	npx knip	查看	View

API/规范

Loop	目标	检查命令	中文提示词	英文提示词
api-contract-until-match	API 实现与发布的契约匹配	npm run test:contract	查看	View
openapi-sync-until-valid	openapi.yaml lint 干净且与实现的路由匹配	npx @redocly/cli lint openapi.yaml	查看	View

依赖管理

Loop	目标	检查命令	中文提示词	英文提示词
dependency-upgrade-one-by-one	关键过时依赖升级且测试绿色	npm outdated && npm test && npm run build	查看	View
migration-until-applied	所有数据库迁移应用干净	npx prisma migrate status	查看	View
dependency-audit-weekly	交付每周依赖审计摘要	`npm outdated		true`
npm-audit-fix-loop	没有高危或严重 npm 审计漏洞	npm audit --audit-level=high && npm test	查看	View

安全 (Security)

Loop	目标	检查命令	中文提示词	英文提示词
security-audit-weekly	交付每周 npm 审计摘要和修复计划	npm audit --json	查看	View

开发流程 (Development Process)

Loop	目标	检查命令	中文提示词	英文提示词
autoloop-tdd	测试优先地实现目标行为	npm test	查看	View
changelog-sync-after-ship	CHANGELOG.md 有准确的 [Unreleased] 条目	git log -5 --oneline	查看	View
investigation-script-loop	用最小复现脚本证明根因	node scripts/investigate.mjs	查看	View
ralph-story-executor	每个 story 都有 passes: true	npm test && npm run lint && npm run build	查看	View
reflexion-debug-loop	失败的测试或复现通过	npm test -- --testNamePattern=<test>	查看	View

文档 (Documentation)

Loop	目标	检查命令	中文提示词	英文提示词
docs-sync-after-edits	文档与当前代码变更匹配	git diff main...HEAD --name-only	查看	View

性能 (Performance)

Loop	目标	检查命令	中文提示词	英文提示词
bundle-size-budget	客户端 bundle 保持在预算内	npm run build && npm run size-limit	查看	View

无障碍 (Accessibility)

Loop	目标	检查命令	中文提示词	英文提示词
a11y-audit-until-clean	变更的 UI 上没有严重的无障碍访问违规	npm run test:a11y	查看	View

Pull Request

Loop	目标	检查命令	中文提示词	英文提示词
merge-conflict-resolver	分支在 main 上 rebase 成功且测试通过	npm test	查看	View
post-merge-regression-guard	每次合并或 rebase 后冒烟测试立即通过	npm run test:smoke	查看	View

部署 (Deployment)

Loop	目标	检查命令	中文提示词	英文提示词
deploy-verification-loop	所有部署后健康和冒烟端点返回成功	curl -fsS <your-health-url>	查看	View

维护 (Maintenance)

Loop	目标	检查命令	中文提示词	英文提示词
independent-verifier-pass	构建、lint 和测试在独立验证下通过	npm run build && npm run lint && npm test	查看	View

Git 钩子

Loop	目标	检查命令	中文提示词	英文提示词
guardrails-learning-loop	测试和 lint 通过且不重复之前的失败模式	npm test && npm run lint	查看	View

代码生成与重构 (Code Generation)

Loop	目标	检查命令	中文提示词	英文提示词
code-review-until-clean	代码通过结构化审查清单	python scripts/review_checklist.py	查看	View
refactor-until-clean	目标模块达到整洁代码标准	npm run lint && npm test	查看	View
generate-unit-tests	目标函数对边界条件有通过的单元测试	npm test -- <target-file>	查看	View
component-scaffold-loop	新 UI 组件已生成测试和 stories	npm test -- <component-name>	查看	View
api-endpoint-generator	新 API 端点已实现 handler、路由和测试	npm run test:api	查看	View
error-handling-audit	所有公共函数有一致的错误处理	npm run lint && npm test	查看	View
type-definition-sync	TypeScript 类型与运行时 API 和数据库 schema 匹配	npx tsc --noEmit	查看	View
dead-code-removal	无未使用的导出、变量或函数残留	npx knip --no-exit-code && npm test	查看	View

数据库与数据 (Database)

Loop	目标	检查命令	中文提示词	英文提示词
schema-migration-loop	数据库 schema 变更已迁移且测试通过	npx prisma migrate dev && npm test	查看	View
query-performance-loop	慢查询优化到阈值以下	npm run benchmark:queries	查看	View
seed-data-validator	种子数据干净加载且引用有效	npm run db:seed && npm run test:seed	查看	View
backup-verify-loop	最新数据库备份成功恢复	npm run db:backup:verify	查看	View
data-consistency-check	无孤立记录或约束违规	npm run db:consistency	查看	View

前端与 UI (Frontend)

Loop	目标	检查命令	中文提示词	英文提示词
responsive-until-match	UI 在所有目标断点正确渲染	npx playwright test --grep @responsive	查看	View
design-token-sync	所有 UI 使用批准的设计 token	npm run lint:design-tokens	查看	View
component-library-update	组件库已更新新变体和文档	npm run storybook:build	查看	View
frontend-error-boundary-check	所有路由都有错误边界和 fallback UI	npm run lint:error-boundaries	查看	View

后端与 API 开发 (Backend)

Loop	目标	检查命令	中文提示词	英文提示词
rate-limit-enforcer	所有公共端点都实施限流	npm run test:rate-limit	查看	View
authz-policy-loop	所有敏感端点都实施授权	npm run test:authz	查看	View
api-validation-loop	所有 API 输入已验证和清理	npm run test:api-validation	查看	View
logging-audit-loop	所有关键路径产生结构化日志	npm run lint:logging	查看	View

数据科学与分析 (Data Science)

Loop	目标	检查命令	中文提示词	英文提示词
data-cleaning-loop	数据集通过质量检查	python scripts/data_quality.py	查看	View
model-training-loop	模型在验证集上达到目标准确率	python scripts/train.py --validate	查看	View
feature-engineering-loop	特征集提升模型性能	python scripts/evaluate_features.py	查看	View
data-pipeline-until-green	数据管道端到端无错误运行	python scripts/run_pipeline.py	查看	View
experiment-tracker	实验结果已记录且可复现	python scripts/check_experiments.py	查看	View
dashboard-sync-loop	仪表盘反映最新数据和指标	python scripts/refresh_dashboard.py	查看	View

内容创作与写作 (Content Creation)

Loop	目标	检查命令	中文提示词	英文提示词
blog-post-until-publish	博客文章已润色并准备发布	python scripts/blog_quality.py draft.md	查看	View
readme-improvement-loop	README 清晰、完整并遵循最佳实践	python scripts/readme_lint.py	查看	View
social-post-generator	为每个平台生成社交媒体帖子	python scripts/check_posts.py	查看	View
newsletter-until-send	Newsletter 通过审查且链接有效	python scripts/newsletter_check.py	查看	View
video-script-loop	视频脚本达到目标时长和清晰度	python scripts/script_review.py	查看	View
translation-review-loop	翻译准确自然	python scripts/translation_check.py	查看	View
ad-copy-optimizer	广告文案变体通过转化检查清单	python scripts/ad_copy_check.py	查看	View

产品与设计 (Product & Design)

Loop	目标	检查命令	中文提示词	英文提示词
prd-review-loop	PRD 完整、清晰并准备开发	python scripts/prd_check.py	查看	View
user-story-generator	为每个功能生成用户故事	python scripts/story_check.py	查看	View
design-review-loop	设计遵循系统规范和无障碍规则	python scripts/design_check.py	查看	View
competitive-analysis-loop	竞品分析报告完整且有来源	python scripts/competitor_check.py	查看	View

运营与市场 (Operations & Marketing)

Loop	目标	检查命令	中文提示词	英文提示词
seo-audit-loop	页面通过 SEO 检查清单	python scripts/seo_check.py	查看	View
email-campaign-loop	邮件营销活动已审查且链接有效	python scripts/email_check.py	查看	View
analytics-health-check	所有关键事件正确追踪	python scripts/analytics_check.py	查看	View
release-notes-generator	发布说明已生成并审查	python scripts/release_notes_check.py	查看	View

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

Loop	目标	检查命令	中文提示词	英文提示词
flashcard-generator	为关键概念生成闪卡	python scripts/flashcard_check.py	查看	View
study-plan-optimizer	学习计划现实并覆盖所有主题	python scripts/study_plan_check.py	查看	View
note-organizer	笔记已打标签、链接并结构良好	python scripts/note_check.py	查看	View
research-synthesis-loop	研究已总结来源和关键洞察	python scripts/research_check.py	查看	View
quiz-validator	测验问题准确且有正确答案	python scripts/quiz_check.py	查看	View

效率与生产力 (Productivity)

Loop	目标	检查命令	中文提示词	英文提示词
meeting-notes-cleaner	会议纪要结构化并含行动项	python scripts/meeting_check.py	查看	View
inbox-zero-loop	收件箱无未读可执行邮件	python scripts/inbox_check.py	查看	View
task-prioritizer	任务按影响力和工作量排序	python scripts/task_check.py	查看	View
weekly-review-loop	每周回顾报告完成	python scripts/weekly_review_check.py	查看	View

系统与 DevOps (System & DevOps)

Loop	目标	检查命令	中文提示词	英文提示词
docker-build-until-green	Docker 镜像构建并通过健康检查	docker build -t app . && docker run --rm app healthcheck	查看	View
terraform-plan-until-clean	terraform plan 无意外变更	terraform plan -detailed-exitcode	查看	View
log-anomaly-detector	近期日志无严重异常	python scripts/log_anomaly.py	查看	View
ssl-certificate-monitor	所有域名都有有效 SSL 证书	python scripts/ssl_check.py	查看	View
backup-routine-loop	所有关键数据已备份并验证	python scripts/backup_check.py	查看	View

安全与合规 (Security & Compliance)

Loop	目标	检查命令	中文提示词	英文提示词
secret-scan-loop	仓库中无密钥或凭证	npx secretlint --maskSecrets "**/*"	查看	View
compliance-checklist-loop	所有合规检查项已满足	python scripts/compliance_check.py	查看	View
privacy-policy-audit	隐私政策与当前数据实践匹配	python scripts/privacy_check.py	查看	View
access-review-loop	所有用户访问权限都有正当理由	python scripts/access_review.py	查看	View

---

7. 场景速查表

软件开发

你想做什么	使用的 Loop	示例
让测试全绿	test-until-green	/loops test-until-green
修 CI 失败	fix-ci-until-green	/loops fix-ci-until-green
自动 lint 修复	lint-typecheck-fix	/loops lint-typecheck-fix
自动格式化	format-until-clean	/loops format-until-clean
审查自己的 PR	pr-self-review	/loops pr-self-review
升级依赖	dependency-upgrade-one-by-one	/loops dependency-upgrade-one-by-one
修安全漏洞	npm-audit-fix-loop	/loops npm-audit-fix-loop
TDD 开发	autoloop-tdd	/loops autoloop-tdd
更新文档	docs-sync-after-edits	/loops docs-sync-after-edits
合并冲突	merge-conflict-resolver	/loops merge-conflict-resolver
部署验证	deploy-verification-loop	/loops deploy-verification-loop
优化性能	bundle-size-budget	/loops bundle-size-budget
代码重构	refactor-until-clean	/loops refactor-until-clean
生成单元测试	generate-unit-tests	/loops generate-unit-tests
错误处理审计	error-handling-audit	/loops error-handling-audit

数据与AI

你想做什么	使用的 Loop	示例
清洗数据集	data-cleaning-loop	/loops data-cleaning-loop
训练模型	model-training-loop	/loops model-training-loop
特征工程	feature-engineering-loop	/loops feature-engineering-loop
运行数据管道	data-pipeline-until-green	/loops data-pipeline-until-green
追踪实验	experiment-tracker	/loops experiment-tracker
刷新仪表盘	dashboard-sync-loop	/loops dashboard-sync-loop
数据库迁移	schema-migration-loop	/loops schema-migration-loop
优化慢查询	query-performance-loop	/loops query-performance-loop

内容创作

你想做什么	使用的 Loop	示例
优化博客文章	blog-post-until-publish	/loops blog-post-until-publish
改进 README	readme-improvement-loop	/loops readme-improvement-loop
生成社媒帖子	social-post-generator	/loops social-post-generator
准备 Newsletter	newsletter-until-send	/loops newsletter-until-send
优化视频脚本	video-script-loop	/loops video-script-loop
审校翻译	translation-review-loop	/loops translation-review-loop
优化广告文案	ad-copy-optimizer	/loops ad-copy-optimizer

产品与运营

你想做什么	使用的 Loop	示例
审查 PRD	prd-review-loop	/loops prd-review-loop
生成用户故事	user-story-generator	/loops user-story-generator
设计审查	design-review-loop	/loops design-review-loop
竞品分析	competitive-analysis-loop	/loops competitive-analysis-loop
SEO 审计	seo-audit-loop	/loops seo-audit-loop
邮件营销检查	email-campaign-loop	/loops email-campaign-loop
发布说明	release-notes-generator	/loops release-notes-generator

学习与效率

你想做什么	使用的 Loop	示例
生成学习闪卡	flashcard-generator	/loops flashcard-generator
优化学习计划	study-plan-optimizer	/loops study-plan-optimizer
整理笔记	note-organizer	/loops note-organizer
综合研究	research-synthesis-loop	/loops research-synthesis-loop
整理会议纪要	meeting-notes-cleaner	/loops meeting-notes-cleaner
收件箱清零	inbox-zero-loop	/loops inbox-zero-loop
任务优先级	task-prioritizer	/loops task-prioritizer
每周回顾	weekly-review-loop	/loops weekly-review-loop

系统与安全

你想做什么	使用的 Loop	示例
构建 Docker 镜像	docker-build-until-green	/loops docker-build-until-green
检查 Terraform	terraform-plan-until-clean	/loops terraform-plan-until-clean
检测日志异常	log-anomaly-detector	/loops log-anomaly-detector
监控 SSL 证书	ssl-certificate-monitor	/loops ssl-certificate-monitor
扫描密钥泄露	secret-scan-loop	/loops secret-scan-loop
合规检查	compliance-checklist-loop	/loops compliance-checklist-loop
审查访问权限	access-review-loop	/loops access-review-loop

---

8. 创建自己的 Loop

8.1 最简单的方法

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

8.2 Loop 文件模板

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

---

10. 中国区用户指南

10.1 为什么要特别优化？

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

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

10.2 网络加速配置

# 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

10.3 常用工具的中国区替代

原工具/命令	中国区替代
npm install	npm install --registry=https://registry.npmmirror.com
npx playwright install	手动下载或使用国内镜像
gh CLI	可替换为 hub 或直接访问 GitHub Web
GitHub 仓库克隆	使用 Gitee 镜像或代理
Docker Hub	使用阿里云或网易云镜像
Python pip	pip install -i https://pypi.tuna.tsinghua.edu.cn/simple

10.4 安装方式

如果 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.5 推荐的中国区 AI 助手

AI 助手	支持情况	安装方式
Claude Code	完全支持	见第 4 节
Codex	完全支持（AGENTS.md，无斜杠命令）	见第 4 节
Trae	完全支持	见第 4 节
Cursor	完全支持	见第 4 节
Windsurf	支持	见第 4 节
Cline	支持	见第 4 节

---

11. 常见问题

Q1: Agent 不识别 /loops 命令怎么办？

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 文件全文粘进对话框。

Q2: 检查命令不存在怎么办？

A2:

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

Q3: Loop 会修改我的代码或文件吗？

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

Q4: 可以只使用中文提示词吗？

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

Q5: 如何贡献新的 Loop？

A5:

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

Q6: 新增的 60 个 Loop 来自哪里？

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