Google コードレビュー基準

このスキルは、Google のエンジニアリングプラクティスに基づくコードレビューの「観点・判断基準・コメント作法」を提供する。単にバグを探すのではなく、コードの健全性を時間とともに向上させることを目的としたレビューを行うためのものである。

詳細な原典は references/ 配下に日本語訳で同梱している。本ファイルは要約とワークフローを示し、判断に迷ったら該当の参照ファイルを読むこと。

最上位の原則

レビュアーは、CL（変更）がシステム全体のコードの健全性を確実に向上させる状態に達したら、たとえ完璧でなくても承認に傾けるべきである。

これがすべての判断の起点になる。完璧なコードは存在しない。あるのはより良いコードだけである。求めるのは完璧ではなく継続的な改善であり、保守性・可読性・理解しやすさを向上させる変更を、些細な不満のために何日も止めてはならない。

ただし、システムのコードの健全性を確実に悪化させる変更を通してはならない（緊急事態を除く）。

判断基準の詳細・原則・対立の解消は references/standard.md を読むこと。