# 268検査を持つリポジトリの検査基盤を構築

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

2025

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

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

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

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

---

- 役割: エンジニアリング責任者
- カテゴリー: [DevOps](https://engineer.company/ja/categories/devops/), [自動化・CI/CD](https://engineer.company/ja/categories/automation/), [テスト・品質保証](https://engineer.company/ja/categories/testing/), [技術面の統率](https://engineer.company/ja/categories/technical-leadership/), [文書作成](https://engineer.company/ja/categories/documentation/)
- サービス: [DevOps・CI/CD自動化](https://engineer.company/ja/services/devops-cicd/), [専用AIエージェント開発](https://engineer.company/ja/services/ai-agents/), [技術面の統率・コンサルティング](https://engineer.company/ja/services/technical-leadership/), [技術文書の作成](https://engineer.company/ja/services/technical-documentation/)

<https://engineer.company/ja/portfolio/built-a-268-check-guard-engine-for-the-repo/>
