Menu
AI驱动的自动化循环集合。覆盖软件开发、数据科学、内容创作、产品运营、学习管理等领域。当用户需要自动化工作流、修复问题、生成内容、分析数据或执行质量检查时使用。
Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.
Based on SOC occupation classification
| name | loops |
| description | AI驱动的自动化循环集合。覆盖软件开发、数据科学、内容创作、产品运营、学习管理等领域。当用户需要自动化工作流、修复问题、生成内容、分析数据或执行质量检查时使用。 |
| version | 2.0.0 |
| author | Loops Community |
| license | MIT |
| tags | ["automation","testing","ci","quality","workflow","ai-agents","data-science","content-creation","productivity"] |
| supported_agents | ["Claude Code","Codex","Cursor","Trae","Windsurf","Cline"] |
Loops 是一种用于 AI 编程助手（如 Claude Code、Cursor、Trae、Windsurf、Cline）的自动化工作流指令集。它通过"执行→检查→修复→重复"的闭环模式，让 AI 能够自主完成各类任务，直到达到预设目标。
本 Skill 提供 100 个经过验证的 AI 自动化循环，覆盖软件开发、测试、CI/CD、代码质量、数据科学、内容创作、产品运营、学习管理、系统运维、安全合规等场景。
默认推荐全局安装。先把 Loops 装到全局位置，这样所有项目都能调用；只有需要项目隔离时，才按项目安装。
全局安装路径建议：
~/.claude/skills/loops（Claude Code）、~/.trae/skills/loops（Trae）、~/.codex/AGENTS.md（Codex）、~/.loops（通用，配合软链接）。⚠️ 命名冲突提示：Claude Code 自带一个内置
/loopskill。本仓库统一用/loops <name>（复数）调用，避免误触发内置的那个。详见 §2.1。
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：--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/。
# 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 的支持取决于版本。如果全局不生效，请改用下面的项目级安装。
.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/路径不存在。
.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
.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 面板用 + 按钮新建规则，效果相同。
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标签）。
如果你希望某个项目使用独立的 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中忽略。
cd your-project
git submodule add https://github.com/jwangkun/loops.git .loops
# 然后按你用的 Agent 把 .loops/SKILL.md 链接到对应规则位置
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 直接复制提示词。
Trae 会自动识别 ~/.trae/skills/loops/ 中的 Skill。在 AI 对话框中输入：
/loops test-until-green
或：
@loops /loops test-until-green
也可以直接用中文：
帮我运行 test-until-green，修复所有失败的测试
Cursor 会读取 .cursor/rules/loops.mdc 中的 Loops 配置（见 §1.3）。在 Composer 或 Chat 中：
运行 test-until-green 的 Loop 流程，修复当前测试
Windsurf 读取 .windsurfrules（见 §1.4）。在 Cascade 中：
/loops test-until-green
Cline 读取 .clinerules（见 §1.5）。在 Chat 中：
/loops test-until-green
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 看护场景设计的。
不想装 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）。
/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 内置的/loopskill 冲突。其它 Agent（Trae/Cursor/Windsurf/Cline）同样使用/loops。
/loops test-until-green
| 你是新手？ | 先试试这个 |
|---|---|
| 想确保测试通过 | test-until-green |
| 想清理代码 | lint-typecheck-fix |
| 想格式化代码 | format-until-clean |
| 想检查PR质量 | pr-self-review |
| 想自动修CI | fix-ci-until-green |
| 想清洗数据 | data-cleaning-loop |
| 想优化博客 | blog-post-until-publish |
| 想整理会议纪要 | meeting-notes-cleaner |
/loops <loop-slug>
某些 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 描述自动推断，你也可以在提示词中明确指定。
Loop 可以串联使用：
先运行 /loops lint-typecheck-fix，然后运行 /loops test-until-green
| 分类 | 数量 | 分类 | 数量 |
|---|---|---|---|
| 测试 | 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 |
| Loop | 目标 | 检查命令 | 提示词 |
|---|---|---|---|
test-until-green | 所有测试通过 | npm test | zh · en |
e2e-until-green | E2E测试套件通过 | npm run test:e2e | zh · en |
flaky-test-triage | 将失败测试分类为flaky或real | npm test -- --testPathPattern=<failing-suite> | zh · en |
visual-regression-until-match | 视觉回归测试通过 | npx playwright test --grep @visual | zh · en |
coverage-until-threshold | 覆盖率达标 | npm test -- --coverage | zh · en |
staging-smoke-test | 预发布环境冒烟测试通过 | npm run smoke:staging | zh · en |
post-edit-test-guard | 编辑后相关测试必须通过 | npm test -- --findRelatedTests <files> | zh · en |
| Loop | 目标 | 检查命令 | 提示词 |
|---|---|---|---|
ship-pr-until-green | PR已打开且所有CI检查通过 | gh pr checks | zh · en |
fix-ci-until-green | 当前分支的最新CI运行通过 | gh run list ... | zh · en |
ci-failure-watcher | 当前分支的最新CI运行是绿色的 | gh run list ... | zh · en |
build-until-green | 生产构建成功 | npm run build | zh · en |
pre-commit-guard | 测试失败时阻止git提交 | npm test | zh · en |
pr-self-review | 当前diff上完成三轮干净的自我审查 | git diff main...HEAD | zh · en |
pr-babysitter | 标记为codex-watch的PR保持健康 | gh pr list --label "codex-watch" | zh · en |
pr-watch-loop | codex-watch PR保持健康且无阻碍 | gh pr list --label codex-watch ... | zh · en |
spec-first-ship | spec.md中的每个需求都已实现并打勾 | npm test | zh · en |
| Loop | 目标 | 检查命令 | 提示词 |
|---|---|---|---|
lint-typecheck-fix | lint和typecheck干净 | npm run lint && npx tsc --noEmit | zh · en |
format-until-clean | 格式化工具运行干净 | npm run format | zh · en |
de-sloppify-pass | 最近的变更干净、最小化 | npm run lint && npm test | zh · en |
knip-until-clean | knip报告没有未使用代码或依赖 | npx knip | zh · en |
| Loop | 目标 | 检查命令 | 提示词 |
|---|---|---|---|
api-contract-until-match | API实现与发布的契约匹配 | npm run test:contract | zh · en |
openapi-sync-until-valid | openapi.yaml lint干净且与实现的路由匹配 | npx @redocly/cli lint openapi.yaml | zh · en |
| Loop | 目标 | 检查命令 | 提示词 |
|---|---|---|---|
dependency-upgrade-one-by-one | 关键过时依赖升级且测试绿色 | npm outdated && npm test && npm run build | zh · en |
migration-until-applied | 所有数据库迁移应用干净 | npx prisma migrate status | zh · en |
dependency-audit-weekly | 交付每周依赖审计摘要 | `npm outdated | |
npm-audit-fix-loop | 没有高危或严重npm审计漏洞 | npm audit --audit-level=high && npm test | zh · en |
| Loop | 目标 | 检查命令 | 提示词 |
|---|---|---|---|
security-audit-weekly | 交付每周npm审计摘要和修复计划 | npm audit --json | zh · en |
| Loop | 目标 | 检查命令 | 提示词 |
|---|---|---|---|
autoloop-tdd | 测试优先地实现目标行为 | npm test | zh · en |
changelog-sync-after-ship | CHANGELOG.md有准确的[Unreleased]条目 | git log -5 --oneline | zh · en |
investigation-script-loop | 用最小复现脚本证明根因 | node scripts/investigate.mjs | zh · en |
ralph-story-executor | 每个story都有passes: true | npm test && npm run lint && npm run build | zh · en |
reflexion-debug-loop | 失败的测试或复现通过 | npm test -- --testNamePattern=<test> | zh · en |
| Loop | 目标 | 检查命令 | 提示词 |
|---|---|---|---|
docs-sync-after-edits | 文档与当前代码变更匹配 | git diff main...HEAD --name-only | zh · en |
| Loop | 目标 | 检查命令 | 提示词 |
|---|---|---|---|
bundle-size-budget | 客户端bundle保持在预算内 | npm run build && npm run size-limit | zh · en |
| Loop | 目标 | 检查命令 | 提示词 |
|---|---|---|---|
a11y-audit-until-clean | 变更的UI上没有严重的无障碍访问违规 | npm run test:a11y | zh · en |
| Loop | 目标 | 检查命令 | 提示词 |
|---|---|---|---|
merge-conflict-resolver | 分支在main上rebase成功且测试通过 | npm test | zh · en |
post-merge-regression-guard | 每次合并或rebase后冒烟测试立即通过 | npm run test:smoke | zh · en |
| Loop | 目标 | 检查命令 | 提示词 |
|---|---|---|---|
deploy-verification-loop | 所有部署后健康和冒烟端点返回成功 | curl -fsS <your-health-url> | zh · en |
| Loop | 目标 | 检查命令 | 提示词 |
|---|---|---|---|
independent-verifier-pass | 构建、lint和测试在独立验证下通过 | npm run build && npm run lint && npm test | zh · en |
| Loop | 目标 | 检查命令 | 提示词 |
|---|---|---|---|
guardrails-learning-loop | 测试和lint通过且不重复之前的失败模式 | npm test && npm run lint | zh · en |
| Loop | 目标 | 检查命令 | 提示词 |
|---|---|---|---|
code-review-until-clean | 代码通过结构化审查清单 | python scripts/review_checklist.py | zh · en |
refactor-until-clean | 目标模块达到整洁代码标准 | npm run lint && npm test | zh · en |
generate-unit-tests | 目标函数对边界条件有通过的单元测试 | npm test -- <target-file> | zh · en |
component-scaffold-loop | 新UI组件已生成测试和stories | npm test -- <component-name> | zh · en |
api-endpoint-generator | 新API端点已实现handler、路由和测试 | npm run test:api | zh · en |
error-handling-audit | 所有公共函数有一致的错误处理 | npm run lint && npm test | zh · en |
type-definition-sync | TypeScript类型与运行时API和数据库schema匹配 | npx tsc --noEmit | zh · en |
dead-code-removal | 无未使用的导出、变量或函数残留 | npx knip --no-exit-code && npm test | zh · en |
| Loop | 目标 | 检查命令 | 提示词 |
|---|---|---|---|
schema-migration-loop | 数据库schema变更已迁移且测试通过 | npx prisma migrate dev && npm test | zh · en |
query-performance-loop | 慢查询优化到阈值以下 | npm run benchmark:queries | zh · en |
seed-data-validator | 种子数据干净加载且引用有效 | npm run db:seed && npm run test:seed | zh · en |
backup-verify-loop | 最新数据库备份成功恢复 | npm run db:backup:verify | zh · en |
data-consistency-check | 无孤立记录或约束违规 | npm run db:consistency | zh · en |
| Loop | 目标 | 检查命令 | 提示词 |
|---|---|---|---|
responsive-until-match | UI在所有目标断点正确渲染 | npx playwright test --grep @responsive | zh · en |
design-token-sync | 所有UI使用批准的设计token | npm run lint:design-tokens | zh · en |
component-library-update | 组件库已更新新变体和文档 | npm run storybook:build | zh · en |
frontend-error-boundary-check | 所有路由都有错误边界和fallback UI | npm run lint:error-boundaries | zh · en |
| Loop | 目标 | 检查命令 | 提示词 |
|---|---|---|---|
rate-limit-enforcer | 所有公共端点都实施限流 | npm run test:rate-limit | zh · en |
authz-policy-loop | 所有敏感端点都实施授权 | npm run test:authz | zh · en |
api-validation-loop | 所有API输入已验证和清理 | npm run test:api-validation | zh · en |
logging-audit-loop | 所有关键路径产生结构化日志 | npm run lint:logging | zh · en |
| Loop | 目标 | 检查命令 | 提示词 |
|---|---|---|---|
data-cleaning-loop | 数据集通过质量检查 | python scripts/data_quality.py | zh · en |
model-training-loop | 模型在验证集上达到目标准确率 | python scripts/train.py --validate | zh · en |
feature-engineering-loop | 特征集提升模型性能 | python scripts/evaluate_features.py | zh · en |
data-pipeline-until-green | 数据管道端到端无错误运行 | python scripts/run_pipeline.py | zh · en |
experiment-tracker | 实验结果已记录且可复现 | python scripts/check_experiments.py | zh · en |
dashboard-sync-loop | 仪表盘反映最新数据和指标 | python scripts/refresh_dashboard.py | zh · en |
| Loop | 目标 | 检查命令 | 提示词 |
|---|---|---|---|
blog-post-until-publish | 博客文章已润色并准备发布 | python scripts/blog_quality.py draft.md | zh · en |
readme-improvement-loop | README清晰、完整并遵循最佳实践 | python scripts/readme_lint.py | zh · en |
social-post-generator | 为每个平台生成社交媒体帖子 | python scripts/check_posts.py | zh · en |
newsletter-until-send | Newsletter通过审查且链接有效 | python scripts/newsletter_check.py | zh · en |
video-script-loop | 视频脚本达到目标时长和清晰度 | python scripts/script_review.py | zh · en |
translation-review-loop | 翻译准确自然 | python scripts/translation_check.py | zh · en |
ad-copy-optimizer | 广告文案变体通过转化检查清单 | python scripts/ad_copy_check.py | zh · en |
| Loop | 目标 | 检查命令 | 提示词 |
|---|---|---|---|
prd-review-loop | PRD完整、清晰并准备开发 | python scripts/prd_check.py | zh · en |
user-story-generator | 为每个功能生成用户故事 | python scripts/story_check.py | zh · en |
design-review-loop | 设计遵循系统规范和无障碍规则 | python scripts/design_check.py | zh · en |
competitive-analysis-loop | 竞品分析报告完整且有来源 | python scripts/competitor_check.py | zh · en |
| Loop | 目标 | 检查命令 | 提示词 |
|---|---|---|---|
seo-audit-loop | 页面通过SEO检查清单 | python scripts/seo_check.py | zh · en |
email-campaign-loop | 邮件营销活动已审查且链接有效 | python scripts/email_check.py | zh · en |
analytics-health-check | 所有关键事件正确追踪 | python scripts/analytics_check.py | zh · en |
release-notes-generator | 发布说明已生成并审查 | python scripts/release_notes_check.py | zh · en |
| Loop | 目标 | 检查命令 | 提示词 |
|---|---|---|---|
flashcard-generator | 为关键概念生成闪卡 | python scripts/flashcard_check.py | zh · en |
study-plan-optimizer | 学习计划现实并覆盖所有主题 | python scripts/study_plan_check.py | zh · en |
note-organizer | 笔记已打标签、链接并结构良好 | python scripts/note_check.py | zh · en |
research-synthesis-loop | 研究已总结来源和关键洞察 | python scripts/research_check.py | zh · en |
quiz-validator | 测验问题准确且有正确答案 | python scripts/quiz_check.py | zh · en |
| Loop | 目标 | 检查命令 | 提示词 |
|---|---|---|---|
meeting-notes-cleaner | 会议纪要结构化并含行动项 | python scripts/meeting_check.py | zh · en |
inbox-zero-loop | 收件箱无未读可执行邮件 | python scripts/inbox_check.py | zh · en |
task-prioritizer | 任务按影响力和工作量排序 | python scripts/task_check.py | zh · en |
weekly-review-loop | 每周回顾报告完成 | python scripts/weekly_review_check.py | zh · en |
| Loop | 目标 | 检查命令 | 提示词 |
|---|---|---|---|
docker-build-until-green | Docker镜像构建并通过健康检查 | docker build -t app . && docker run --rm app healthcheck | zh · en |
terraform-plan-until-clean | terraform plan无意外变更 | terraform plan -detailed-exitcode | zh · en |
log-anomaly-detector | 近期日志无严重异常 | python scripts/log_anomaly.py | zh · en |
ssl-certificate-monitor | 所有域名都有有效SSL证书 | python scripts/ssl_check.py | zh · en |
backup-routine-loop | 所有关键数据已备份并验证 | python scripts/backup_check.py | zh · en |
| Loop | 目标 | 检查命令 | 提示词 |
|---|---|---|---|
secret-scan-loop | 仓库中无密钥或凭证 | npx secretlint --maskSecrets "**/*" | zh · en |
compliance-checklist-loop | 所有合规检查项已满足 | python scripts/compliance_check.py | zh · en |
privacy-policy-audit | 隐私政策与当前数据实践匹配 | python scripts/privacy_check.py | zh · en |
access-review-loop | 所有用户访问权限都有正当理由 | python scripts/access_review.py | zh · en |
| 你想做什么 | 使用的 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 |
| 你想做什么 | 使用的 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 |
npm-audit-fix-loop、dependency-upgrade-one-by-one 等 Loop 前，先备份 package-lock.jsonfix-ci-until-green、ship-pr-until-green 等会修改远程仓库的 Loop，请在确定后再使用deploy-verification-loop）请在监控下运行# 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
现象：输入 /loops test-until-green 后 Agent 没有按 Loop 执行。
解决：
~/.claude/skills/loops/SKILL.md 存在（官方自动发现）；或在对话中粘贴 SKILL.md 内容；或用 claude --system-prompt ~/.loops/SKILL.md 启动。/loops xxx 触发的是 Claude Code 内置的 /loop 而非本仓库，确认 skill 目录命名是 loops（不是 loop），或直接用自然语言描述需求。~/.trae/skills/loops/ 是否存在 SKILL.md 和 prompts/。.cursor/rules/loops.mdc 是否存在（旧版 .cursorrules 已废弃）。.windsurfrules 是否存在。.clinerules 是否存在。~/.codex/AGENTS.md 或项目根的 AGENTS.md 是否配置了 Loops（Codex 用自然语言调用，无斜杠命令）。现象：Loop 运行时报 command not found。
解决：
package.json 中是否有对应的 scripts现象：同一个错误反复出现，无法修复。
解决：
reflexion-debug-loop 的失败记录现象：npm audit、gh、Docker pull 等命令连接超时。
解决：见中国区用户须知。
复制 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）
| 原命令 | 中国区替代 |
|---|---|
npm install | npm install --registry=https://registry.npmmirror.com |
npx playwright install | 手动下载或使用镜像 |
gh | 可替换为 hub 或直接访问 GitHub Web |
pip install | pip install -i https://pypi.tuna.tsinghua.edu.cn/simple |
docker pull | 配置阿里云/网易云镜像加速 |
# 如果 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
许可证: MIT
版本: 2.0.0
维护: Loops Community