메뉴
AI驱动的自动化循环集合。覆盖软件开发、数据科学、内容创作、产品运营、学习管理等领域。当用户需要自动化工作流、修复问题、生成内容、分析数据或执行质量检查时使用。
Codex 또는 Claude로 설치 이 Prompt를 복사해 Codex, Claude 또는 다른 어시스턴트에 붙여 넣으면 Skill 페이지를 검토하고 설치를 진행할 수 있습니다.
SOC 직업 분류 기준
| 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