SuperAPI AI 工具集

ralph-mode

通用与其它

查看项目

更新于 10-16 02:29

技能介绍

用途:Ralph Mode 是一个自主 AI 编码循环,反复启动全新上下文窗口,逐个实现用户故事,直到全部任务完成。适合希望让 AI 在无人值守时持续交付功能的场景,例如过夜运行。

主要能力:支持两种执行模式。本地模式在 CLI 终端中由 Bash 循环反复调用 claude -p;远程模式在 Web/API/Agent SDK 中由控制器生成 Task 子代理。两者都以每次迭代使用全新上下文来避免上下文腐化。记忆仅通过 prd.json(任务状态)、progress.txt(经验与陷阱)、git 提交历史和 AGENTS.md(项目模式)持久化。

使用方式:先运行 bun .claude/skills/ralph-mode/scripts/init-ralph.ts 初始化,生成 scripts/ralph/ 目录;再编辑 scripts/ralph/prd.json 填写用户故事。本地运行:./scripts/ralph/ralph.sh 20 为 AFK 模式最多 20 次迭代,./scripts/ralph/ralph-once.sh 为 HITL 单次迭代。远程模式需加载 scripts/ralph/ralph-controller.md 并按其说明操作,控制器只负责读取状态、选择故事、生成 Task 子代理、验证结果并循环,不直接写代码。

适用场景:有明确验收标准、可拆分为小步用户故事的功能开发;建议先 HITL 观察再转 AFK 批量执行,优先处理高风险任务。

限制:不适合无明确结果的探索性工作、缺少明确标准的大型重构、需要人工审查的安全关键代码,以及早期架构决策。本地 AFK 使用 --dangerously-skip-permissions,建议配合 Docker 沙箱并始终限制迭代次数。Ctrl+C 可立即停止本地循环,git reset --hard 可回退未提交更改。具体收费、价格与平台支持暂未提供。