[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"similar-obie--claude-on-rails":3,"tool-obie--claude-on-rails":62},[4,18,26,36,46,54],{"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":10,"last_commit_at":24,"category_tags":25,"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":27,"name":28,"github_repo":29,"description_zh":30,"stars":31,"difficulty_score":32,"last_commit_at":33,"category_tags":34,"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 真正成长为懂上",160015,2,"2026-04-18T11:30:52",[14,13,35],"语言模型",{"id":37,"name":38,"github_repo":39,"description_zh":40,"stars":41,"difficulty_score":42,"last_commit_at":43,"category_tags":44,"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,45],"插件",{"id":47,"name":48,"github_repo":49,"description_zh":50,"stars":51,"difficulty_score":32,"last_commit_at":52,"category_tags":53,"status":17},2271,"ComfyUI","Comfy-Org\u002FComfyUI","ComfyUI 是一款功能强大且高度模块化的视觉 AI 引擎，专为设计和执行复杂的 Stable Diffusion 图像生成流程而打造。它摒弃了传统的代码编写模式，采用直观的节点式流程图界面，让用户通过连接不同的功能模块即可构建个性化的生成管线。\n\n这一设计巧妙解决了高级 AI 绘图工作流配置复杂、灵活性不足的痛点。用户无需具备编程背景，也能自由组合模型、调整参数并实时预览效果，轻松实现从基础文生图到多步骤高清修复等各类复杂任务。ComfyUI 拥有极佳的兼容性，不仅支持 Windows、macOS 和 Linux 全平台，还广泛适配 NVIDIA、AMD、Intel 及苹果 Silicon 等多种硬件架构，并率先支持 SDXL、Flux、SD3 等前沿模型。\n\n无论是希望深入探索算法潜力的研究人员和开发者，还是追求极致创作自由度的设计师与资深 AI 绘画爱好者，ComfyUI 都能提供强大的支持。其独特的模块化架构允许社区不断扩展新功能，使其成为当前最灵活、生态最丰富的开源扩散模型工具之一，帮助用户将创意高效转化为现实。",109154,"2026-04-18T11:18:24",[14,15,13],{"id":55,"name":56,"github_repo":57,"description_zh":58,"stars":59,"difficulty_score":32,"last_commit_at":60,"category_tags":61,"status":17},6121,"gemini-cli","google-gemini\u002Fgemini-cli","gemini-cli 是一款由谷歌推出的开源 AI 命令行工具，它将强大的 Gemini 大模型能力直接集成到用户的终端环境中。对于习惯在命令行工作的开发者而言，它提供了一条从输入提示词到获取模型响应的最短路径，无需切换窗口即可享受智能辅助。\n\n这款工具主要解决了开发过程中频繁上下文切换的痛点，让用户能在熟悉的终端界面内直接完成代码理解、生成、调试以及自动化运维任务。无论是查询大型代码库、根据草图生成应用，还是执行复杂的 Git 操作，gemini-cli 都能通过自然语言指令高效处理。\n\n它特别适合广大软件工程师、DevOps 人员及技术研究人员使用。其核心亮点包括支持高达 100 万 token 的超长上下文窗口，具备出色的逻辑推理能力；内置 Google 搜索、文件操作及 Shell 命令执行等实用工具；更独特的是，它支持 MCP（模型上下文协议），允许用户灵活扩展自定义集成，连接如图像生成等外部能力。此外，个人谷歌账号即可享受免费的额度支持，且项目基于 Apache 2.0 协议完全开源，是提升终端工作效率的理想助手。",100752,"2026-04-10T01:20:03",[45,13,15,14],{"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":80,"owner_twitter":74,"owner_website":81,"owner_url":82,"languages":83,"stars":92,"forks":93,"last_commit_at":94,"license":95,"difficulty_score":32,"env_os":96,"env_gpu":97,"env_ram":96,"env_deps":98,"category_tags":107,"github_topics":108,"view_count":32,"oss_zip_url":108,"oss_zip_packed_at":108,"status":17,"created_at":109,"updated_at":110,"faqs":111,"releases":127},9103,"obie\u002Fclaude-on-rails","claude-on-rails","A development framework for Ruby on Rails developers using Claude Code, inspired by SuperClaude","claude-on-rails 是一款专为 Ruby on Rails 开发者打造的智能开发框架。它基于 Claude Code 构建，灵感源自 SuperClaude，旨在通过自动化协作解决传统 AI 辅助开发中需要人工协调模型、控制器、视图及测试等多层代码的痛点。\n\n在传统模式下，开发者往往需要在不同文件间频繁切换上下文，并手动确保逻辑一致性与测试覆盖率。而 claude-on-rails 引入了“智能体群（Swarm）”概念，自动组建一支由架构师、数据库专家、前端工程师、测试专员等角色构成的虚拟开发团队。用户只需用自然语言描述需求（例如“添加带邮箱验证的用户登录”或“集成 Stripe 支付”），这些专用智能体便会自主分工协作，从数据库迁移到业务逻辑，再到界面渲染与单元测试，全流程遵循 Rails 最佳实践自动完成。\n\n该工具特别适合希望提升开发效率、减少重复性编码工作的 Rails 程序员。其核心技术亮点在于利用 claude-swarm  orchestration 机制，让多个 AI 智能体在各自专业领域内独立工作又紧密配合，无需人工干预即可实现复杂功能的全栈落地。只需简单","claude-on-rails 是一款专为 Ruby on Rails 开发者打造的智能开发框架。它基于 Claude Code 构建，灵感源自 SuperClaude，旨在通过自动化协作解决传统 AI 辅助开发中需要人工协调模型、控制器、视图及测试等多层代码的痛点。\n\n在传统模式下，开发者往往需要在不同文件间频繁切换上下文，并手动确保逻辑一致性与测试覆盖率。而 claude-on-rails 引入了“智能体群（Swarm）”概念，自动组建一支由架构师、数据库专家、前端工程师、测试专员等角色构成的虚拟开发团队。用户只需用自然语言描述需求（例如“添加带邮箱验证的用户登录”或“集成 Stripe 支付”），这些专用智能体便会自主分工协作，从数据库迁移到业务逻辑，再到界面渲染与单元测试，全流程遵循 Rails 最佳实践自动完成。\n\n该工具特别适合希望提升开发效率、减少重复性编码工作的 Rails 程序员。其核心技术亮点在于利用 claude-swarm  orchestration 机制，让多个 AI 智能体在各自专业领域内独立工作又紧密配合，无需人工干预即可实现复杂功能的全栈落地。只需简单配置并启动服务，开发者即可体验如同拥有真实专家团队般的高效开发流程。","# ClaudeOnRails\n\n[![Gem Version](https:\u002F\u002Fbadge.fury.io\u002Frb\u002Fclaude-on-rails.svg?cache_bust=0.1.4)](https:\u002F\u002Fbadge.fury.io\u002Frb\u002Fclaude-on-rails)\n[![CI](https:\u002F\u002Fgithub.com\u002Fobie\u002Fclaude-on-rails\u002Factions\u002Fworkflows\u002Fmain.yml\u002Fbadge.svg)](https:\u002F\u002Fgithub.com\u002Fobie\u002Fclaude-on-rails\u002Factions\u002Fworkflows\u002Fmain.yml)\n\n\nA Rails development framework that leverages [claude-swarm](https:\u002F\u002Fgithub.com\u002Fparruda\u002Fclaude-swarm) to create an intelligent team of AI agents specialized in different aspects of Rails development.\n\nInstead of managing personas manually, ClaudeOnRails automatically orchestrates a swarm of specialized agents that work together like a real development team. Simply describe what you want to build, and the swarm handles the rest.\n\n## How It Works\n\nClaudeOnRails creates a team of specialized AI agents:\n\n- **Architect**: Coordinates development and makes high-level decisions\n- **Models**: Handles ActiveRecord, migrations, and database design\n- **Controllers**: Manages routing and request handling\n- **Views**: Creates UI templates and manages assets\n- **Services**: Implements business logic and service objects\n- **Tests**: Ensures comprehensive test coverage\n- **DevOps**: Handles deployment and infrastructure\n\nEach agent works in their specific domain (directory) and can collaborate with other agents to implement complex features.\n\n## Installation\n\nAdd to your Rails application's Gemfile:\n\n```ruby\ngroup :development do\n  gem 'claude-on-rails'\nend\n```\n\nThen run:\n\n```bash\nbundle install\nrails generate claude_on_rails:swarm\n```\n\nDuring generation, you'll be offered to set up Rails MCP Server for enhanced documentation access. Simply press Y when prompted!\n\nThis will:\n- Analyze your Rails project structure\n- Optionally set up Rails MCP Server (recommended)\n- Generate a customized swarm configuration\n- Create agent-specific prompts\n- Set up your development environment\n\nFor detailed setup instructions, see [SETUP.md](.\u002FSETUP.md).\n\n## Usage\n\n### Start Your Development Swarm\n\n```bash\n# In your Rails project directory\nclaude-swarm\n```\n\n### Natural Language Development\n\nOnce the swarm is running, just describe what you want to build in the Claude interface:\n\n```\n> Add user authentication with email confirmation\n[The architect coordinates the implementation across all agents]\n\n> Create a shopping cart with Stripe payment integration\n[Complex features are automatically broken down and implemented]\n\n> Optimize the dashboard - it's loading too slowly\n[Performance improvements across the stack]\n\n> Build a RESTful API for our mobile app with JWT auth\n[API development with authentication]\n```\n\nThe swarm automatically:\n- Analyzes your request\n- Delegates to appropriate specialists\n- Implements across all layers (models, controllers, views, tests)\n- Follows Rails best practices\n- Ensures test coverage\n\n## How It's Different\n\n### Traditional Rails Development with AI\nWhen using AI assistants for Rails development, you typically need to:\n- Manually coordinate different aspects of implementation\n- Switch contexts between models, controllers, views, and tests\n- Ensure consistency across different parts of your application\n- Remember to implement tests, security, and performance considerations\n\n### ClaudeOnRails Approach\nWith ClaudeOnRails, you simply describe what you want in natural language:\n```\n> Create a user system with social login\n```\n\nThe swarm automatically:\n- Creates models with proper validations and associations\n- Implements controllers with authentication logic\n- Builds views with forms and UI components\n- Adds comprehensive test coverage\n- Handles security considerations\n- Optimizes database queries\n\nAll coordinated by specialized agents working together.\n\n## Project Structure\n\nAfter running the generator, you'll have:\n\n```\nyour-rails-app\u002F\n├── claude-swarm.yml             # Swarm configuration\n├── CLAUDE.md                    # Project-specific Claude config (imports context.md)\n└── .claude-on-rails\u002F\n    ├── context.md               # Rails project context imported by CLAUDE.md\n    └── prompts\u002F                 # Agent-specific prompts\n        ├── architect.md\n        ├── models.md\n        ├── controllers.md\n        └── ...\n```\n\n## Customization\n\n### Swarm Configuration\n\nThe generated `claude-swarm.yml` can be customized:\n\n```yaml\ninstances:\n  architect:\n    description: \"Your project-specific architect description\"\n    connections: [models, controllers, custom_agent]\n\n  custom_agent:\n    description: \"Specialized agent for your domain\"\n    directory: .\u002Fapp\u002Fcustom\n    prompt_file: .claude-on-rails\u002Fprompts\u002Fcustom.md\n```\n\n### Agent Prompts\n\nCustomize agent behavior by editing prompts in `.claude-on-rails\u002Fprompts\u002F`:\n- Add project-specific conventions\n- Include domain knowledge\n- Define coding standards\n\n## Features\n\n- **Automatic Agent Selection**: No need to choose which persona to use\n- **Collaborative Implementation**: Agents work together like a real team\n- **Rails-Aware**: Deep understanding of Rails conventions and best practices\n- **Project Adaptation**: Detects your project structure and adapts accordingly\n- **Test-Driven**: Automatic test generation for all code\n- **Performance Focus**: Built-in optimization capabilities\n\n## Enhanced Documentation with Rails MCP Server\n\nClaudeOnRails integrates with [Rails MCP Server](https:\u002F\u002Fgithub.com\u002Fmaquina-app\u002Frails-mcp-server) to provide your AI agents with real-time access to Rails documentation and best practices.\n\n### Benefits\n\n- **Up-to-date Documentation**: Agents access current Rails guides matching your version\n- **Framework Resources**: Includes Turbo, Stimulus, and Kamal documentation\n- **Consistent Standards**: All agents share the same documentation source\n- **Reduced Hallucination**: Agents verify patterns against official documentation\n\n### Automated Setup\n\nWhen you run `rails generate claude_on_rails:swarm`, you'll be prompted to set up Rails MCP Server automatically. Just press Y!\n\nIf you skipped it initially, you can set it up anytime:\n\n```bash\nbundle exec rake claude_on_rails:setup_mcp\n```\n\nThis interactive command will:\n- Install the Rails MCP Server gem\n- Configure your environment for enhanced documentation access\n\n### Check Status\n\nTo verify your Rails MCP Server installation:\n\n```bash\nbundle exec rake claude_on_rails:mcp_status\n```\n\n### How It Works\n\nWhen Rails MCP Server is available:\n- Each agent can query Rails documentation in real-time\n- Version-specific guidance ensures compatibility\n- Agents reference canonical implementations\n- Complex features follow official patterns\n\n## Requirements\n\n- Ruby 2.7+\n- Rails 6.0+\n- [claude-swarm](https:\u002F\u002Fgithub.com\u002Fparruda\u002Fclaude-swarm) gem (automatically installed as a dependency)\n- Claude Code CLI\n\n## Examples\n\nSee the [examples](.\u002Fexamples) directory for:\n- E-commerce platform development\n- API-only applications\n- Real-time features with Turbo\u002FStimulus\n- Performance optimization workflows\n\n## Contributing\n\nWe welcome contributions! Please see [CONTRIBUTING.md](.\u002FCONTRIBUTING.md) for guidelines.\n\n## License\n\nMIT License - see [LICENSE](.\u002FLICENSE) for details.\n\n## Acknowledgments\n\n- Powered by [claude-swarm](https:\u002F\u002Fgithub.com\u002Fparruda\u002Fclaude-swarm)\n- Built for [Claude Code](https:\u002F\u002Fgithub.com\u002Fanthropics\u002Fclaude-code)\n- Integrates with [Rails MCP Server](https:\u002F\u002Fgithub.com\u002Fmaquina-app\u002Frails-mcp-server)\n","# ClaudeOnRails\n\n[![Gem Version](https:\u002F\u002Fbadge.fury.io\u002Frb\u002Fclaude-on-rails.svg?cache_bust=0.1.4)](https:\u002F\u002Fbadge.fury.io\u002Frb\u002Fclaude-on-rails)\n[![CI](https:\u002F\u002Fgithub.com\u002Fobie\u002Fclaude-on-rails\u002Factions\u002Fworkflows\u002Fmain.yml\u002Fbadge.svg)](https:\u002F\u002Fgithub.com\u002Fobie\u002Fclaude-on-rails\u002Factions\u002Fworkflows\u002Fmain.yml)\n\n\n一个基于 Rails 的开发框架，利用 [claude-swarm](https:\u002F\u002Fgithub.com\u002Fparruda\u002Fclaude-swarm) 创建一支由专注于 Rails 开发不同方面的 AI 代理组成的智能团队。\n\n与手动管理角色不同，ClaudeOnRails 会自动编排一群专业化的代理，它们像真正的开发团队一样协同工作。你只需描述想要构建的内容，剩下的就交给这个团队来完成。\n\n## 工作原理\n\nClaudeOnRails 会创建一支由专业化 AI 代理组成的团队：\n\n- **架构师**：协调开发并做出高层次决策\n- **模型**：处理 ActiveRecord、迁移和数据库设计\n- **控制器**：管理路由和请求处理\n- **视图**：创建 UI 模板并管理资源文件\n- **服务层**：实现业务逻辑和服务对象\n- **测试**：确保全面的测试覆盖率\n- **DevOps**：负责部署和基础设施\n\n每个代理在其特定领域（目录）内工作，并能与其他代理协作以实现复杂功能。\n\n## 安装\n\n在你的 Rails 应用程序的 Gemfile 中添加：\n\n```ruby\ngroup :development do\n  gem 'claude-on-rails'\nend\n```\n\n然后运行：\n\n```bash\nbundle install\nrails generate claude_on_rails:swarm\n```\n\n在生成过程中，系统会提示你设置 Rails MCP Server，以便更好地访问文档。只需在提示时按 Y 键即可！\n\n这将：\n- 分析你的 Rails 项目结构\n- 可选地设置 Rails MCP Server（推荐）\n- 生成自定义的 swarm 配置\n- 创建针对各代理的提示\n- 设置你的开发环境\n\n有关详细安装说明，请参阅 [SETUP.md](.\u002FSETUP.md)。\n\n## 使用方法\n\n### 启动你的开发 swarm\n\n```bash\n# 在你的 Rails 项目目录下\nclaude-swarm\n```\n\n### 自然语言开发\n\n当 swarm 运行起来后，只需在 Claude 界面中描述你想构建的内容：\n\n```\n> 添加带有邮箱确认的用户认证功能\n[架构师协调所有代理共同实施]\n\n> 创建一个支持 Stripe 支付集成的购物车\n[复杂功能会被自动分解并实现]\n\n> 优化仪表盘——加载速度太慢了\n[全栈性能优化]\n\n> 为我们的移动应用构建一个带有 JWT 认证的 RESTful API\n[包含认证的 API 开发]\n```\n\nswarm 会自动：\n- 分析你的请求\n- 将任务分配给相应的专家\n- 在各个层次（模型、控制器、视图、测试）上实施\n- 遵循 Rails 最佳实践\n- 确保测试覆盖率\n\n## 不同之处\n\n### 传统的 Rails 开发与 AI 结合\n在使用 AI 助手进行 Rails 开发时，你通常需要：\n- 手动协调实现的不同方面\n- 在模型、控制器、视图和测试之间切换上下文\n- 确保应用程序各部分的一致性\n- 记得实现测试、安全性和性能方面的考虑\n\n### ClaudeOnRails 的方法\n使用 ClaudeOnRails 时，你只需用自然语言描述想要实现的内容：\n```\n> 创建一个支持社交登录的用户系统\n```\n\nswarm 会自动：\n- 创建带有适当验证和关联的模型\n- 实现带有认证逻辑的控制器\n- 构建包含表单和 UI 组件的视图\n- 添加全面的测试覆盖\n- 处理安全性相关问题\n- 优化数据库查询\n\n这一切都由专门的代理协同完成。\n\n## 项目结构\n\n运行生成器后，你会得到以下目录结构：\n\n```\nyour-rails-app\u002F\n├── claude-swarm.yml             # Swarm 配置文件\n├── CLAUDE.md                    # 项目特定的 Claude 配置文件（导入 context.md）\n└── .claude-on-rails\u002F\n    ├── context.md               # 由 CLAUDE.md 导入的 Rails 项目上下文\n    └── prompts\u002F                 # 代理专用的提示文件\n        ├── architect.md\n        ├── models.md\n        ├── controllers.md\n        └── ...\n```\n\n## 自定义\n\n### Swarm 配置\n\n生成的 `claude-swarm.yml` 文件可以自定义：\n\n```yaml\ninstances:\n  architect:\n    description: \"你项目特定的架构师描述\"\n    connections: [models, controllers, custom_agent]\n\n  custom_agent:\n    description: \"你领域内的专业代理\"\n    directory: .\u002Fapp\u002Fcustom\n    prompt_file: .claude-on-rails\u002Fprompts\u002Fcustom.md\n```\n\n### 代理提示\n\n通过编辑 `.claude-on-rails\u002Fprompts\u002F` 目录下的提示文件，可以自定义代理的行为：\n- 添加项目特定的约定\n- 包含领域知识\n- 定义编码标准\n\n## 特点\n\n- **自动代理选择**：无需选择使用哪个角色\n- **协作式实现**：代理像真正的团队一样协同工作\n- **熟悉 Rails**：深入理解 Rails 的约定和最佳实践\n- **适应项目**：检测你的项目结构并相应调整\n- **测试驱动**：为所有代码自动生成测试\n- **性能优先**：内置优化能力\n\n## 通过 Rails MCP Server 增强文档支持\n\nClaudeOnRails 与 [Rails MCP Server](https:\u002F\u002Fgithub.com\u002Fmaquina-app\u002Frails-mcp-server) 集成，为你的 AI 代理提供对 Rails 文档和最佳实践的实时访问。\n\n### 优势\n\n- **最新文档**：代理可以访问与你使用的 Rails 版本匹配的最新指南\n- **框架资源**：包括 Turbo、Stimulus 和 Kamal 的文档\n- **一致标准**：所有代理共享同一份文档来源\n- **减少幻觉**：代理会根据官方文档验证模式\n\n### 自动设置\n\n当你运行 `rails generate claude_on_rails:swarm` 时，系统会提示你自动设置 Rails MCP Server。只需按 Y 键即可！\n\n如果你一开始跳过了这一步，也可以随时设置：\n\n```bash\nbundle exec rake claude_on_rails:setup_mcp\n```\n\n这个交互式命令会：\n- 安装 Rails MCP Server gem\n- 配置你的环境，以便更好地访问文档\n\n### 检查状态\n\n要验证 Rails MCP Server 是否已正确安装：\n\n```bash\nbundle exec rake claude_on_rails:mcp_status\n```\n\n### 工作原理\n\n当 Rails MCP Server 可用时：\n- 每个代理都可以实时查询 Rails 文档\n- 版本特定的指导确保兼容性\n- 代理参考官方实现\n- 复杂功能遵循官方模式\n\n## 系统要求\n\n- Ruby 2.7+\n- Rails 6.0+\n- [claude-swarm](https:\u002F\u002Fgithub.com\u002Fparruda\u002Fclaude-swarm) gem（作为依赖项自动安装）\n- Claude Code CLI\n\n## 示例\n\n请查看 [examples](.\u002Fexamples) 目录中的示例，包括：\n- 电子商务平台开发\n- 仅 API 的应用程序\n- 使用 Turbo\u002FStimulus 的实时功能\n- 性能优化流程\n\n## 贡献\n\n我们欢迎贡献！请参阅 [CONTRIBUTING.md](.\u002FCONTRIBUTING.md) 以获取指南。\n\n## 许可证\n\nMIT 许可证 - 详情请参阅 [LICENSE](.\u002FLICENSE)。\n\n## 致谢\n\n- 由 [claude-swarm](https:\u002F\u002Fgithub.com\u002Fparruda\u002Fclaude-swarm) 提供支持\n- 专为 [Claude Code](https:\u002F\u002Fgithub.com\u002Fanthropics\u002Fclaude-code) 构建\n- 集成 [Rails MCP Server](https:\u002F\u002Fgithub.com\u002Fmaquina-app\u002Frails-mcp-server)","# ClaudeOnRails 快速上手指南\n\nClaudeOnRails 是一个基于 `claude-swarm` 的 Rails 开发框架，它能自动编排一组专业的 AI 智能体（如架构师、模型专家、控制器专家等），像真实开发团队一样协作完成你的需求。你只需用自然语言描述想要构建的功能，剩下的交给智能体集群处理。\n\n## 环境准备\n\n在开始之前，请确保你的开发环境满足以下要求：\n\n*   **Ruby**: 2.7 或更高版本\n*   **Rails**: 6.0 或更高版本\n*   **命令行工具**: 必须安装 [Claude Code CLI](https:\u002F\u002Fgithub.com\u002Fanthropics\u002Fclaude-code)\n*   **依赖项**: `claude-swarm` gem（安装过程中会自动作为依赖项安装）\n\n## 安装步骤\n\n### 1. 添加 Gem 依赖\n\n在你的 Rails 项目根目录下的 `Gemfile` 中，将 `claude-on-rails` 添加到 `:development` 组：\n\n```ruby\ngroup :development do\n  gem 'claude-on-rails'\nend\n```\n\n### 2. 安装依赖并生成配置\n\n运行以下命令安装 gem 并启动生成器：\n\n```bash\nbundle install\nrails generate claude_on_rails:swarm\n```\n\n### 3. 配置 Rails MCP Server（推荐）\n\n在运行生成器时，系统会提示你是否设置 **Rails MCP Server** 以增强文档访问能力（提供实时的 Rails 官方文档、Turbo\u002FStimulus 资源等，减少 AI 幻觉）。\n\n*   当出现提示时，直接输入 **Y** 确认。\n*   如果错过了提示，后续也可随时通过以下命令补全设置：\n    ```bash\n    bundle exec rake claude_on_rails:setup_mcp\n    ```\n\n此过程将自动分析你的项目结构、生成定制的集群配置文件 (`claude-swarm.yml`) 以及各智能体的专属提示词。\n\n## 基本使用\n\n### 1. 启动开发集群\n\n在项目根目录下运行以下命令启动 AI 智能体集群：\n\n```bash\nclaude-swarm\n```\n\n### 2. 自然语言开发\n\n集群启动后，直接在 Claude 界面中用自然语言描述你的需求。无需指定由哪个角色处理，系统会自动协调架构师、模型、控制器、视图、测试等智能体协同工作。\n\n**示例指令：**\n\n```text\n> Add user authentication with email confirmation\n```\n*(架构师将协调所有智能体实现带邮件确认的用户认证)*\n\n```text\n> Create a shopping cart with Stripe payment integration\n```\n*(复杂功能会被自动拆解并由相应领域的智能体实现)*\n\n```text\n> Optimize the dashboard - it's loading too slowly\n```\n*(全栈性能优化)*\n\n```text\n> Build a RESTful API for our mobile app with JWT auth\n```\n*(包含认证的 API 开发)*\n\n**集群将自动执行以下操作：**\n*   分析需求并分配给对应的专业智能体\n*   跨层级实现代码（Models, Controllers, Views, Tests）\n*   遵循 Rails 最佳实践\n*   自动生成测试用例以确保覆盖率","某初创团队的后端工程师需要在两天内为现有的 Ruby on Rails 电商项目紧急集成一套包含社交登录和订单管理的复杂功能模块。\n\n### 没有 claude-on-rails 时\n- **上下文切换频繁**：开发者需手动在模型、控制器、视图和测试文件间反复跳转，独自协调各层逻辑，极易遗漏关联修改。\n- **一致性难以保障**：人工拼凑 AI 生成的代码片段时，常出现命名风格不统一或业务逻辑与现有架构冲突的问题。\n- **测试覆盖不足**：在赶工期的压力下，往往优先实现功能而忽略单元测试，导致后续回归测试成本高昂。\n- **架构决策负担重**：开发者需同时扮演架构师和执行者，既要设计数据库关系又要编写具体 SQL 迁移，精力分散。\n\n### 使用 claude-on-rails 后\n- **智能分工协作**：只需输入“添加社交登录和订单系统”，Architect 代理自动拆解任务，并调度 Models、Controllers 等专用代理并行工作。\n- **全栈逻辑自洽**：各代理在各自领域（如数据库设计、路由配置）深度协作，确保生成的代码严格遵循 Rails 最佳实践且风格统一。\n- **测试同步生成**：Tests 代理实时跟进功能开发，自动编写涵盖边界条件的完整测试套件，确保交付即高质量。\n- **专注核心业务**：开发者从繁琐的样板代码和架构协调中解放，仅需通过自然语言描述需求，即可坐视 Swarm 团队完成全链路实现。\n\nclaude-on-rails 将单兵作战转化为多专家协同的自动化开发流，让开发者仅凭自然语言指令即可高效交付生产级 Rails 应用。","https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Fobie_claude-on-rails_bf1e9701.png","obie","Obie Fernandez","https:\u002F\u002Foss.gittoolsai.com\u002Favatars\u002Fobie_9f57da8f.jpg","Consultant, 30 year veteran of professional software development, serial entrepreneur, and best-selling author. CTO at ZAR","@zarpay ","Mexico City","obiefernandez@gmail.com","http:\u002F\u002Fobiefernandez.com","https:\u002F\u002Fgithub.com\u002Fobie",[84,88],{"name":85,"color":86,"percentage":87},"Ruby","#701516",79,{"name":89,"color":90,"percentage":91},"HTML","#e34c26",21,793,45,"2026-04-17T13:46:58","MIT","未说明","不需要 GPU",{"notes":99,"python":100,"dependencies":101},"该工具是一个基于 Ruby 的 Rails 开发框架，依赖 Claude Code CLI 和 claude-swarm gem。无需 GPU 或 Python 环境。建议在运行生成器时安装 Rails MCP Server 以获取实时文档支持。","不需要 Python",[102,103,104,105,106],"Ruby >= 2.7","Rails >= 6.0","claude-swarm","Claude Code CLI","rails-mcp-server (可选)",[35,14,13],null,"2026-03-27T02:49:30.150509","2026-04-18T23:06:45.486837",[112,117,122],{"id":113,"question_zh":114,"answer_zh":115,"source_url":116},40855,"如何关闭 Claude 的 YOLO 模式（即要求确认删除等危险操作）？","可以通过在配置文件中将 `vibe` 选项设置为 `false` 来禁用 YOLO 模式。具体配置位置通常在生成的 swarm 配置模板中（例如 `swarm.yml.erb`），设置如下：\n```yaml\nvibe: false\n```\n这样在执行 `rm` 等潜在有害操作时，系统将要求用户进行确认。","https:\u002F\u002Fgithub.com\u002Fobie\u002Fclaude-on-rails\u002Fissues\u002F16",{"id":118,"question_zh":119,"answer_zh":120,"source_url":121},40856,"生成的 YAML 配置中使用了未实现的 `prompt_file` 选项怎么办？","由于底层的 `claude-swarm` 库尚未完全支持 `prompt_file` 选项，目前推荐的变通方案是使用 ERB 脚本动态生成配置文件。具体步骤如下：\n\n1. 创建一个名为 `bin\u002Fclaude-swarm` 的可执行 Ruby 脚本：\n```ruby\n#!\u002Fusr\u002Fbin\u002Fenv ruby\nrequire \"erb\"\ncontent = File.read(File.expand_path(\"..\u002Fclaude-swarm.yml.erb\", __dir__))\nerb     = ERB.new(content)\nresult  = erb.result(binding)\nFile.write(File.expand_path(\"..\u002Fclaude-swarm.yml\", __dir__), result)\nexec \"claude-swarm\", *ARGV\n```\n\n2. 创建 `claude-swarm.yml.erb` 模板文件，使用 ERB 读取外部 prompt 文件：\n```yml\ninstances:\n  architect:\n    description: \"Rails architect coordinating full-stack development\"\n    directory: .\n    prompt: |\n      \u003C%= File.read(\".claude\u002Fprompts\u002Farchitect.md\").gsub(\u002F^\u002F, \"        \").strip %>\n    vibe: true\n```\n这种方法可以灵活地加载外部提示文件，绕过当前配置选项的限制。","https:\u002F\u002Fgithub.com\u002Fobie\u002Fclaude-on-rails\u002Fissues\u002F8",{"id":123,"question_zh":124,"answer_zh":125,"source_url":126},40857,"为什么项目使用的是 Minitest，但 claude-on-rails 却错误地检测为 RSpec？","这是因为检测逻辑仅检查根目录下是否存在 `spec` 文件夹，而没有区分该文件夹是否真正用于 RSpec 测试（参见源码逻辑）。如果您的项目中存在名为 `spec` 的文件夹但不是用于 RSpec，工具会误判。\n\n临时解决方法是手动修改生成的 `context.md` 文件中的测试框架描述。长期来看，改进检测逻辑（例如读取 `Gemfile` 确认是否包含 `rspec` 依赖）可能是一个更好的方向，但在当前版本中需手动修正上下文信息。","https:\u002F\u002Fgithub.com\u002Fobie\u002Fclaude-on-rails\u002Fissues\u002F3",[128,133,138,143,148,153],{"id":129,"version":130,"summary_zh":131,"released_at":132},324420,"v0.2.0","## 新功能\n\n### 🚀 Rails MCP 服务器集成\n\nClaudeOnRails 现已与 Rails MCP 服务器集成，为您的 AI 代理提供对 Rails 文档和最佳实践的实时访问！\n\n### ✨ 主要特性\n\n- **交互式设置**：在生成过程中只需按 Y 键即可设置 MCP 服务器\n- **增强的文档访问**：代理可以实时查询 Rails 指南\n- **自动化安装**：无需手动执行 npm 或 gem 命令\n- **智能检测**：当 MCP 服务器可用时会自动配置\n\n### 🛠️ 设置\n\n```bash\n# 在生成过程中，您将收到提示：\nrails generate claude_on_rails:swarm\n# 按 Y 键以设置 Rails MCP 服务器！\n\n# 或者稍后设置：\nrails claude_on_rails:setup_mcp\n\n# 检查状态：\nrails claude_on_rails:mcp_status\n```\n\n### 🐛 修复\n\n- 修复了安装过程中 RDoc 版本冲突的问题\n- 改进了 MCP 可用性检测\n- 添加了 --no-document 标志，以避免文档生成问题\n\n### 📚 文档\n\n- 添加了全面的 SETUP.md 使用指南\n- 更新了 README，加入了 MCP 集成详情\n- 增强了所有代理提示，使其包含 MCP 功能\n\n### 💎 安装\n\n```ruby\ngem 'claude-on-rails', '~> 0.2.0'\n```\n\n感谢 @mariochavez 提供的优秀 Rails MCP 服务器！","2025-07-02T18:25:57",{"id":134,"version":135,"summary_zh":136,"released_at":137},324421,"v0.1.4","## 变更内容\n\n### 🐛 修复了错误\n- 修复了 CLAUDE.md 覆盖用户现有指令的问题\n- 修正了 swarm 配置文件名（现在正确使用 `claude-swarm.yml`）\n- 修正了文件引用语法（现在使用 `@file` 而不是 `\u002Ffile`）\n\n### 🚀 改进\n- ClaudeOnRails 的上下文现在存储在 `.claude-on-rails\u002Fcontext.md` 中\n- CLAUDE.md 使用文件引用而不是追加内容\n- 更新了文档，以明确提示与命令的区别\n- 修复了所有 RuboCop 代码风格检查问题\n\n### 📋 需求\n- 将所需的 Ruby 版本更新至 3.3.0\n- 将开发依赖移至 Gemfile\n\n### 🔧 技术细节\n本次发布的主要改进是 ClaudeOnRails 不再覆盖现有的 CLAUDE.md 文件。取而代之的是：\n1. 创建一个独立的上下文文件，路径为 `.claude-on-rails\u002Fcontext.md`\n2. 使用 Claude 的文件引用语法（`@.claude-on-rails\u002Fcontext.md`）来引入该文件\n3. 保留用户的所有现有配置\n\n这样可以确保用户在安装或更新 ClaudeOnRails 时，不会丢失自定义的 CLAUDE.md 指令。\n\n**完整变更日志**：https:\u002F\u002Fgithub.com\u002Fobie\u002Fclaude-on-rails\u002Fcompare\u002Fv0.1.3...v0.1.4","2025-06-27T10:26:11",{"id":139,"version":140,"summary_zh":141,"released_at":142},324422,"v0.1.3","## 🛡️ 稳定性改进\n\n此版本修复了导致 Swarm 无法正常启动的关键问题。\n\n### 修复内容\n- **目录安全性**：仅针对实际存在的目录创建 Swarm 代理\n  - 不再因 `app\u002Fservices`、`app\u002Fjobs` 等目录不存在而失败\n  - 生成器会在包含代理之前检查每个目录\n- **模型兼容性**：修正了模型名称，使其与 `claude-swarm` 兼容\n  - 从 `claude-3-5-haiku-20250110` 改为 `haiku`\n  - 默认模型现为 `opus`，以提供更强的能力\n- **动态连接**：控制器仅在目录存在时才会连接到服务\n\n### 改进内容\n- 生成器现在会在分析过程中显示将要创建的代理列表\n- 通过主动检查目录，更好地预防错误\n- 生成的 YAML 文件更整洁，仅包含相关代理\n\n### 示例输出\n```\n正在分析 Rails 项目结构...\n项目类型：全栈 Rails\n测试框架：RSpec\n\n将要创建的代理：\n  - architect\n  - models\n  - controllers\n  - views\n  - tests\n  - devops\n```\n\n### 升级说明\n```bash\nbundle update claude-on-rails\nrm -f claude-swarm.yml CLAUDE.md && rm -rf .claude-on-rails\u002F\nrails generate claude_on_rails:swarm\n```\n\n---\n\n*注：这仍是一个实验性版本。我们正根据用户反馈快速迭代改进！*","2025-06-26T23:37:25",{"id":144,"version":145,"summary_zh":146,"released_at":147},324423,"v0.1.2","## 🐛 错误修复版本\n\n此版本修复了 Rails 生成器中的关键问题，这些问题曾导致无法正确完成设置。\n\n### 修复内容\n- 生成器现在会正确加载 `claude_on_rails` 模块。\n- 生成的配置文件已重命名为 `claude-swarm.yml`（之前为 `swarm.yml`）。\n- 从文档中移除了错误的 `orchestrate` 命令引用。\n- 移除了冗余的 gem 安装说明。\n- 修复了缺失的代理提示模板。\n- 将提示语法示例更正为使用 `>` 前缀。\n\n### 新增内容\n- 为所有代理类型提供了完整的提示模板：\n  - views（Rails 视图和前端）\n  - api（RESTful API 开发）\n  - jobs（后台任务处理）\n  - devops（部署与基础设施）\n  - graphql（GraphQL API 开发）\n  - stimulus（Turbo\u002FStimulus 前端）\n\n### 安装\n```ruby\ngem 'claude-on-rails', '~> 0.1.2'\n```\n\n### 使用\n```bash\n# 在你的 Rails 项目中\nrails generate claude_on_rails:swarm\nclaude-swarm\n```\n\n---\n\n*注：本版本仍处于实验阶段。API 和功能可能会发生变化。*","2025-06-26T23:27:40",{"id":149,"version":150,"summary_zh":151,"released_at":152},324424,"v0.1.1","## 🐛 错误修复版本\n\n此版本修复了导致无法安装的依赖问题。\n\n### 修复内容\n- 修正了 `claude_swarm` gem 的依赖名称（之前错误地写为 `claude-swarm`）\n- 更新了文档，以更清晰地说明安装要求\n\n### 安装\n\n现在该 gem 应该可以正常安装：\n\n```ruby\ngem 'claude-on-rails', '~> 0.1.1'\n```\n\n感谢早期采用者报告了安装问题！\n\n---\n\n*注：这仍然是一个实验性版本。API 和功能可能会发生变化。*","2025-06-26T22:13:03",{"id":154,"version":155,"summary_zh":156,"released_at":157},324425,"v0.1.0","## 🚧 实验性发布\n\n这是 ClaudeOnRails 的首个实验性版本。随着我们根据用户反馈不断完善框架，API 和功能可能会发生变化。\n\n## 什么是 ClaudeOnRails？\n\nClaudeOnRails 借助 [claude-swarm](https:\u002F\u002Fgithub.com\u002Fparruda\u002Fclaude-swarm)，构建了一个由专注于 Rails 开发不同方面的 AI 代理组成的智能团队。您无需手动切换角色或上下文，只需用自然语言描述您想构建的内容，智能群组便会跨所有 Rails 层次自动完成实现。\n\n## 核心特性\n\n- 🤖 **智能代理群组**：专为模型、控制器、视图、服务、测试等设计的专用代理\n- 🚂 **熟悉 Rails**：深入理解 Rails 约定和最佳实践\n- 🔍 **项目分析**：自动适应您的项目结构（仅 API、全栈等）\n- 💬 **自然语言接口**：只需描述您想构建的内容\n- 🧪 **测试驱动**：自动生成所有代码的测试用例\n- ⚡ **性能优先**：内置优化能力\n\n## 安装\n\n```ruby\ngroup :development do\n  gem 'claude-on-rails'\nend\n```\n\n然后：\n```bash\nbundle install\nrails generate claude_on_rails:swarm\nclaude-swarm orchestrate\n```\n\n## 使用示例\n\n```\n> 创建一个带有邮件确认功能的用户认证系统\n[智能群组会自动协调各层的实现]\n\n> 优化仪表盘——加载速度太慢了\n[对模型、查询、缓存等进行性能优化]\n```\n\n## ⚠️ 实验性状态\n\n这是一个早期版本。请做好以下准备：\n- 未来版本中 API 可能会发生变化\n- 可能存在一些 bug 和不完善之处\n- 生成的群组配置可能需要手动调整\n- 代理提示和协作机制仍在持续改进中\n\n## 系统要求\n\n- Ruby 2.7+\n- Rails 6.0+\n- [claude-swarm](https:\u002F\u002Fgithub.com\u002Fparruda\u002Fclaude-swarm) gem\n- Claude Code CLI\n\n## 反馈\n\n如发现任何问题或有改进建议，请提交至：https:\u002F\u002Fgithub.com\u002Fobie\u002Fclaude-on-rails\u002Fissues\n\n## 后续计划\n\n- 根据实际使用情况优化代理提示\n- 提升项目检测与适配能力\n- 针对常见 Rails 模式开发更多专用代理\n- 与 Rails MCP Server 集成以生成文档\n- 社区贡献的代理模板\n\n感谢您试用 ClaudeOnRails！🚂✨","2025-06-26T22:08:04"]