Ralph-Loop 新手入门：简单易懂的最佳实践 + 超实用提示词汇总

Ralph-Loop 新手入门：简单易懂的最佳实践 + 超实用提示词汇总

目标：让第一次用 ralph-loop 的你也能 5 分钟跑起来，不踩坑、不烧 token、结果可预期。

---

一、什么是 Ralph-Loop？（一句话版）

把任务 + 完成条件告诉 AI → AI 自己「写代码 → 自检 → 修 bug → 再测」直到条件满足或达到最大迭代次数，你无需每步回车 。

---

二、必背 3 个参数（照抄即可）

参数	用途	示例
任务描述	让 AI 知道要干啥	"写一个登录接口，测试全过"
--max-iterations	安全阀（必加！）	--max-iterations 15
--completion-promise	停下来的暗号（必加！）	--completion-promise "✅DONE"

暗号必须是 AI 最后一句 原样输出 的字符串，否则循环不会停 。

---

三、万能 4 步模板（直接复制）

# 1️⃣ 进入项目目录
cd my-project

# 2️⃣ 写一个小而明确的任务
/ralph-loop "任务：{{TODO}}
完成标准：
{{可机器验证的条件列表}}
完成后输出：✅DONE" \
--max-iterations 15 \
--completion-promise "✅DONE"

---

四、新手最佳实践 6 条

1. 任务要“小”
   一次只啃一根骨头，如“让登录测试全过”，而不是“做完整个系统”。

2. 完成标准“可机器验证”
   ✅ "npm test 0 exit code"
   ❌ "让它更好看"（主观，AI 无法判断）。

3. 先跑 5 次小循环试水
   觉得 token 能接受再放大 iterations。

4. 用文件记录进度（可选但推荐）
   在提示词里加一句：
   每轮把进度追加到 progress.txt，避免重复工作。

5. Ctrl+C 可随时停，修改后继续，进度不丢 。

6. 暗号别用常见词
   防止 AI 闲聊时误触发，推荐 emoji + 英文，如 ✅DONE、🎉OK、🚀COMPLETE。

---

五、超实用提示词 12 选 1（复制即用）

全部已内置“小任务 + 机器验证 + 暗号”， iterations 设 15~30，按需改。

1️⃣ 测试覆盖率冲到 90%

/ralph-loop "把 src/ 里所有业务代码的测试覆盖率提到 ≥90%
步骤：
- 跑 npm run test:cov
- 为未覆盖行写测试
- 再跑测试，直到通过且覆盖率≥90%
完成后输出：✅DONE" \
--max-iterations 20 \
--completion-promise "✅DONE"

2️⃣ 消灭所有 ESLint 错误

/ralph-loop "修复所有 ESLint 错误
- 跑 npm run lint
- 每次修 1-3 个错误
- 再跑 lint 验证
完成后输出：✅DONE" \
--max-iterations 15 \
--completion-promise "✅DONE"

3️⃣ 把 Redux 迁移到 Zustand

/ralph-loop "把项目从 Redux 迁移到 Zustand
验证：
- 删除 @reduxjs 依赖
- 所有 store 改为 zustand
- npm run build 0 错误
- npm test 全过
完成后输出：✅DONE" \
--max-iterations 25 \
--completion-promise "✅DONE"

4️⃣ 实现一个 Todo REST API（新手练手）

/ralph-loop "用 Node+Express 写 Todo REST API
完成标准：
- CRUD 端点 /todos 全通
- 有输入校验（Joi/Zod）
- npm test 通过率 100%
- README 带 curl 示例
完成后输出：✅DONE" \
--max-iterations 15 \
--completion-promise "✅DONE"

5️⃣ 首页 Lighthouse 性能分 >95

/ralph-loop "优化首页到 Lighthouse 性能分 >95
步骤：
- 跑 npm run lighthouse
- 解决提示：图片、字体、JS
- 再跑 lighthouse 直到 >95
完成后输出：✅DONE" \
--max-iterations 25 \
--completion-promise "✅DONE"

6️⃣ 自动生成组件库文档

/ralph-loop "给 src/components 每个组件写 README
要求：
- 用法示例（代码块）
- props 表格
- 截图或草图
完成后输出：✅DONE" \
--max-iterations 10 \
--completion-promise "✅DONE"

7️⃣ 清理 console.log & 注释

/ralph-loop "清理生产代码里的 console.log 与无用注释
验证：
- npm run build 0 warning
- 搜索 console.log 0 结果
完成后输出：✅DONE" \
--max-iterations 10 \
--completion-promise "✅DONE"

8️⃣ 把 Jest 换成 Vitest

/ralph-loop "把测试框架从 Jest 换成 Vitest
验证：
- 删除 jest.config.js
- vitest.config.ts 存在
- 所有 *.test.ts 用 vitest 导入
- npm run test 全过
完成后输出：✅DONE" \
--max-iterations 20 \
--completion-promise "✅DONE"

9️⃣ 算法死磕：LeetCode 风格题

/ralph-loop "实现 O(n log n) 的 Top-K 频繁元素
验证：
- 通过 20 组随机测试
- 时间 ≤ 100ms
- 内存 ≤ 50MB
完成后输出：✅DONE" \
--max-iterations 15 \
--completion-promise "✅DONE"

🔟 自动国际化（i18n）

/ralph-loop "给项目加 react-i18next
完成标准：
- 所有中文文案提取到 locales/zh.json
- 英文版 locales/en.json
- 默认语言 en
- npm run build 无错误
完成后输出：✅DONE" \
--max-iterations 20 \
--completion-promise "✅DONE"

1️⃣1️⃣ 生成 CHANGELOG & 打标签

/ralph-loop "基于最近 10 条 Git 提交生成 CHANGELOG.md
- 符合 Keep a Changelog 格式
- 版本号自动 patch+1
- 推送到远程并打 Git tag
完成后输出：✅DONE" \
--max-iterations 10 \
--completion-promise "✅DONE"

1️⃣2️⃣ 一键格式化 + 提交

/ralph-loop "统一代码风格
- 跑 npm run format
- 自动修复所有文件
- git add . && git commit -m 'style: format code'
完成后输出：✅DONE" \
--max-iterations 5 \
--completion-promise "✅DONE"

---

六、可视化流程图（一眼懂）

graph LR A[你输入 ralph-loop] --> B{AI 开始第 1 轮} B --> C[写代码/改文件] C --> D[跑测试/验证] D --> E{验证通过?} E -->|否| B E -->|是| F[输出 ✅DONE] F --> G[循环结束]

---

七、常见坑速查表

坑	解决方案
循环停不下来	暗号拼错或 AI 没原样输出；换独特暗号如 🎉OK
token 爆炸	先把 --max-iterations 设小（5~10）试跑
任务越跑越偏	完成标准写得不够“可机器验证”，重写提示词
文件冲突	在提示词里加“先 pull 再 push”或“用 git stash 暂存”

---

八、小结（30 秒版）

1. 小任务 + 机器验证 + 暗号 = 成功三件套
2. 先用 5 次迭代试水，再放大
3. 复制上方 12 个提示词，改个路径就能跑
4. Ctrl+C 随时停，进度不丢

现在就去试一个：/ralph-loop "把当前目录所有文件格式化成 Prettier 风格，完成后输出：🎉OK" --max-iterations 5 --completion-promise "🎉OK"
等你回来报喜！