用途
presenter-agent 是一个面向 Rails 应用的 AI 智能体技能,其核心目标是帮助开发者使用 Presenter(展示器,也称装饰器或视图模型)模式,将视图专属逻辑从模型和视图中分离出来,使模型专注于数据、视图保持简洁。
该技能定位为 Presenter/Decorator 模式专家,使命是创建封装视图专属逻辑的展示器对象,并始终同步编写 RSpec 测试,遵循单一职责原则(SRP)。
主要能力
- 创建和修改
app/presenters/下的展示器对象,使用 SimpleDelegator 进行委托。 - 将数据格式化逻辑(日期、数字、货币)移入展示器。
- 处理条件展示逻辑、组合多个模型属性、创建展示专用方法。
- 优雅处理 nil 值,动态构建 CSS 类,生成链接或 URL。
- 始终为展示器编写 RSpec 测试(
spec/presenters/)。 - 可读取模型(
app/models/)、视图(app/views/)、视图辅助方法(app/helpers/)和 FactoryBot 工厂(spec/factories/)以理解使用场景。
使用方式
该技能提供以下命令用于测试、代码检查与验证:
测试:
- 全部展示器:
bundle exec rspec spec/presenters/ - 指定展示器:
bundle exec rspec spec/presenters/entity_presenter_spec.rb - 指定行:
bundle exec rspec spec/presenters/entity_presenter_spec.rb:25 - 详细格式:
bundle exec rspec --format documentation spec/presenters/
代码检查:
- 检查展示器:
bundle exec rubocop -a app/presenters/ - 检查测试:
bundle exec rubocop -a spec/presenters/
验证:
- Rails 控制台:
bin/rails console(手动测试展示器)
适用场景
适合使用展示器的情况:
- 为展示格式化数据(日期、数字、货币)
- 根据状态构建 CSS 类
- 创建条件展示逻辑
- 组合多个属性用于展示
- 优雅处理 nil 值
- 生成视图专属的链接或操作
- 视图逻辑变得复杂时
不适合使用展示器的情况:
- 逻辑属于模型(业务规则)
- 逻辑属于服务对象(业务操作)
- 逻辑属于策略对象(授权)
- 视图足够简单,无需抽象
- 只是创建透传对象(无附加价值)
展示器与 ViewComponent 的选择:格式化单个值、模型装饰适合用 Presenter;复杂 HTML 输出、可复用 UI 元素适合用 ViewComponent。
边界与限制
始终应做:编写展示器测试、使用 SimpleDelegator 委托、保持展示器专注于视图逻辑、包含 Rails 视图辅助方法、优雅处理 nil、必要时返回 HTML 安全字符串。
需先询问:创建复杂的展示器层级、向展示器添加数据库查询、修改 ApplicationPresenter。
绝不应做:在展示器中放置业务逻辑、在展示器中持久化数据、在展示器中执行数据库查询、创建没有测试的展示器、将授权逻辑与展示逻辑混合。
技术栈与架构
技术栈:Ruby 3.3、Rails 8.1、RSpec、FactoryBot。
架构目录:
app/presenters/– 展示器(创建和修改)app/models/– ActiveRecord 模型(读取和包装)app/views/– 视图(读取以理解用法)app/helpers/– 视图辅助方法(读取)spec/presenters/– 展示器测试(创建和修改)spec/factories/– FactoryBot 工厂(读取)
参考资料
- patterns.md – ApplicationPresenter 基类、所有展示器实现及视图用法示例
- testing.md – 实体、用户和订单展示器的 RSpec 测试
官方文档与价格信息暂未提供。