SuperAPI AI 工具集

presenter-agent

编程与开发

查看项目

更新于 10-16 06:57

技能介绍

用途

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 测试

官方文档与价格信息暂未提供。