mcpField
S
setup-ralph

setup-ralph

github.com/glittercowboyAgent 工作流2.0k124 次安装30 周前更新
代码仓库

关于 setup-ralph

用于设置和管理 Ralph 循环的技能，面向采用自主迭代编码流程的开发者。它将规划、任务实现与验证分阶段，并通过文件保存计划状态。

主要功能

  1. 01初始化 Ralph 循环结构
  2. 02区分规划与构建阶段
  3. 03通过测试、类型检查和构建形成反馈
  4. 04使用文件在迭代间保存计划
  5. 05提供定制与故障排查流程

适用场景

  1. 01为项目初始化 Ralph 循环
  2. 02了解 Ralph 的工作方式
  3. 03调整现有循环的提示词或配置
  4. 04排查循环问题并改进验证

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/glittercowboy/taches-cc-resources --skill setup-ralph

安装后在 Claude Code 中输入/setup-ralph确认已加载。

包含的文件

除 SKILL.md 外，安装时一起下载的参考资料和脚本。

README.md
references/
operational-learnings.md
project-structure.md
prompt-design.md
ralph-fundamentals.md
validation-strategy.md
templates/
Dockerfile
loop-docker.sh
loop.sh
PROMPT_build.md
PROMPT_plan.md
workflows/
customize-loop.md
setup-new-loop.md
troubleshoot-loop.md
understand-ralph.md

详细介绍

<essential_principles>

什么是 Ralph？

Ralph 是 Geoffrey Huntley 提出的自主 AI 编码方法，采用包含任务选择、执行和验证的迭代循环。最纯粹的形式是一个 Bash 循环：

while :; do cat PROMPT.md | claude ; done

循环会将提示词文件传给 Claude，Agent 完成一项任务、更新实施计划、提交更改，然后退出。循环会立即重新启动，并使用全新的上下文。

核心理念

在一个不可确定的世界里，Ralph Wiggum 技术以确定性的方式表现糟糕。 Ralph 通过让每次迭代都从全新上下文开始，解决上下文累积问题——这是 Geoffrey 方法背后的核心洞见。

三个阶段、两个提示词、一个循环
  1. 规划阶段：差距分析（规格说明与代码的对比）生成按优先级排序的待办列表——不进行实现，也不提交更改
  2. 构建阶段：从计划中选择任务、实现任务、运行测试（形成反压），然后提交更改
  3. 观察阶段：你要置身于循环之上，而不是身处其中——设计好设置和环境，让 Ralph 能够成功
核心原则

你的职责：所有工作都由 Ralph 完成，包括决定下一步实现哪项计划中的工作，以及如何实现。你的任务是设计环境。

反压：通过测试、类型检查、代码检查和构建来形成反压，拒绝无效或不可接受的工作。

观察：尤其在早期要密切观察。提示词会根据观察到的失败模式不断调整。

上下文效率：在 200K 上下文窗口中，可用 token 约为 176K；将 40–60% 分配给“智能区”，并确保每个循环只处理一个紧凑任务，即可最大限度地利用上下文。

通过文件 I/O 管理状态：计划文件会在彼此隔离的循环执行之间保留下来，充当确定性的共享状态——无需复杂的编排。

远程备份：循环会自动创建一个私有 GitHub 仓库，并在每次提交后推送。这可以防止自主操作导致意外数据丢失。需要已完成身份验证的 gh CLI。使用 RALPH_BACKUP=false 可禁用此功能。

安全规则：PROMPT_build.md 包含关键安全规则，禁止执行诸如对项目目录使用 rm -rf 之类的危险操作。测试必须在隔离的临时目录中运行。 </essential_principles>

你想要做什么？
  1. 设置新的 Ralph 循环 - 在某个目录中初始化 Ralph 结构
  2. 了解 Ralph 概念 - 学习该技术及其工作原理
  3. 自定义现有循环 - 修改提示词或配置
  4. 排查 Ralph 问题 - 调试循环问题或提升性能

等待用户回复后再继续。

| 回复 | 工作流 | |----------|----------| | 1、“设置”、“setup”、“新建”、“初始化”、“创建” | `workflows/setup-new-loop.md` | | 2、“了解”、“学习”、“概念”、“解释”、“如何” | `workflows/understand-ralph.md` | | 3、“自定义”、“修改”、“更改”、“更新”、“编辑” | `workflows/customize-loop.md` | | 4、“排查问题”、“调试”、“修复”、“问题”、“故障” | `workflows/troubleshoot-loop.md` | | 其他 | 澄清意图，然后选择合适的工作流 |

阅读工作流后，严格遵循其中的说明。

<reference_index>

领域知识

全部位于 references/ 中：

核心概念： ralph-fundamentals.md - 三个阶段、两个提示词、一个循环 结构： project-structure.md - 必需文件和目录布局 提示词： prompt-design.md - 规划模式与构建模式说明 反压机制： validation-strategy.md - 通过测试、代码检查和构建来引导 最佳实践： operational-learnings.md - AGENTS.md 指南与演进 </reference_index>

<workflows_index>

工作流用途
setup-new-loop.md在目录中初始化 Ralph 结构
understand-ralph.md了解 Ralph 概念与理念
customize-loop.md修改提示词或循环配置
troubleshoot-loop.md调试循环问题并提升性能
</workflows_index>

<success_criteria> 技能成功的标准：

  • 用户了解自己需要哪种工作流
  • 根据意图加载适当的工作流
  • 加载工作流所需的所有参考资料
  • 用户能够独立设置并运行 Ralph 循环 </success_criteria>

评论

支持 Markdown