sgcop-setup

sgcop-setup

sgcop（SonicGarden 標準の RuboCop 設定・カスタム Cop を提供する Gem）を、導入先の Rails/Ruby プロジェクトにセットアップするためのスキル。このスキルは sgcop gem 本体ではなく、 sgcop を使う側のプロジェクトで実行される。

このスキルがやること / やらないこと

• やる:
  1. 導入方針（標準 / strict）を確認して inherit_gem を整える。strict を選べば、汎用 Cop と カスタム Cop（Sgcop/*）がまとめて有効化される。
  2. 既存 .rubocop.yml から sgcop と重複・冗長な設定を削除する（承認のうえ）。
  3. gem 依存のカスタム Cop（Sgcop/Enumerize* など、strict でもコメントアウトのまま）は、 対象 gem を使っているときだけ確認して有効化する。
  4. rubocop --auto-gen-config で .rubocop_todo.yml を生成し、実際の違反（ノイズ）量を見る。
  5. ノイズが多い Cop だけ調整を提案する（無効化 / Exclude / 段階対応 / -a 自動修正）。 無効化・Exclude したら todo を作り直す。
• やらない: 個別 Cop を 1 つずつ机上で有効化確認することはしない（strict 一括＋実ノイズ確認に 置き換えた）。ただし標準を選んだ場合のフォールバックとしてだけ、デフォルト無効カスタム Cop の 1 つずつ確認を残す。すでにプロジェクトの .rubocop.yml に意図的に明示設定されている Cop （sgcop と異なる値の上書き）は尊重してスルーする。

なぜこの形か: sgcop の基本導入は inherit_gem 1 行で済み、判断が分かれる便利 Cop（カスタム + 実績ある推奨汎用）は strict 設定が 1 ファイルにまとめている。だから「1 つずつ確認」より 「方針を決めて strict を一括適用 → --auto-gen-config で実際のノイズを見て、多い Cop だけ調整」の 方が速く、判断も机上でなく実データに基づく。推奨 Cop のリストはスキルに持たず、sgcop 本体の strict 設定を唯一の出典にする（保守の一元化）。

重要な前提

• Cop の一覧・趣旨・オプションは導入先にインストール済みの sgcop gem から動的に取得する。 スキル内にハードコードした一覧は「参考値」にすぎない。sgcop に Cop が追加・変更されても 動的取得なら自動追従でき、スキルが古びない。
• config/default.yml 内の Cop 名（YAML キー）をそのまま使う。特に RSpec 系は Sgcop/Rspec/...（Rspec 表記、README の RSpec とは違う）なので、必ず実ファイルの キーをコピーすること。.rubocop.yml のキーが gem 側と食い違うと設定が効かない。
• 対話の主役は「実ノイズを見ての調整」（手順 6〜8）。Cop の有効化是非は strict 一括適用に委ね、 ユーザーへの確認は「重複削除の承認」「gem 依存 Cop の有無」「ノイズが多い Cop の扱い」に絞る。

---

手順

1. プロジェクト種別を判定する

Rails か純 Ruby かを判定し、inherit_gem の参照先（標準 / strict）の候補を決める。実際にどちらを 書き込むかは手順 3 の方針確認で決まる。純 Ruby の場合はさらに RSpec を使っているかも判定する （Gemfile の rspec/rspec-core、spec/spec_helper.rb の有無などで判定できる）。

• Rails 判定: config/application.rb の有無、Gemfile / gemfile.lock の rails 行、bin/rails など。
• 参照先の候補:
  • Rails → 標準 rails/rubocop.yml / strict rails/rubocop_strict.yml （RSpec 関連設定は内部で ruby/rubocop_rspec.yml を継承しているので追加指定は不要）
  • 純 Ruby（RSpec 不使用） → 標準 ruby/rubocop.yml / strict ruby/rubocop_strict.yml
  • 純 Ruby（RSpec 使用） → 標準 [ruby/rubocop.yml, ruby/rubocop_rspec.yml] / strict [ruby/rubocop_strict.yml, ruby/rubocop_rspec_strict.yml]（配列で複数ファイルを指定）