cc-ralph

/cc-ralph - CC-Best Ralph Loop 集成

使用 cc-best 工作流启动 Ralph Loop 自主开发循环。

同时支持插件用户和 Clone 用户。

---

与官方 ralph-loop 的关系

┌─────────────────────────────────────────────────────────────┐
│  /cc-best:cc-ralph (cc-best 插件)                                    │
│  ├── 读取项目状态 (progress.md, CLAUDE.md)                   │
│  ├── 生成 cc-best 工作流 Prompt                              │
│  │   (角色切换、迭代步骤、完成标准)                           │
│  └── 调用 ↓                                                  │
├─────────────────────────────────────────────────────────────┤
│  /ralph-loop:ralph-loop (官方插件)                           │
│  ├── 提供循环机制 (Stop hook)                                │
│  ├── 管理迭代次数                                            │
│  └── 检测完成信号 (<promise>)                                │
└─────────────────────────────────────────────────────────────┘

简单理解：

• ralph-loop：官方插件，提供"循环"能力（让 Claude 持续工作直到完成）
• cc-ralph：cc-best 的包装命令，提供"工作流"（告诉 Claude 按什么流程工作）

为什么需要 cc-ralph？ 直接用 /ralph-loop:ralph-loop "任务描述" 时，需要手动编写完整的 prompt。 而 /cc-best:cc-ralph 自动：

1. 读取项目当前状态
2. 注入 cc-best 的角色工作流（PM→Lead→Designer→Dev→QA）
3. 添加完成标准和卡住处理逻辑

---

前置条件

需要安装 ralph-loop 官方插件：

/plugin install ralph-loop@claude-plugins-official

⚠️ Windows 用户注意：

ralph-loop 插件的 setup 脚本是 bash 脚本，在 Windows 原生环境可能报错：

Error: Bash command failed for pattern "...setup-ralph-loop.sh"

解决方案：

1. 推荐：使用 WSL (Windows Subsystem for Linux)
2. 替代：使用 Git Bash 运行 Claude Code
3. 替代：直接使用 /cc-best:iterate（单会话版本，无需 ralph-loop）

ralph-loop 插件还依赖 jq 工具，需提前安装。

---

使用方式

基本用法

# 自动读取 progress.md，继续当前任务
/cc-best:cc-ralph

# 指定任务描述
/cc-best:cc-ralph "实现用户登录功能"

# 指定最大迭代次数
/cc-best:cc-ralph "完成 Phase 2" --max-iterations 20

选择模式

# 完整功能开发（默认）
/cc-best:cc-ralph --mode full-feature "实现用户认证"

# Phase 迭代（按 progress.md 推进）
/cc-best:cc-ralph --mode iterate

# Bug 修复
/cc-best:cc-ralph --mode bug-fix "修复登录超时问题"

# 代码重构
/cc-best:cc-ralph --mode refactor "重构认证模块"

# 修复测试
/cc-best:cc-ralph --mode fix-tests

# 文档生成
/cc-best:cc-ralph --mode doc-gen "生成 API 文档"