268検査を持つリポジトリの検査基盤を構築
登録済みコミット検査268件、静的検査ルール277件、独自ESLintルール15件
からなるリポジトリの検査基盤と、検査自体を試す146件のテストを構築
し、人のレビューだけに頼らずビルドで基準を守るようにした。
2025

状況.
参加ガイドに書いただけの基準は提案にとどまる。全員が同意しても、金曜
の小さな変更ではガイドが負ける。警告ゼロは善意以外の何かが支えなけれ
ば続かず、言語標準の静的検査だけでは、このコード特有の動かし方という
重要な規則まで届かなかった。

課題. 時間と記憶のあるレビュー担当者を待たず、違反がコミットを失敗さ
せるよう、大切な規則を実行可能にする必要があった。

行動.
検査基盤を構築した。274本の検査スクリプト中268本をコミットフックへ登
録し、277本のJavaScript検査、96本のShell、17本のPython検証を組み合わ
せた。マイグレーションを戻せるか、翻訳キーが両言語にあるか、登録ルー
トがOpenAPIにあるか、行内抑制が追加されていないかなど、汎用ツールの
対象外を扱う。独自ESLintルール15個でTypeScriptの社内方式を守る。fix:
で始まるコミットには、その修正なしで失敗するテストを必須とし、その不
具合に対する実行可能な回帰テストを用意した。壊れた検査はすべてを通し
て誰も気づかず、検査がないより悪いため、検査自体にも146テストを設け
た。

結果.
ブランチのプッシュ前に、自動検査が組み込まれた定型的な規則を確認する
ため、レビュー担当者は設計により多くの時間を割けるようになった。実際
のトレードオフとして、コミットは遅く、出来の悪い検査は対応に強い苛立
ちを生む。そうした経験があったため、146テストを設けた。

カテゴリー:
1DevOps	/ja/categories/devops/	engineer.company	70
1自動化・CI/CD	/ja/categories/automation/	engineer.company	70
1テスト・品質保証	/ja/categories/testing/	engineer.company	70
1技術面の統率	/ja/categories/technical-leadership/	engineer.company	70
1文書作成	/ja/categories/documentation/	engineer.company	70

サービス:
1DevOps・CI/CD自動化	/ja/services/devops-cicd/	engineer.company	70
1専用AIエージェント開発	/ja/services/ai-agents/	engineer.company	70
1技術面の統率・コンサルティング	/ja/services/technical-leadership/	engineer.company	70
1技術文書の作成	/ja/services/technical-documentation/	engineer.company	70

hこのページのウェブ版	URL:https://engineer.company/ja/portfolio/built-a-268-check-guard-engine-for-the-repo/	engineer.company	70
