Rubyで鍛える仕組み化プロヂュース力

2025/12/06(土) に開催された 北陸Ruby会議01 でのトークスライド。

Transcript

1. Rubyで鍛える仕組み化 プロヂュース力 2025/12/06 (Sat) 北陸 Ruby 会議 01 @ 石川県立図書館 muryoimpl
2. 本日のおしながき - 自己紹介 - 私にとっての Ruby - 仕組み化どうやっている？ - どうやって思いつくのか？ - 具体的な実装例
3. 自己紹介 - 名 前: muryoimpl - 居住地: 石川県金沢市 - Kanazawa.rb によく出没している - LT 大会向け Slack slash command 「kzlt」の創 造主兼管理者 - https://github.com/muryoimpl/kzlt-ruby
5. https://kzrb.doorkeeper.jp/events/193290
6. https://zenn.dev/muryoimpl
7. 本日のおしながき - 自己紹介 - 私にとっての Ruby - 仕組み化どうやっている？ - どうやって思いつくのか？ - 具体的な実装例
8. 私にとっての Ruby - システムの第一言語 - 仕事でもプライベートでも使っている - 汎用的で多くの場面で使える - GitHub Actions の image にもインストールされている - https://github.com/actions/runner-images
9. 私にとっての Ruby - Monkey patch で上書き自在 - 直接 gems を書き換える必要がない - リポジトリを fork せずとも変更可能 - クラス、モジュール、オブジェクトを抽出しやすい - 親クラスだけでなく、比較的簡単に子クラスも取得できる
10. Ruby で鍛える 仕組み化プロヂュース
11. 本日のおしながき - 自己紹介 - 私にとっての Ruby - 仕組み化どうやっている？ - どうやって思いつくのか？ - 具体的な実装例
12. 普段、仕事では 趣味で仕組み化をしている
13. 私のいう「仕組み化」とは 作業やその流れを 自分なりに、もしくは、チームとして定義し 、そ の作業が全自動、もしくは、半自動でスムーズに流れるようにす ること。 人のする作業であっても、システムが介在することでスムーズに なるならば、これもその範疇とする。
14. なぜ仕組み化する？
15. なぜ「仕組み化」するのか - 人の考えたり行動したりする負荷が減る💡 - 覚えておかなければいけない -> 不要になる - 確実に実施しなければいけない -> 不要になる - 暗黙知から形式知にできる - コード化することで共通認識を作ることができる - ヌケモレ防止、実行の一貫性確保
16. 何を使って仕組み化する？
17. どのような手段で「仕組み化」するのか - Custom Cops - https://github.com/rubocop/rubocop - https://github.com/rubocop/rubocop-rails - Rake tasks or Thor - https://github.com/rails/thor - GitHub Actions ( Rake tasksや Thor を実行する ) - (Ruby 以外だと) actions/github-script - https://github.com/actions/github-script
18. どう使い分けているか - Custom Cops - コードを書くうえで注意すべきこと - Rake tasks or Thor - コード上だけではどうにもできないもの (例: DB) - Thor は引数オプションつけたいときに使う
19. どう使い分けているか - GitHub Actions - 全部この上で動かしている - step 上で Ruby のワンライナー書いたりもしてる - ワークフロー自体に作用するものは + Slack 通知 - actions/github-script - GitHub 上の状態はほぼすべて取得できるので、状態の変化で 何かをさせたいときはこれを使う
20. 何を対象にしている？
21. 何を対象に仕組み化しているか - 開発のワークフローにある些事を対象にしている - できるだけ、さくっと実装できる範囲 - 時間かかるだけ利益の享受が遅れる - 簡易実装して時間を稼ぐ - できれば複数人いるプロジェクトを対象にするのがよい - ニーズを自分以外からも獲得できる - 仕組み化した後の答え合わせができる
22. 本日のおしながき - 自己紹介 - 私にとっての Ruby - 仕組み化どうやっている？ - どうやって思いつくのか？ - 具体的な実装例
23. どうやったら思いつくのか - レビュー時に困ったことを解決できないか考える - 実はすでにみんな困り事には気づいている - だいたいこれ - ただし実装するとは言っていない => あとはやるだけ - 指示して AI に作ってもらう
24. どうやったら思いつくのか - 一発で格好よく解決しようという考えを捨てる - まず実利を得ることを考える - Custom Cop でAuto Correct が難しいなら まず警告を出す - それも難しければ test を書いてひっかける - 指示して AI に作ってもらう
25. どうやったら思いつくのか - 具体的なものには個別・具体的な対策でもOK - まず問題の箇所に対して簡単に蓋をして塞ぐのが大事 - 蓋をして止めている間に、考え、実装する - 抽象度を高めて汎用的にする - gem として適用範囲を拡大する
26. どうやったら思いつくのか - 法則をみつける or 法則をでっちあげる - 型( Object#is_a?, Object#kind_of? ) - ActiveSupport::DescendantsTracker.descendants - RuboCop::NodePattern::Macros#def_node_search, def_node_matcher
27. 法則を見出す - 特定のクラスを抽出する場合 - 特定のクラスを継承したクラス Rails.application.eager_load! ApplicationRecord.descendants
28. 法則を見出す - 特定のクラスを抽出する場合 - 特定のmodule を include したクラス Rails.application.eager_load! ObjectSpace.each_object(Class).select do |klass| klass.included_modules.include?(module) end クラスの配列が返る
29. 法則を見出す - 特定のクラスを抽出する場合 - 特定のmodule を extend したクラス Rails.application.eager_load! ObjectSpace.each_object(Class).select do |klass| klass.singleton_class.ancestors.include?(module) end クラスの配列が返る
30. 法則を見いだせたら もう勝ちに等しい
31. 作るときに考えること
32. 作るときに考えること - 早いの？うまいの？安いの？ - さくっとできる？効果は十分？追加のインフラかかる？ - Generator や Snippet はちょっと微妙… - 最初は使われるが、慣れると皆他からコピペしてくる - AI さんはちゃんと実装したがる - 過剰に品質を気にしすぎる傾向があるので適度なところでやめ ておく
33. 本日のおしながき - 自己紹介 - 私にとっての Ruby - 仕組み化どうやっている？ - どうやって思いつくのか？ - 具体的な実装例
34. 簡単な実装例（ 1） 1. ApplicationRecord.ignored_columns に無視するカラムが登録さ れっぱなし、もしくは、宣言だけ残っていてカラムは削除されている ものがないかチェックする rake task - ApplicationRecord.descendants を使ってテーブルに対応したモデ ルのみを抽出している - すぐカラム削除する PR 作っておけばいいじゃないって思うでしょ？ それでも発生するから作った
36. 簡単な実装例（ 2） 2. CSVにいれる BOM の定数宣言があちこちに出てきたので 警告を出す Custom Cop を追加 - すべての BOM の宣言が生まれる前に消し去るために、Custom Cop 作って穴塞いだ後に他の宣言を消した
37. ※対象のファイルについては、.rubocop.yml で指定している
38. 簡単な実装例（ 3） 3. 新しくリリースされた Ruby の image が公開されているかどうかを 確認する GitHub Actions - renovate が Dockerfile の RUBY_VERSIONを更新する PR を作っ たときに、container image がリリースされていないとマージボタン 押せないようにするための仕組み
40. 簡単な実装例（ 4） 4. ActiveRecord のモデルに has_one/has_many が設定されて おり、かつ、dependent option 設定されているかチェック するrake task - rubocop-rails の Rails/HasManyOrHasOneDependent は has_one/has_many を書かないとチェックできないので、 belongs_to だけ書かれていても引っ掛けられるようにした
41. 簡単な実装例（ 4） - ActiveSupport::DescendantsTracker.descendants の存在に気が ついていなかったため、ApplicationRecord.connection.tables で テーブル取得して table_name からモデルクラス名を組み立ててい た - ↑を処理するクラスを作って、そのテストという建付けでチェックする ようにした（蓋をした）
42. 簡単な実装例（ 4） - モデル名とテーブル名が異なる(self.table_name=)場合や、関連の キーがテーブル名と不一致の場合があるため、それらに対応して gem 化した - https://github.com/muryoimpl/dependent_option_checker
43. 簡単な実装例（ 4） - 具体的な内容については、zenn.dev に暫定対応時の記事と、gem 化したときの記事があるのでこちらをみてください - https://zenn.dev/ashita_team/articles/36bc5e77651985 - https://zenn.dev/ashita_team/articles/ed08141e3110e2
44. まとめ
45. まとめ - (半) 自動化で人の負荷が減る、暗黙知から形式知にできる - 要求はあなたの中に既にある、一歩踏み出して実装すべし - 一発解決に時間かかるなら段階を踏んで解決してもいい - 法則を見出すと勝ち。見出せないならでっちあげよ - 些事には意外と少ない行数で対応できるので、レビューの隙間を埋 めてみて