# Rails 开发 Claude 插件

`Rails` `Claude Code` `插件` `代码生成` `Ruby on Rails`

# Rails Dev 插件

> 专为 Rails 开发打造的 Claude Code 插件，内置专业智能体与技能

[![版本](https://img.shields.io/badge/version-2.0.0-blue.svg)](https://github.com/ag0os/rails-dev-plugin/releases)
[![许可证](https://img.shields.io/badge/license-MIT-green.svg)](LICENSE)

这是一个 Claude Code 插件，提供覆盖模型、控制器、视图、服务、任务、测试、架构、DevOps、GraphQL、Hotwire、API 设计等领域的专业智能体与可复用技能。

智能体会自动检测你项目的技术栈（omakase、面向服务或 API 优先），以及编码规范，然后生成与你项目风格匹配的代码——而非通用的 Rails 代码。

## 快速开始

```shell
# 在 Claude Code 中执行
/plugin marketplace add ag0os/rails-dev-plugin
/plugin install rails-dev-plugin@ag0os
```

重启 Claude Code 后，直接提问即可：

```
你："创建一个带有身份验证的 User 模型"
你："重构这个控制器——它包含了太多业务逻辑"
你："为邮件发送添加后台任务"
```

Claude 会根据你的请求自动选择合适的智能体。

## 功能说明

**智能体**是处理具体实现任务的专家——分别负责模型、控制器、测试等不同领域。它们会先扫描你的代码库，以匹配你现有的代码风格。

**技能**是智能体可调用的可移植知识库。它们也可以在主对话中独立使用（例如询问重构模式或缓存策略）。

**技术栈配置**根据你的项目构建方式调整建议。使用 Minitest + fixtures + concerns 的项目与使用 RSpec + FactoryBot + service objects 的项目会得到不同的建议。

**规范检测**比配置更深入——智能体在编写代码前会检测你的具体基类、命名规范、返回类型、认证方式等。它们还会读取你的 `CLAUDE.md`，以获取优先于检测结果的开发意图。

## 智能体列表

| 智能体 | 负责领域 |
|--------|----------|
| `rails-model` | ActiveRecord 模型、数据库迁移、关联关系 |
| `rails-controller` | RESTful 控制器、路由、参数处理 |
| `rails-service` | 服务对象、业务逻辑 |
| `rails-jobs` | 后台任务、ActiveJob、Sidekiq |
| `rails-views` | ERB 模板、局部视图、ViewComponents |
| `rails-hotwire` | Stimulus 控制器、Turbo frames/streams |
| `rails-graphql` | GraphQL schema、解析器、mutation |
| `rails-api` | REST API、序列化、JWT |
| `rails-test` | RSpec、Minitest、系统测试 |
| `rails-architect` | 架构规划、设计决策 |
| `rails-devops` | Docker、CI/CD、部署、监控 |

## 团队配置

在项目的 `.claude/settings.json` 中添加以下配置，插件将自动为所有团队成员安装：

```json
{
  "plugins": {
    "marketplaces": [
      {
        "name": "rails-dev",
        "source": "ag0os/rails-dev-plugin"
      }
    ],
    "installed": ["rails-dev-plugin@rails-dev"],
    "autoInstall": true
  }
}
```

## 插件管理

```shell
/plugin disable rails-dev-plugin@ag0os    # 禁用
/plugin enable rails-dev-plugin@ag0os     # 重新启用
/plugin uninstall rails-dev-plugin@ag0os  # 卸载
```

## 参与贡献

欢迎贡献代码——详见 [CONTRIBUTING.md](CONTRIBUTING.md)。

## 许可证

MIT——详见 [LICENSE](LICENSE)。

---

专为 [Claude Code](https://claude.com/claude-code) 与 Rails 社区打造。