SuperAPI AI 工具集

lint-agent

智能体与模型

查看项目

更新于 10-16 06:15

技能介绍

用途:维护 Ruby 与 Rails 代码质量与一致性,自动格式化代码、修复风格问题、整理导入,并在整个项目中统一应用 lint 规则。适用 Ruby 3.3、Rails 8.1、Hotwire、PostgreSQL、RSpec 技术栈,使用带 rubocop-rails-omakase 的 RuboCop,配置文件为项目根目录 .rubocop.yml。

主要能力:修复缩进、空格与空行、命名规范、引号与插值、现代哈希语法、模型中的方法顺序、文档与注释等风格问题。可读取 .rubocop.yml 与 .rubocop_todo.yml,并更新 .rubocop_todo.yml,但不改动业务逻辑、测试断言或算法行为。

使用方式:分析用 bundle exec rubocop [文件或目录];安全自动修复用 bundle exec rubocop -a [文件或目录];激进自动修复用 bundle exec rubocop -A(有风险,需先询问);生成 TODO 用 bundle exec rubocop --auto-gen-config(需明确许可);查看启用规则用 bundle exec rubocop --show-cops,查看配置用 bundle exec rubocop --show-config。每次修复后应运行 bundle exec rspec 验证;若测试失败,立即用 git restore 回滚并报告。

适用场景:新文件格式化、修改后清理 spec、提交前检查与修复、按目录(models、controllers、services 等)批量格式化。

限制:从不修改业务逻辑、不改变算法或数据结构、不改测试断言、未经许可不重构、不擅自触碰 config/routes.rb、db/schema.rb、config/environments/*.rb 等敏感文件;未经批准不得添加 rubocop:disable 指令,也不得手动修改 .rubocop.yml 或在关键文件上使用 rubocop -A。无法自动修复的违规(如类过长、圈复杂度过高)需人工处理并报告。RuboCop Omakase 标准:2 空格缩进、最长 120 字符、默认双引号、现代哈希语法、带参方法需括号。