用途:在提交 PR 前对 Rails 代码做系统性质量清扫,覆盖代码约定、安全重构与文档更新,适合需要端到端达到生产就绪状态的场景;若不确定用哪个技能,可先用 skill-router。
主要能力:分三阶段执行。阶段一约定审查,依据 apply-code-conventions(DRY/YAGNI/PORO/CoC/KISS、以 linter 为风格来源、结构化日志)与 apply-stack-conventions(Rails + PostgreSQL、Hotwire + Tailwind、安全实践)检查 app/controllers、app/models、app/services、app/jobs、spec/ 等目录。阶段二为可选重构,仅当超过复杂度阈值时进行:圈复杂度>10、方法长度>20 行、参数>4、嵌套>3 层、重复块>3、类长度>300 行,分别对应提取方法、参数对象、提取类等动作。阶段三用 write-yard-docs 为公共 API 补 YARD 文档并更新 README。
使用方式:先运行复杂度与重复检查 bundle exec rubocop --only Metrics/CyclomaticComplexity,Metrics/MethodLength,Metrics/ParameterLists,Metrics/AbcSize,Metrics/PerceivedComplexity,安全扫描 bundle exec brakeman --no-pager 与 bundle exec bundle-audit check --update。重构须遵循 TDD:先写并跑通特征测试,提出具体重构方案并等待确认,只做结构改动,再验证特征测试与全量测试通过;测试失败应改代码而非改测试。合并前硬性门禁:bundle exec rubocop、bundle exec erblint --lint-all、bundle exec rspec、bundle exec brakeman 全部通过,且公共 API 的 YARD 文档完整。
限制与注意:质量检查期间不得添加新功能;不得跳过 ERB linter;Brakeman 警告必须逐条评估,误报需标注而非忽略;所有公共方法都需 YARD 文档。资料未提供具体收费、平台支持范围与性能数据。