97 lines
3.4 KiB
Markdown
97 lines
3.4 KiB
Markdown
# Rails 开发 Claude 插件
|
||
|
||
`Rails` `Claude Code` `插件` `代码生成` `Ruby on Rails`
|
||
|
||
# Rails Dev 插件
|
||
|
||
> 专为 Rails 开发打造的 Claude Code 插件，内置专业智能体与技能
|
||
|
||
[](https://github.com/ag0os/rails-dev-plugin/releases)
|
||
[](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 社区打造。 |