[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"similar-snwfdhmp--awesome-ralph":3,"tool-snwfdhmp--awesome-ralph":62},[4,18,28,37,45,53],{"id":5,"name":6,"github_repo":7,"description_zh":8,"stars":9,"difficulty_score":10,"last_commit_at":11,"category_tags":12,"status":17},4358,"openclaw","openclaw\u002Fopenclaw","OpenClaw 是一款专为个人打造的本地化 AI 助手，旨在让你在自己的设备上拥有完全可控的智能伙伴。它打破了传统 AI 助手局限于特定网页或应用的束缚，能够直接接入你日常使用的各类通讯渠道，包括微信、WhatsApp、Telegram、Discord、iMessage 等数十种平台。无论你在哪个聊天软件中发送消息，OpenClaw 都能即时响应，甚至支持在 macOS、iOS 和 Android 设备上进行语音交互，并提供实时的画布渲染功能供你操控。\n\n这款工具主要解决了用户对数据隐私、响应速度以及“始终在线”体验的需求。通过将 AI 部署在本地，用户无需依赖云端服务即可享受快速、私密的智能辅助，真正实现了“你的数据，你做主”。其独特的技术亮点在于强大的网关架构，将控制平面与核心助手分离，确保跨平台通信的流畅性与扩展性。\n\nOpenClaw 非常适合希望构建个性化工作流的技术爱好者、开发者，以及注重隐私保护且不愿被单一生态绑定的普通用户。只要具备基础的终端操作能力（支持 macOS、Linux 及 Windows WSL2），即可通过简单的命令行引导完成部署。如果你渴望拥有一个懂你",349277,3,"2026-04-06T06:32:30",[13,14,15,16],"Agent","开发框架","图像","数据工具","ready",{"id":19,"name":20,"github_repo":21,"description_zh":22,"stars":23,"difficulty_score":24,"last_commit_at":25,"category_tags":26,"status":17},9989,"n8n","n8n-io\u002Fn8n","n8n 是一款面向技术团队的公平代码（fair-code）工作流自动化平台，旨在让用户在享受低代码快速构建便利的同时，保留编写自定义代码的灵活性。它主要解决了传统自动化工具要么过于封闭难以扩展、要么完全依赖手写代码效率低下的痛点，帮助用户轻松连接 400 多种应用与服务，实现复杂业务流程的自动化。\n\nn8n 特别适合开发者、工程师以及具备一定技术背景的业务人员使用。其核心亮点在于“按需编码”：既可以通过直观的可视化界面拖拽节点搭建流程，也能随时插入 JavaScript 或 Python 代码、调用 npm 包来处理复杂逻辑。此外，n8n 原生集成了基于 LangChain 的 AI 能力，支持用户利用自有数据和模型构建智能体工作流。在部署方面，n8n 提供极高的自由度，支持完全自托管以保障数据隐私和控制权，也提供云端服务选项。凭借活跃的社区生态和数百个现成模板，n8n 让构建强大且可控的自动化系统变得简单高效。",184740,2,"2026-04-19T23:22:26",[16,14,13,15,27],"插件",{"id":29,"name":30,"github_repo":31,"description_zh":32,"stars":33,"difficulty_score":10,"last_commit_at":34,"category_tags":35,"status":17},10095,"AutoGPT","Significant-Gravitas\u002FAutoGPT","AutoGPT 是一个旨在让每个人都能轻松使用和构建 AI 的强大平台，核心功能是帮助用户创建、部署和管理能够自动执行复杂任务的连续型 AI 智能体。它解决了传统 AI 应用中需要频繁人工干预、难以自动化长流程工作的痛点，让用户只需设定目标，AI 即可自主规划步骤、调用工具并持续运行直至完成任务。\n\n无论是开发者、研究人员，还是希望提升工作效率的普通用户，都能从 AutoGPT 中受益。开发者可利用其低代码界面快速定制专属智能体；研究人员能基于开源架构探索多智能体协作机制；而非技术背景用户也可直接选用预置的智能体模板，立即投入实际工作场景。\n\nAutoGPT 的技术亮点在于其模块化“积木式”工作流设计——用户通过连接功能块即可构建复杂逻辑，每个块负责单一动作，灵活且易于调试。同时，平台支持本地自托管与云端部署两种模式，兼顾数据隐私与使用便捷性。配合完善的文档和一键安装脚本，即使是初次接触的用户也能在几分钟内启动自己的第一个 AI 智能体。AutoGPT 正致力于降低 AI 应用门槛，让人人都能成为 AI 的创造者与受益者。",183572,"2026-04-20T04:47:55",[13,36,27,14,15],"语言模型",{"id":38,"name":39,"github_repo":40,"description_zh":41,"stars":42,"difficulty_score":10,"last_commit_at":43,"category_tags":44,"status":17},3808,"stable-diffusion-webui","AUTOMATIC1111\u002Fstable-diffusion-webui","stable-diffusion-webui 是一个基于 Gradio 构建的网页版操作界面，旨在让用户能够轻松地在本地运行和使用强大的 Stable Diffusion 图像生成模型。它解决了原始模型依赖命令行、操作门槛高且功能分散的痛点，将复杂的 AI 绘图流程整合进一个直观易用的图形化平台。\n\n无论是希望快速上手的普通创作者、需要精细控制画面细节的设计师，还是想要深入探索模型潜力的开发者与研究人员，都能从中获益。其核心亮点在于极高的功能丰富度：不仅支持文生图、图生图、局部重绘（Inpainting）和外绘（Outpainting）等基础模式，还独创了注意力机制调整、提示词矩阵、负向提示词以及“高清修复”等高级功能。此外，它内置了 GFPGAN 和 CodeFormer 等人脸修复工具，支持多种神经网络放大算法，并允许用户通过插件系统无限扩展能力。即使是显存有限的设备，stable-diffusion-webui 也提供了相应的优化选项，让高质量的 AI 艺术创作变得触手可及。",162132,"2026-04-05T11:01:52",[14,15,13],{"id":46,"name":47,"github_repo":48,"description_zh":49,"stars":50,"difficulty_score":24,"last_commit_at":51,"category_tags":52,"status":17},1381,"everything-claude-code","affaan-m\u002Feverything-claude-code","everything-claude-code 是一套专为 AI 编程助手（如 Claude Code、Codex、Cursor 等）打造的高性能优化系统。它不仅仅是一组配置文件，而是一个经过长期实战打磨的完整框架，旨在解决 AI 代理在实际开发中面临的效率低下、记忆丢失、安全隐患及缺乏持续学习能力等核心痛点。\n\n通过引入技能模块化、直觉增强、记忆持久化机制以及内置的安全扫描功能，everything-claude-code 能显著提升 AI 在复杂任务中的表现，帮助开发者构建更稳定、更智能的生产级 AI 代理。其独特的“研究优先”开发理念和针对 Token 消耗的优化策略，使得模型响应更快、成本更低，同时有效防御潜在的攻击向量。\n\n这套工具特别适合软件开发者、AI 研究人员以及希望深度定制 AI 工作流的技术团队使用。无论您是在构建大型代码库，还是需要 AI 协助进行安全审计与自动化测试，everything-claude-code 都能提供强大的底层支持。作为一个曾荣获 Anthropic 黑客大奖的开源项目，它融合了多语言支持与丰富的实战钩子（hooks），让 AI 真正成长为懂上",161147,"2026-04-19T23:31:47",[14,13,36],{"id":54,"name":55,"github_repo":56,"description_zh":57,"stars":58,"difficulty_score":59,"last_commit_at":60,"category_tags":61,"status":17},8272,"opencode","anomalyco\u002Fopencode","OpenCode 是一款开源的 AI 编程助手（Coding Agent），旨在像一位智能搭档一样融入您的开发流程。它不仅仅是一个代码补全插件，而是一个能够理解项目上下文、自主规划任务并执行复杂编码操作的智能体。无论是生成全新功能、重构现有代码，还是排查难以定位的 Bug，OpenCode 都能通过自然语言交互高效完成，显著减少开发者在重复性劳动和上下文切换上的时间消耗。\n\n这款工具专为软件开发者、工程师及技术研究人员设计，特别适合希望利用大模型能力来提升编码效率、加速原型开发或处理遗留代码维护的专业人群。其核心亮点在于完全开源的架构，这意味着用户可以审查代码逻辑、自定义行为策略，甚至私有化部署以保障数据安全，彻底打破了传统闭源 AI 助手的“黑盒”限制。\n\n在技术体验上，OpenCode 提供了灵活的终端界面（Terminal UI）和正在测试中的桌面应用程序，支持 macOS、Windows 及 Linux 全平台。它兼容多种包管理工具，安装便捷，并能无缝集成到现有的开发环境中。无论您是追求极致控制权的资深极客，还是渴望提升产出的独立开发者，OpenCode 都提供了一个透明、可信",144296,1,"2026-04-16T14:50:03",[13,27],{"id":63,"github_repo":64,"name":65,"description_en":66,"description_zh":67,"ai_summary_zh":68,"readme_en":69,"readme_zh":70,"quickstart_zh":71,"use_case_zh":72,"hero_image_url":73,"owner_login":74,"owner_name":75,"owner_avatar_url":76,"owner_bio":77,"owner_company":78,"owner_location":79,"owner_email":77,"owner_twitter":77,"owner_website":80,"owner_url":81,"languages":77,"stars":82,"forks":83,"last_commit_at":84,"license":77,"difficulty_score":24,"env_os":85,"env_gpu":86,"env_ram":86,"env_deps":87,"category_tags":94,"github_topics":95,"view_count":24,"oss_zip_url":77,"oss_zip_packed_at":77,"status":17,"created_at":103,"updated_at":104,"faqs":105,"releases":106},10055,"snwfdhmp\u002Fawesome-ralph","awesome-ralph","A curated list of resources about Ralph, the AI coding technique that runs AI coding agents in automated loops until specifications are fulfilled.","awesome-ralph 是一个精选资源库，专门收录关于\"Ralph\"这一创新 AI 编程方法论的相关资料。Ralph 由 Geoffrey Huntley 提出，其核心理念是将 AI 编码智能体置于自动化循环中持续运行，直到完全满足项目规格说明书的要求。\n\n传统 AI 辅助编程常受限于上下文窗口大小，导致长任务中记忆丢失或逻辑断裂。Ralph 巧妙解决了这一痛点：它不依赖漫长的对话历史，而是将进度持久化存储在文件系统和 Git 记录中。每次迭代都让 AI 从干净的上下文重新启动，结合测试、代码检查和类型验证等“背压”机制来自动校验成果。这种“坐在循环之外而非之中”的哲学，旨在用确定性的流程驾驭不确定的模型输出。\n\n该资源库非常适合希望探索自主编程工作流的开发者、技术负责人及 AI 研究人员。它不仅提供了核心的 Bash 循环脚本示例，还汇集了官方指南、实施 playbook、多智能体系统案例以及社区讨论。通过遵循其定义的“需求定义、规划模式、构建模式”三阶段工作流，用户可以更高效地利用 Claude Code 等工具，实现复杂软件的自动化开发与迭代，是掌握下一代 AI 驱动开发范式","awesome-ralph 是一个精选资源库，专门收录关于\"Ralph\"这一创新 AI 编程方法论的相关资料。Ralph 由 Geoffrey Huntley 提出，其核心理念是将 AI 编码智能体置于自动化循环中持续运行，直到完全满足项目规格说明书的要求。\n\n传统 AI 辅助编程常受限于上下文窗口大小，导致长任务中记忆丢失或逻辑断裂。Ralph 巧妙解决了这一痛点：它不依赖漫长的对话历史，而是将进度持久化存储在文件系统和 Git 记录中。每次迭代都让 AI 从干净的上下文重新启动，结合测试、代码检查和类型验证等“背压”机制来自动校验成果。这种“坐在循环之外而非之中”的哲学，旨在用确定性的流程驾驭不确定的模型输出。\n\n该资源库非常适合希望探索自主编程工作流的开发者、技术负责人及 AI 研究人员。它不仅提供了核心的 Bash 循环脚本示例，还汇集了官方指南、实施 playbook、多智能体系统案例以及社区讨论。通过遵循其定义的“需求定义、规划模式、构建模式”三阶段工作流，用户可以更高效地利用 Claude Code 等工具，实现复杂软件的自动化开发与迭代，是掌握下一代 AI 驱动开发范式的重要入口。","\n\u003Cp align=\"center\">\n  \u003Ca href=\"https:\u002F\u002Fwww.reddit.com\u002Fr\u002FRalphCoding\u002F\">\n\u003Cimg src=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Fsnwfdhmp_awesome-ralph_readme_506224b87390.png\" width=\"1000\" alt=\"Ralph Wiggum AI Coding method\">\n  \u003C\u002Fa>\n\u003C\u002Fp>\n\n\n# Awesome Ralph [![Awesome](https:\u002F\u002Fawesome.re\u002Fbadge.svg)](https:\u002F\u002Fawesome.re) [![Follow on X](https:\u002F\u002Fimg.shields.io\u002Ftwitter\u002Ffollow\u002Fsnwfdhmp?style=social)](https:\u002F\u002Fx.com\u002Fsnwfdhmp)\n\n> A curated list of resources about Ralph (aka Ralph Wiggum), the AI coding technique that runs AI coding agents in automated loops until specifications are fulfilled.\n\nRalph is a technique created by [Geoffrey Huntley](https:\u002F\u002Fghuntley.com) for autonomous AI coding. The core concept is elegantly simple:\n\n```bash\nwhile :; do cat PROMPT.md | claude-code ; done\n```\n\n**Key principles:**\n- Run an AI agent repeatedly until a PRD\u002Fspecification is complete\n- Progress persists in files and git history, not in context\n- Each iteration starts fresh with clean context\n- Use \"backpressure\" (tests, lints, type checks) to validate work\n- Philosophy: *\"Sit on the loop, not in it\"* — or as Huntley puts it: *\"deterministically bad in an undeterministic world\"*\n\n> **Found this useful? ⭐️ Like this repo to help others discover it**\n\n## Contents\n\n- [Official Resources](#official-resources)\n- [Playbooks & Methodology](#playbooks--methodology)\n- [Implementations](#implementations)\n  - [Claude Code Plugins](#claude-code-plugins)\n  - [Standalone Implementations](#standalone-implementations)\n  - [Tool-Specific Implementations](#tool-specific-implementations)\n  - [Multi-Agent Systems](#multi-agent-systems)\n- [Tutorials & Guides](#tutorials--guides)\n- [Articles & Blog Posts](#articles--blog-posts)\n- [Videos & Podcasts](#videos--podcasts)\n  - [Videos](#videos)\n  - [Podcasts](#podcasts)\n- [Community](#community)\n  - [Hacker News Discussions](#hacker-news-discussions)\n  - [Tools & Directories](#tools--directories)\n  - [Ralph Communities](#ralph-communities)\n- [Related Tools](#related-tools)\n- [Support](#support)\n- [Contributing](#contributing)\n\n## Official Resources\n\nPrimary sources from Geoffrey Huntley, the creator of the Ralph technique.\n\n- [Ralph Wiggum as a 'Software Engineer'](https:\u002F\u002Fghuntley.com\u002Fralph\u002F) - The definitive introduction. Explains the bash loop, \"tuning like a guitar\" metaphor, and the economics of autonomous coding.\n- [Everything is a Ralph Loop](https:\u002F\u002Fghuntley.com\u002Floop\u002F) - Deeper philosophical exploration covering \"reverse mode\" clean-rooming, orchestrator patterns, and \"The Weaving Loom\" concept.\n- [Don't Waste Your Back Pressure](https:\u002F\u002Fghuntley.com\u002Fpressure\u002F) - Technical deep-dive on backpressure — the art of rejecting invalid generations without creating too much resistance.\n- [I Ran Claude in a Loop for Three Months](https:\u002F\u002Fghuntley.com\u002Fcursed\u002F) - Case study: Ralph built CURSED, a Gen Z slang-based programming language with LLVM compiler.\n- [Too Many Model Context Protocol Servers](https:\u002F\u002Fghuntley.com\u002Fallocations\u002F) - Context allocation theory — Ralph minimizes allocation to avoid compaction events.\n\n## Playbooks & Methodology\n\nComprehensive implementation guides covering the **3 Phases, 2 Prompts, 1 Loop** workflow.\n\n- [How to Ralph Wiggum](https:\u002F\u002Fgithub.com\u002Fghuntley\u002Fhow-to-ralph-wiggum) - Geoffrey Huntley's official playbook covering context management, sandboxing, and prompt patterns.\n- [ralph-playbook](https:\u002F\u002Fgithub.com\u002FClaytonFarr\u002Fralph-playbook) - Comprehensive methodology guide with diagrams, phase explanations, and \"signs & gates\" steering techniques.\n\n### The Core Workflow\n\n**Phase 1: Define Requirements** — Human + LLM conversation produces JTBD-aligned specifications\n**Phase 2: Planning Mode** — Gap analysis generates prioritized TODO list (no implementation)\n**Phase 3: Building Mode** — Implement from plan, run tests, commit, repeat\n\n### Essential File Structure\n\n```\nproject-root\u002F\n├── loop.sh                    # Ralph loop script\n├── PROMPT_build.md            # Build mode instructions\n├── PROMPT_plan.md             # Plan mode instructions\n├── AGENTS.md                  # Operational guide (~60 lines max)\n├── IMPLEMENTATION_PLAN.md     # Prioritized task list (generated)\n├── specs\u002F                     # Requirement specs (one per JTBD)\n└── src\u002F                       # Application source code\n```\n\n## Implementations\n\n### Claude Code Plugins\n\n- [ralph-claude-code](https:\u002F\u002Fgithub.com\u002Ffrankbria\u002Fralph-claude-code) - Claude Code with intelligent exit detection, rate limiting, circuit breaker, and semantic response analyzer.\n- [choo-choo-ralph](https:\u002F\u002Fgithub.com\u002Fmj-meyer\u002Fchoo-choo-ralph) - Beads-powered 5-phase workflow with structured specs, verified implementations, and compounding knowledge—per-project installation with fully customizable workflows.\n\n### Standalone Implementations\n\n- [ralph-starter](https:\u002F\u002Fgithub.com\u002Frubenmarcus\u002Fralph-starter) - CLI with integrations for GitHub, Linear, and Notion; supports multiple agents, interactive wizard, workflow presets, and cost tracking.\n- [snartank\u002Fralph](https:\u002F\u002Fgithub.com\u002Fsnarktank\u002Fralph) - PRD-driven task management with automatic branching, flowchart visualization, and auto-archiving.\n- [iannuttall\u002Fralph](https:\u002F\u002Fgithub.com\u002Fiannuttall\u002Fralph) - Minimal file-based agent loop supporting codex\u002Fclaude\u002Fdroid\u002Fopencode.\n- [smart-ralph](https:\u002F\u002Fgithub.com\u002Ftzachbon\u002Fsmart-ralph) - Spec-driven development workflow. Transforms feature requests into structured specs (research, requirements, design, tasks) then executes them task-by-task autonomously.\n- [ralph-wiggum-bdd](https:\u002F\u002Fgithub.com\u002Fmarcindulak\u002Fralph-wiggum-bdd) - A standalone Bash script for Behavior-Driven Development with Ralph Wiggum Loop.\n- [ralph-orchestrator](https:\u002F\u002Fgithub.com\u002Fmikeyobrien\u002Fralph-orchestrator) - Rust orchestrator with 7 AI backends, Hat System for specialized personas, and interactive TUI mode.\n- [nitodeco\u002Fralph](https:\u002F\u002Fgithub.com\u002Fnitodeco\u002Fralph) - CLI orchestration tool for PRD-driven development with sequential task execution and interactive terminal UI.\n- [pentoai\u002Fml-ralph](https:\u002F\u002Fgithub.com\u002Fpentoai\u002Fml-ralph) - Autonomous ML agent for running experiments using Claude or Codex.\n- [oh-my-ralph](https:\u002F\u002Fgithub.com\u002Fvivganes\u002Foh-my-ralph) - Opinionated Ralph Wiggum loop implemented in Python.\n\n### Tool-Specific Implementations\n\n- [ralph-wiggum-cursor](https:\u002F\u002Fgithub.com\u002Fagrimsingh\u002Fralph-wiggum-cursor) - Cursor implementation with token tracking, context rotation at 80k tokens, and interactive setup.\n- [opencode-ralph-wiggum](https:\u002F\u002Fgithub.com\u002FTh0rgal\u002Fopencode-ralph-wiggum) - OpenCode implementation with real-time status display, mid-loop context injection, and struggle detection.\n- [ralph (GitHub Copilot)](https:\u002F\u002Fgithub.com\u002Faymenfurter\u002Fralph) - VS Code extension with visual Control Panel, Progress Timeline, and Fresh Chat Mode.\n- [ralph-tui](https:\u002F\u002Fgithub.com\u002Fsubsy\u002Fralph-tui) - Terminal UI orchestrator connecting to task trackers with interactive PRD creation.\n- [Goose Ralph Loop Tutorial](https:\u002F\u002Fblock.github.io\u002Fgoose\u002Fdocs\u002Ftutorials\u002Fralph-loop\u002F) - Block's Goose implementation with cross-model review and recipe-based workflows.\n\n### Multi-Agent Systems\n\n- [ralph-loop-agent](https:\u002F\u002Fgithub.com\u002Fvercel-labs\u002Fralph-loop-agent) - Vercel's TypeScript SDK wrapper with verification callbacks and context summarization.\n- [multi-agent-ralph-loop](https:\u002F\u002Fgithub.com\u002Falfredolopez80\u002Fmulti-agent-ralph-loop) - Multi-agent orchestration for complex projects requiring parallel work streams.\n\n## Tutorials & Guides\n\n- [Getting Started with Ralph](https:\u002F\u002Fwww.aihero.dev\u002Fgetting-started-with-ralph) - Step-by-step quickstart with Claude Code + Docker by Matt Pocock.\n- [11 Tips for AI Coding with Ralph Wiggum](https:\u002F\u002Fwww.aihero.dev\u002Ftips-for-ai-coding-with-ralph-wiggum) - AFK coding, HITL Ralph, iteration caps, and progress tracking.\n- [The Ralph Wiggum Approach](https:\u002F\u002Fdev.to\u002Fsivarampg\u002Fthe-ralph-wiggum-approach-running-ai-coding-agents-for-hours-not-minutes-57c1) - Stop hook mechanism, troubleshooting, and Q&A.\n- [The Real Ralph Wiggum Loop](https:\u002F\u002Fthetrav.substack.com\u002Fp\u002Fthe-real-ralph-wiggum-loop-what-everyone) - Clarifies original bash loop vs Anthropic plugin philosophy.\n- [Ralph Wiggum Guide](https:\u002F\u002Fgithub.com\u002FJeredBlu\u002Fguides\u002Fblob\u002Fmain\u002FRalph_Wiggum_Guide.md) - Community-written comprehensive guide.\n- [Awesome Claude - Ralph Wiggum](https:\u002F\u002Fawesomeclaude.ai\u002Fralph-wiggum) - Resource page with additional tips and configuration examples.\n- [How to Build an Effective Long Running Agent Loop in 7 minutes.](https:\u002F\u002Fx.com\u002Fdabit3\u002Fstatus\u002F2013091003104727338?s=20) - Walks you through the entire process from creating a spec, building and polishing a PRD, to running the agent with frameworks like Claude Code, Codex, and OpenCode.\n\n## Articles & Blog Posts\n\n- [How Ralph Wiggum Went from The Simpsons to the Biggest Name in AI](https:\u002F\u002Fventurebeat.com\u002Ftechnology\u002Fhow-ralph-wiggum-went-from-the-simpsons-to-the-biggest-name-in-ai-right-now) - VentureBeat coverage on the cultural phenomenon.\n- [A Brief History of Ralph](https:\u002F\u002Fwww.humanlayer.dev\u002Fblog\u002Fbrief-history-of-ralph) - Comprehensive timeline including Y Combinator hackathon story.\n- [Ralph Wiggum and AI Coding Loops](https:\u002F\u002Fwww.ishir.com\u002Fblog\u002F312751\u002Fralph-wiggum-and-ai-coding-loops-from-springfield-to-real-world-software-automation.htm) - From Springfield to real-world software automation.\n- [Ralph Wiggum Explained: The Claude Code Loop That Keeps Going](https:\u002F\u002Fblog.devgenius.io\u002Fralph-wiggum-explained-the-claude-code-loop-that-keeps-going-3250dcc30809) - Technical explainer of how and why it works.\n- [2026: The Year of the Ralph Loop Agent](https:\u002F\u002Fdev.to\u002Falexandergekov\u002F2026-the-year-of-the-ralph-loop-agent-1gkj) - Predictions and analysis of the Ralph loop's impact on development.\n\n## Videos & Podcasts\n\n### Videos\n\n- [Ralph Wiggum Deep Dive with Geoffrey Huntley](https:\u002F\u002Fwww.youtube.com\u002Fwatch?v=SB6cO97tfiY) - The definitive video. Live coding demo, history, and comparison of bash-loop vs stop-hook implementations.\n- [AI That Works Podcast Episode](https:\u002F\u002Fwww.youtube.com\u002Fwatch?v=fOPvAPdqgPo) - 75-minute deep dive on why Ralph works — context windows, control loops, and applications.\n- [Matt Pocock's Ralph Overview](https:\u002F\u002Fwww.youtube.com\u002Fwatch?v=_IK18goX4X8) - Popular practical overview grounded in kanban and requirements discovery.\n\n### Podcasts\n\n- [Inventing the Ralph Wiggum Loop - Dev Interrupted](https:\u002F\u002Flinearb.io\u002Fdev-interrupted\u002Fpodcast\u002Finventing-the-ralph-wiggum-loop) - Geoffrey Huntley on context rot, compaction, and the $10.42\u002Fhour calculation.\n- [Inventing the Ralph Wiggum Loop (Transcript)](https:\u002F\u002Fdevinterrupted.substack.com\u002Fp\u002Finventing-the-ralph-wiggum-loop-creator) - Full transcript of the Dev Interrupted episode.\n- [Ralph Wiggum Coding Agent Power Tools - BoundaryML](https:\u002F\u002Fboundaryml.com\u002Fpodcast\u002F2025-10-28-ralph-wiggum-coding-agent-power-tools) - Deep dive into tooling and advanced techniques.\n- [Ralph Wiggum AI Agent Explained - Startup Ideas Podcast](https:\u002F\u002Fwww.podscan.fm\u002Fpodcasts\u002Fthe-startup-ideas-podcast\u002Fepisodes\u002Fralph-wiggum-ai-agent-explained-amp-how-to-use-it) - Accessible introduction for founders and builders.\n\n## Community\n\n### Hacker News Discussions\n\n- [We Put a Coding Agent in a While Loop](https:\u002F\u002Fnews.ycombinator.com\u002Fitem?id=45005434) - Geoffrey Huntley participated; security concerns raised about default passwords.\n- [Ralph Wiggum as a Software Engineer](https:\u002F\u002Fnews.ycombinator.com\u002Fitem?id=43817200) - Code quality critiques and maintainability debates.\n- [Original HN Discussion](https:\u002F\u002Fnews.ycombinator.com\u002Fitem?id=44565028) - The discussion that helped popularize the technique.\n- [Tips Discussion](https:\u002F\u002Fnews.ycombinator.com\u002Fitem?id=46547129) - Community tips and experiences thread.\n- [Ralph from First Principles (Video)](https:\u002F\u002Fnews.ycombinator.com\u002Fitem?id=46587275) - Discussion around educational video content.\n- [What Happens After Ralph Wiggum?](https:\u002F\u002Fnews.ycombinator.com\u002Fitem?id=46632445) - Exploring the future of autonomous coding patterns.\n\n### Tools & Directories\n\n- [Vibe Coding - Ralph Wiggum Loop](https:\u002F\u002Fvibecoding.app\u002Ftools\u002Fralph-wiggum-loop) - Tool directory entry with quick-start resources.\n\n### Ralph Communities\n\n- [r\u002Fralphcoding](https:\u002F\u002Fwww.reddit.com\u002Fr\u002FRalphCoding\u002F) - A subreddit about Ralph Coding. Share your learnings, resources, achievements with the community.\n- [Ralph Discord](https:\u002F\u002Fdiscord.gg\u002FMUyRMqKcWx) - Discord community discussing Ralph methods\u002Fresources\u002Fachievements.\n\n## Related Tools\n\n- [Advanced Context Engineering for Coding Agents](https:\u002F\u002Fgithub.com\u002Fhumanlayer\u002Fadvanced-context-engineering-for-coding-agents) - Techniques for optimizing context windows and prompts for autonomous agents.\n\n## Support\n\nIf this list helped you discover useful Ralph resources, please give it a ⭐️ star! It helps others find this collection.\n\n[![Stargazers repo roster for @snwfdhmp\u002Fawesome-ralph](https:\u002F\u002Freporoster.com\u002Fstars\u002Fsnwfdhmp\u002Fawesome-ralph)](https:\u002F\u002Fgithub.com\u002Fsnwfdhmp\u002Fawesome-ralph\u002Fstargazers)\n\n## Contributing\n\nContributions welcome! Please read the [contribution guidelines](CONTRIBUTING.md) first.\n\nJoin the community on [Discord](https:\u002F\u002Fdiscord.gg\u002FMUyRMqKcWx) and [Reddit](https:\u002F\u002Fwww.reddit.com\u002Fr\u002FRalphCoding\u002F)\n","\u003Cp align=\"center\">\n  \u003Ca href=\"https:\u002F\u002Fwww.reddit.com\u002Fr\u002FRalphCoding\u002F\">\n\u003Cimg src=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Fsnwfdhmp_awesome-ralph_readme_506224b87390.png\" width=\"1000\" alt=\"Ralph Wiggum AI编码方法\">\n  \u003C\u002Fa>\n\u003C\u002Fp>\n\n\n# Awesome Ralph [![Awesome](https:\u002F\u002Fawesome.re\u002Fbadge.svg)](https:\u002F\u002Fawesome.re) [![在X上关注](https:\u002F\u002Fimg.shields.io\u002Ftwitter\u002Ffollow\u002Fsnwfdhmp?style=social)](https:\u002F\u002Fx.com\u002Fsnwfdhmp)\n\n> 关于Ralph（即Ralph Wiggum）的精选资源列表，这是一种AI编码技术，通过自动化循环运行AI编码代理，直到满足规范要求。\n\nRalph是由[Geoffrey Huntley](https:\u002F\u002Fghuntley.com)提出的一种用于自主AI编码的技术。其核心概念非常简洁：\n\n```bash\nwhile :; do cat PROMPT.md | claude-code ; done\n```\n\n**关键原则：**\n- 不断重复运行AI代理，直到PRD或规格说明完成\n- 进展保存在文件和Git历史中，而非上下文中\n- 每次迭代都从干净的上下文开始\n- 使用“反压”（如测试、代码检查、类型检查）来验证工作成果\n- 哲学理念：“坐在循环之外，而不是其中”——或者正如Huntley所说：“在一个不确定的世界里，以确定的方式犯错”\n\n> **觉得有用吗？⭐️ 给这个仓库点个赞，帮助更多人发现它**\n\n## 目录\n\n- [官方资源](#official-resources)\n- [操作手册与方法论](#playbooks--methodology)\n- [实现方案](#implementations)\n  - [Claude Code插件](#claude-code-plugins)\n  - [独立实现](#standalone-implementations)\n  - [特定工具的实现](#tool-specific-implementations)\n  - [多智能体系统](#multi-agent-systems)\n- [教程与指南](#tutorials--guides)\n- [文章与博客](#articles--blog-posts)\n- [视频与播客](#videos--podcasts)\n  - [视频](#videos)\n  - [播客](#podcasts)\n- [社区](#community)\n  - [Hacker News讨论](#hacker-news-discussions)\n  - [工具与目录](#tools--directories)\n  - [Ralph社区](#ralph-communities)\n- [相关工具](#related-tools)\n- [支持](#support)\n- [贡献](#contributing)\n\n## 官方资源\n\n来自Ralph技术创造者Geoffrey Huntley的主要资料。\n\n- [Ralph Wiggum作为“软件工程师”](https:\u002F\u002Fghuntley.com\u002Fralph\u002F) - 最权威的入门介绍。解释了Bash循环、“像调吉他一样调优”的比喻，以及自主编码的经济学原理。\n- [一切都是Ralph循环](https:\u002F\u002Fghuntley.com\u002Floop\u002F) - 更深层次的哲学探讨，涵盖“逆向模式”的洁净室处理、编排模式以及“编织机”概念。\n- [别浪费你的反压](https:\u002F\u002Fghuntley.com\u002Fpressure\u002F) - 关于反压的技术深度解析——如何在不产生过多阻力的情况下拒绝无效生成。\n- [我让Claude连续运行了三个月](https:\u002F\u002Fghuntley.com\u002Fcursed\u002F) - 案例研究：Ralph构建了CURSED，一种基于Z世代俚语的编程语言，并配有LLVM编译器。\n- [模型上下文协议服务器太多了](https:\u002F\u002Fghuntley.com\u002Fallocations\u002F) - 上下文分配理论——Ralph尽量减少分配，以避免压缩事件的发生。\n\n## 操作手册与方法论\n\n全面的实施指南，涵盖“3个阶段、2个提示、1个循环”的工作流程。\n\n- [如何使用Ralph Wiggum](https:\u002F\u002Fgithub.com\u002Fghuntley\u002Fhow-to-ralph-wiggum) - Geoffrey Huntley的官方操作手册，内容包括上下文管理、沙箱环境以及提示模板。\n- [ralph-playbook](https:\u002F\u002Fgithub.com\u002FClaytonFarr\u002Fralph-playbook) - 详尽的方法论指南，配有图表、各阶段说明以及“标志与门控”引导技巧。\n\n### 核心工作流程\n\n**第1阶段：定义需求** — 人类与LLM对话生成符合JTBD的规格说明  \n**第2阶段：规划模式** — 差距分析生成优先级待办事项清单（不涉及具体实现）  \n**第3阶段：构建模式** — 根据计划进行实现，运行测试，提交代码，循环往复  \n\n### 必要的文件结构\n\n```\nproject-root\u002F\n├── loop.sh                    # Ralph循环脚本\n├── PROMPT_build.md            # 构建模式指令\n├── PROMPT_plan.md             # 规划模式指令\n├── AGENTS.md                  # 操作指南（不超过60行）\n├── IMPLEMENTATION_PLAN.md     # 优先级任务列表（由系统生成）\n├── specs\u002F                     # 需求规格（每个JTBD对应一份）\n└── src\u002F                       # 应用程序源代码\n```\n\n## 实现方案\n\n### Claude Code插件\n\n- [ralph-claude-code](https:\u002F\u002Fgithub.com\u002Ffrankbria\u002Fralph-claude-code) - Claude Code结合智能退出检测、速率限制、熔断机制和语义响应分析器。\n- [choo-choo-ralph](https:\u002F\u002Fgithub.com\u002Fmj-meyer\u002Fchoo-choo-ralph) - 基于珠子的工作流，包含5个阶段，结构化的规格说明、经过验证的实现以及知识的累积——按项目安装，可完全自定义工作流。\n\n### 独立实现\n\n- [ralph-starter](https:\u002F\u002Fgithub.com\u002Frubenmarcus\u002Fralph-starter) - CLI工具，集成GitHub、Linear和Notion；支持多代理、交互式向导、预设工作流及成本跟踪。\n- [snartank\u002Fralph](https:\u002F\u002Fgithub.com\u002Fsnarktank\u002Fralph) - 基于PRD的任务管理工具，具备自动分支、流程图可视化和自动归档功能。\n- [iannuttall\u002Fralph](https:\u002F\u002Fgithub.com\u002Fiannuttall\u002Fralph) - 极简的基于文件的代理循环，支持Codex\u002FClaude\u002FDroid\u002FOpenCode等模型。\n- [smart-ralph](https:\u002F\u002Fgithub.com\u002Ftzachbon\u002Fsmart-ralph) - 基于规格驱动的开发工作流。将功能请求转化为结构化的规格说明（调研、需求、设计、任务），然后逐项自主执行。\n- [ralph-wiggum-bdd](https:\u002F\u002Fgithub.com\u002Fmarcindulak\u002Fralph-wiggum-bdd) - 一个独立的Bash脚本，用于行为驱动开发，结合Ralph Wiggum循环。\n- [ralph-orchestrator](https:\u002F\u002Fgithub.com\u002Fmikeyobrien\u002Fralph-orchestrator) - Rust编排工具，内置7个AI后端、专长角色的Hat System，以及交互式TUI模式。\n- [nitodeco\u002Fralph](https:\u002F\u002Fgithub.com\u002Fnitodeco\u002Fralph) - CLI编排工具，用于基于PRD的开发，支持顺序执行任务和交互式终端界面。\n- [pentoai\u002Fml-ralph](https:\u002F\u002Fgithub.com\u002Fpentoai\u002Fml-ralph) - 自主ML代理，可用于运行Claude或Codex实验。\n- [oh-my-ralph](https:\u002F\u002Fgithub.com\u002Fvivganes\u002Foh-my-ralph) - 采用Python实现的意见型Ralph Wiggum循环。\n\n### 工具特定实现\n\n- [ralph-wiggum-cursor](https:\u002F\u002Fgithub.com\u002Fagrimsingh\u002Fralph-wiggum-cursor) - 具有令牌跟踪、8万令牌上下文轮转以及交互式设置的光标实现。\n- [opencode-ralph-wiggum](https:\u002F\u002Fgithub.com\u002FTh0rgal\u002Fopencode-ralph-wiggum) - OpenCode 实现，具备实时状态显示、循环中段上下文注入和挣扎检测功能。\n- [ralph (GitHub Copilot)](https:\u002F\u002Fgithub.com\u002Faymenfurter\u002Fralph) - VS Code 扩展，包含可视化控制面板、进度时间轴和全新聊天模式。\n- [ralph-tui](https:\u002F\u002Fgithub.com\u002Fsubsy\u002Fralph-tui) - 终端 UI 协调器，可连接到任务跟踪工具，并支持交互式 PRD 创建。\n- [Goose Ralph Loop 教程](https:\u002F\u002Fblock.github.io\u002Fgoose\u002Fdocs\u002Ftutorials\u002Fralph-loop\u002F) - Block 的 Goose 实现，结合跨模型评审和基于配方的工作流。\n\n### 多智能体系统\n\n- [ralph-loop-agent](https:\u002F\u002Fgithub.com\u002Fvercel-labs\u002Fralph-loop-agent) - Vercel 的 TypeScript SDK 封装，提供验证回调和上下文摘要功能。\n- [multi-agent-ralph-loop](https:\u002F\u002Fgithub.com\u002Falfredolopez80\u002Fmulti-agent-ralph-loop) - 用于需要并行工作流的复杂项目的多智能体编排。\n\n## 教程与指南\n\n- [Ralph 入门](https:\u002F\u002Fwww.aihero.dev\u002Fgetting-started-with-ralph) - Matt Pocock 提供的逐步快速入门指南，结合 Claude Code 和 Docker。\n- [使用 Ralph Wiggum 进行 AI 编码的 11 条技巧](https:\u002F\u002Fwww.aihero.dev\u002Ftips-for-ai-coding-with-ralph-wiggum) - 包括离线编码、HITL Ralph、迭代上限和进度跟踪等内容。\n- [Ralph Wiggum 方法](https:\u002F\u002Fdev.to\u002Fsivarampg\u002Fthe-ralph-wiggum-approach-running-ai-coding-agents-for-hours-not-minutes-57c1) - 涵盖停止钩子机制、故障排除及问答环节。\n- [真正的 Ralph Wiggum 循环](https:\u002F\u002Fthetrav.substack.com\u002Fp\u002Fthe-real-ralph-wiggum-loop-what-everyone) - 阐明了原始 Bash 循环与 Anthropic 插件理念之间的区别。\n- [Ralph Wiggum 指南](https:\u002F\u002Fgithub.com\u002FJeredBlu\u002Fguides\u002Fblob\u002Fmain\u002FRalph_Wiggum_Guide.md) - 社区撰写的综合指南。\n- [Awesome Claude - Ralph Wiggum](https:\u002F\u002Fawesomeclaude.ai\u002Fralph-wiggum) - 资源页面，提供更多技巧和配置示例。\n- [如何在 7 分钟内构建一个高效的长期运行智能体循环](https:\u002F\u002Fx.com\u002Fdabit3\u002Fstatus\u002F2013091003104727338?s=20) - 从创建规格说明、构建和完善 PRD，再到使用 Claude Code、Codex 和 OpenCode 等框架运行智能体，全程指导。\n\n## 文章与博客\n\n- [Ralph Wiggum 如何从《辛普森一家》成为 AI 界最大牌] (https:\u002F\u002Fventurebeat.com\u002Ftechnology\u002Fhow-ralph-wiggum-went-from-the-simpsons-to-the-biggest-name-in-ai-right-now) - VentureBeat 对这一文化现象的报道。\n- [Ralph 简史](https:\u002F\u002Fwww.humanlayer.dev\u002Fblog\u002Fbrief-history-of-ralph) - 包含 Y Combinator 黑客松故事的完整时间线。\n- [Ralph Wiggum 与 AI 编码循环](https:\u002F\u002Fwww.ishir.com\u002Fblog\u002F312751\u002Fralph-wiggum-and-ai-coding-loops-from-springfield-to-real-world-software-automation.htm) - 从春田镇到现实世界的软件自动化。\n- [Ralph Wiggum 解析：持续运行的 Claude Code 循环](https:\u002F\u002Fblog.devgenius.io\u002Fralph-wiggum-explained-the-claude-code-loop-that-keeps-going-3250dcc30809) - 技术性解释其运作原理及原因。\n- [2026 年：Ralph 循环智能体之年](https:\u002F\u002Fdev.to\u002Falexandergekov\u002F2026-the-year-of-the-ralph-loop-agent-1gkj) - 关于 Ralph 循环对开发影响的预测与分析。\n\n## 视频与播客\n\n### 视频\n\n- [Geoffrey Huntley 深入解读 Ralph Wiggum](https:\u002F\u002Fwww.youtube.com\u002Fwatch?v=SB6cO97tfiY) - 经典视频。现场编码演示、历史回顾，以及 Bash 循环与停止钩子实现的对比。\n- [AI That Works 播客节目](https:\u002F\u002Fwww.youtube.com\u002Fwatch?v=fOPvAPdqgPo) - 75 分钟深度探讨 Ralph 为何有效——上下文窗口、控制循环及其应用。\n- [Matt Pocock 的 Ralph 概览](https:\u002F\u002Fwww.youtube.com\u002Fwatch?v=_IK18goX4X8) - 基于看板和需求发现的实用概述。\n\n### 播客\n\n- [发明 Ralph Wiggum 循环 - Dev Interrupted](https:\u002F\u002Flinearb.io\u002Fdev-interrupted\u002Fpodcast\u002Finventing-the-ralph-wiggum-loop) - Geoffrey Huntley 讲述上下文衰减、压缩以及每小时 10.42 美元的计算。\n- [发明 Ralph Wiggum 循环（文字稿）](https:\u002F\u002Fdevinterrupted.substack.com\u002Fp\u002Finventing-the-ralph-wiggum-loop-creator) - Dev Interrupted 节目的完整文字稿。\n- [Ralph Wiggum 编码智能体高级工具 - BoundaryML](https:\u002F\u002Fboundaryml.com\u002Fpodcast\u002F2025-10-28-ralph-wiggum-coding-agent-power-tools) - 深入探讨工具链和高级技术。\n- [Ralph Wiggum AI 智能体解析 - Startup Ideas 播客](https:\u002F\u002Fwww.podscan.fm\u002Fpodcasts\u002Fthe-startup-ideas-podcast\u002Fepisodes\u002Fralph-wiggum-ai-agent-explained-amp-how-to-use-it) - 面向创始人和开发者的易懂介绍。\n\n## 社区\n\n### Hacker News 讨论\n\n- [我们把一个编码智能体放进了一个 while 循环里](https:\u002F\u002Fnews.ycombinator.com\u002Fitem?id=45005434) - Geoffrey Huntley 参与讨论；默认密码的安全问题被提出。\n- [Ralph Wiggum 作为软件工程师](https:\u002F\u002Fnews.ycombinator.com\u002Fitem?id=43817200) - 关于代码质量和可维护性的批评与辩论。\n- [最初的 HN 讨论](https:\u002F\u002Fnews.ycombinator.com\u002Fitem?id=44565028) - 推动该技术普及的讨论。\n- [技巧讨论](https:\u002F\u002Fnews.ycombinator.com\u002Fitem?id=46547129) - 社区分享技巧和经验的主题帖。\n- [从第一性原理出发的 Ralph（视频）](https:\u002F\u002Fnews.ycombinator.com\u002Fitem?id=46587275) - 围绕教育视频内容的讨论。\n- [Ralph Wiggum 之后会怎样？](https:\u002F\u002Fnews.ycombinator.com\u002Fitem?id=46632445) - 探讨自主编码模式的未来。\n\n### 工具与目录\n\n- [Vibe Coding - Ralph Wiggum 循环](https:\u002F\u002Fvibecoding.app\u002Ftools\u002Fralph-wiggum-loop) - 工具目录条目，附带快速入门资源。\n\n### Ralph 社区\n\n- [r\u002Fralphcoding](https:\u002F\u002Fwww.reddit.com\u002Fr\u002FRalphCoding\u002F) - 一个关于 Ralph 编码的 subreddit。与社区分享你的学习心得、资源和成就。\n- [Ralph Discord](https:\u002F\u002Fdiscord.gg\u002FMUyRMqKcWx) - Discord 社区，讨论 Ralph 方法、资源和成就。\n\n## 相关工具\n\n- [面向编码智能体的高级上下文工程](https:\u002F\u002Fgithub.com\u002Fhumanlayer\u002Fadvanced-context-engineering-for-coding-agents) - 用于优化自主智能体上下文窗口和提示的技术。\n\n## 支持\n\n如果这份列表帮助你发现了有用的 Ralph 资源，请为它点个赞！这有助于其他人找到这个合集。\n\n[![@snwfdhmp\u002Fawesome-ralph 的星标人数罗列](https:\u002F\u002Freporoster.com\u002Fstars\u002Fsnwfdhmp\u002Fawesome-ralph)](https:\u002F\u002Fgithub.com\u002Fsnwfdhmp\u002Fawesome-ralph\u002Fstargazers)\n\n## 贡献\n\n欢迎贡献！请先阅读 [贡献指南](CONTRIBUTING.md)。\n\n加入 [Discord](https:\u002F\u002Fdiscord.gg\u002FMUyRMqKcWx) 和 [Reddit](https:\u002F\u002Fwww.reddit.com\u002Fr\u002FRalphCoding\u002F) 社区。","# Awesome Ralph 快速上手指南\n\nRalph（又名 Ralph Wiggum）是一种自主 AI 编码技术，其核心理念是将 AI 代理置于自动化循环中运行，直到满足规格说明。它强调“坐在循环外，而非循环内”，通过文件系统和 Git 历史持久化进度，每次迭代都使用干净的上下文重新启动。\n\n## 环境准备\n\n在开始之前，请确保你的开发环境满足以下要求：\n\n*   **操作系统**: Linux, macOS 或 Windows (WSL2 推荐)。\n*   **核心依赖**:\n    *   `bash` 或 `zsh` shell 环境。\n    *   **Git**: 用于版本控制和进度持久化。\n    *   **Node.js** (可选但推荐): 如果你计划使用 `claude-code` CLI 或其他基于 JS 的实现。\n*   **AI 代理工具**:\n    *   必须拥有 **Claude Code** (`claude-code`) 的访问权限及有效的 API Key。\n    *   或者配置好其他支持的代理工具（如 Codex, OpenCode 等）。\n*   **项目规范**: 准备好你的需求文档 (`PRD.md` 或 `specs\u002F` 目录)，Ralph 需要明确的输入才能工作。\n\n> **注意**: Ralph 本身不是一个单一的安装包，而是一种**方法论**。你可以选择手动编写脚本，或使用社区实现的工具。\n\n## 安装步骤\n\n你可以选择“原生极简模式”或“社区增强模式”。\n\n### 方案 A：原生极简模式（推荐初学者理解原理）\n\n无需安装额外软件，只需创建一个脚本文件。\n\n1.  在项目根目录下创建名为 `loop.sh` 的文件。\n2.  写入以下核心逻辑代码：\n\n```bash\n#!\u002Fbin\u002Fbash\n# loop.sh - The core Ralph Loop\n\nwhile :; do\n  echo \"🔄 Starting Ralph iteration...\"\n  # 将提示词文件传递给 AI 代理\n  # 请根据实际使用的代理命令调整下方指令\n  cat PROMPT.md | claude-code \n  \n  # 可选：在此处添加“背压”检查（测试、Lint、类型检查）\n  # 如果检查失败，循环将继续；如果成功，可手动中断或添加退出逻辑\n  echo \"✅ Iteration complete. Review changes and commit if necessary.\"\ndone\n```\n\n3.  赋予执行权限：\n\n```bash\nchmod +x loop.sh\n```\n\n### 方案 B：使用社区实现（功能更丰富）\n\n如果你需要自动退出检测、速率限制或多代理编排，可以使用成熟的开源实现。以 `ralph-starter` 为例：\n\n```bash\n# 克隆项目\ngit clone https:\u002F\u002Fgithub.com\u002Frubenmarcus\u002Fralph-starter.git\ncd ralph-starter\n\n# 安装依赖 (需预先安装 Node.js)\nnpm install\n\n# 按照向导进行初始化配置\nnpm run init\n```\n\n## 基本使用\n\n以下是基于**原生极简模式**的最简工作流程，遵循 **\"3 阶段、2 提示词、1 循环”** 的方法论。\n\n### 1. 定义需求 (Phase 1)\n\n在项目根目录创建 `specs\u002F` 文件夹，并编写具体的需求文档。同时创建主提示词文件 `PROMPT.md`。\n\n**文件结构示例：**\n```text\nproject-root\u002F\n├── loop.sh\n├── PROMPT.md            # 主指令入口\n├── specs\u002F\n│   └── feature-login.md # 具体需求\n└── src\u002F                 # 代码输出目录\n```\n\n**PROMPT.md 内容示例：**\n```markdown\n# Role\nYou are an autonomous coding agent using the Ralph technique.\n\n# Context\nReview the specifications in .\u002Fspecs\u002F directory.\nCheck existing code in .\u002Fsrc\u002F.\n\n# Instructions\n1. Analyze the gap between current implementation and specs.\n2. Implement the necessary changes to fulfill the requirements.\n3. Run tests if available.\n4. Stop when the task is logically complete or blocked.\n\n# Constraints\n- Do not hallucinate files.\n- Keep changes minimal and focused.\n- If you encounter errors, fix them in the next iteration.\n```\n\n### 2. 规划模式 (Phase 2 - 可选但推荐)\n\n在正式编码前，可以先让 AI 生成一个任务列表。修改 `PROMPT.md` 要求 AI 仅输出 `IMPLEMENTATION_PLAN.md` 而不写代码，或者直接运行一次循环生成计划。\n\n### 3. 构建模式 (Phase 3)\n\n启动循环，让 AI 开始工作。\n\n```bash\n# 在终端运行\n.\u002Floop.sh\n```\n\n**运行过程说明：**\n1.  AI 读取 `PROMPT.md` 和当前代码状态。\n2.  AI 生成代码修改、运行测试（如果在提示词中配置了测试命令）。\n3.  循环结束，回到起点。\n4.  **人工介入**: 检查 Git 变更 (`git diff`)。如果满意，提交代码 (`git add . && git commit -m \"Ralph iteration\"`); 如果不满意，调整 `PROMPT.md` 或修复测试用例（背压），然后继续运行循环。\n\n### 关键原则：背压 (Backpressure)\n\nRalph 的核心在于利用测试、Linter 或类型检查作为“背压”来验证工作。不要让 AI 在无限制的上下文中无限运行。\n\n**进阶用法示例（带简单背压）：**\n\n```bash\n#!\u002Fbin\u002Fbash\nwhile :; do\n  cat PROMPT.md | claude-code\n  \n  # 背压检查：如果测试失败，循环继续；如果成功，打印消息但不自动退出（由人决定）\n  npm test \n  if [ $? -ne 0 ]; then\n    echo \"❌ Tests failed. Feeding errors back to context for next iteration...\"\n    # 错误日志会自动成为下一次对话的上下文（如果是交互式 shell）\n    # 或者你可以将错误日志追加到 PROMPT.md 中\n  else\n    echo \"✅ All tests passed!\"\n  fi\n  \n  sleep 2\ndone\n```\n\n通过这种方式，Ralph 能够在一个不确定的世界中，以“确定性的糟糕”（即不断试错）方式逐步逼近完美的代码实现。","某初创团队需要在三天内从零构建一个具备完整测试覆盖的 Python 数据分析微服务，但资深后端工程师人手紧缺。\n\n### 没有 awesome-ralph 时\n- **上下文过载导致效率低下**：开发者需手动在对话中反复粘贴代码和错误日志，LLM 因上下文窗口限制频繁“遗忘”早期需求，导致重复劳动。\n- **调试循环断裂**：每次修复报错后，人工重新描述问题耗时耗力，难以形成“编码 - 测试 - 修复”的自动化闭环，进度严重受阻。\n- **规范执行不一致**：缺乏强制的反馈机制，AI 生成的代码常忽略类型检查或单元测试要求，人工审查成本极高。\n- **迭代状态难追踪**：修改过程依赖零散的聊天记录，缺乏基于 Git 的持久化进度保存，一旦中断很难快速恢复现场。\n\n### 使用 awesome-ralph 后\n- **无限循环自动推进**：通过 `while` 脚本让 AI 代理在后台持续运行，每次迭代自动读取最新代码库，无需人工维护长上下文，实现“坐看循环”而非“困在循环”。\n- **背压机制确保质量**：利用测试失败、Lint 报错作为“背压”信号，自动触发下一轮修复，直到所有规格说明书（PRD）要求被满足且测试全绿。\n- **纯净上下文启动**：每一轮生成都是基于文件系统和 Git 历史的全新开始，避免了上下文污染，确保 AI 始终聚焦于当前待解决的特定错误。\n- **原子化进度持久化**：每一次成功的修正都自动提交为 Git 记录，项目演进路径清晰可查，随时可回滚或审计，完美契合三人两提示词的标准化工作流。\n\nawesome-ralph 将不确定的 AI 生成过程转化为确定性的工程交付流，让开发者从繁琐的调试循环中解放出来，专注于架构设计与需求定义。","https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Fsnwfdhmp_awesome-ralph_506224b8.jpg","snwfdhmp","Martin","https:\u002F\u002Foss.gittoolsai.com\u002Favatars\u002Fsnwfdhmp_6c3385d2.png",null,"Reach out to me for projects","France","cv.snwfdhmp.com","https:\u002F\u002Fgithub.com\u002Fsnwfdhmp",856,63,"2026-04-20T00:40:20","Linux, macOS, Windows","未说明",{"notes":88,"python":86,"dependencies":89},"Awesome Ralph 本身是一个资源列表而非单一软件工具，因此没有统一的运行环境需求。其核心概念是运行一个简单的 Bash 循环脚本（while 循环）来调用 AI 编码代理（如 Claude Code）。具体环境需求取决于用户选择的特定实现工具（如基于 Rust、Python 或 Node.js 的不同版本），但核心方法主要依赖 Shell 环境和 Git。部分实现可能需要 Docker 或特定的包管理器。",[90,91,92,93],"bash\u002Fshell","git","Claude Code (或兼容的 AI 编码代理)","Node.js (针对部分 TypeScript 实现)",[36,13],[96,97,98,99,100,101,102],"ai-coding","ralph","ralph-loop","ralph-wiggum","vibe-coding","claude","claude-code","2026-03-27T02:49:30.150509","2026-04-20T16:49:32.274818",[],[]]