続・コーディングルールの鮮度を保ちたい / keep-fresh-go-internal-conventions-again

kamakura.go #10 で行った LT のスライドです。
kamakura.go #8 で話したコーディング規約自動更新の仕組みを、その後どうやって運用改善しているかという話です。

前回のはなしはこちら
https://speakerdeck.com/handlename/keep-fresh-go-internal-conventions

Transcript

1. 続・コーディング規約の鮮度を保ちたい 2026-10-09 kamakura.go #10 @handlename
2. @handlename Hiroaki Nagata Nature Inc. ソフトウェアエンジニア & その他職種も採用募集中！ Software Engineer (Backend) & SRE & PjM
3. 前回までのあらすじ
4. 前回までのあらすじ kamakura.go #8 ではなした コーディング規約を PR のレビューコメントをもと に自動更新するはなし https://speakerdeck.com/handlename/keep-fresh-go-internalconventions
5. 仕組み 人が PR をレビュー 2. AI がレビューコメントを解析、 コーディング規約として提案 3. 人が規約をレビュー 4. AI が採用された規約を作ってコードを書く 1. https://speakerdeck.com/handlename/keep-fresh-go-internalconventions?slide=11
6. その後どうなった？ 半年くらい経ちました。
7. 47 → 77 2/27 時点 から 10/9 時点 までの合意されたルール数変化
8. ルールの合意が進んでいる！ その一方で・・・
9. 運用する中で 現れてきた課題 規約追加 PR の・・・ レビューコストが高い チーム内のコンセンサスを取るタイミングがない 期限がないのでなかなか approve されない
10. どうしたか
11. PR を分割する before 1PR = 複数トピック after 1PR = 1トピック トピックごとに採用できるようになった タイトル = トピックにすることで検索しやすく
12. 何度も話題に上がる トピックを見える化 before 過去に一度話題に上がったことしかわからない after トピック PR に言及事例を積み上げていく 「何回も言われているなら規約に入れよう」という 判断基準に 規約更新用の Claude skill に指示を追加することで実現しています。
13. 定期的なトリアージ before チームメンバーがベストエフォートでレビュー after ウィークリー定例でトリアージ 合意多めのものの後押しをしたり レビューされていないものの催促をしたり 必要ならその場で議論したり こちらのレポートも Claude skill で。 もともとあった定例アジェンダにトリアージ情報を追加しています。
14. 規約として取り出す精度を上げる そもそもの問題。 質の低い規約案(いわゆる Slop)率が高いと誰もレビューしなくなる😣 一度に提案する規約の数を制限(いまは最大 3個/週) draft PR として作り、言及数が一定を越えてから Ready for review にする 採用・不採用の例を更新 skill に反映することで精度を上げる など、試行錯誤中。
15. まとめ ちゃんと運用継続してます 規約のレビューコストが高いのは順当 人間の意志が乗る部分なので 仕組みでコストを下げられる部分は今後も改善 規約を充実させてコードレビューコストを下げたい
16. おわり