{"canonical_url":"https://engineer.company/ja/portfolio/built-a-268-check-guard-engine-for-the-repo/","content_markdown":"# 268検査を持つリポジトリの検査基盤を構築\n\n登録済みコミット検査268件、静的検査ルール277件、独自ESLintルール15件からなるリポジトリの検査基盤と、検査自体を試す146件のテストを構築し、人のレビューだけに頼らずビルドで基準を守るようにした。\n\n2025\n\n**状況.** 参加ガイドに書いただけの基準は提案にとどまる。全員が同意しても、金曜の小さな変更ではガイドが負ける。警告ゼロは善意以外の何かが支えなければ続かず、言語標準の静的検査だけでは、このコード特有の動かし方という重要な規則まで届かなかった。\n\n**課題.** 時間と記憶のあるレビュー担当者を待たず、違反がコミットを失敗させるよう、大切な規則を実行可能にする必要があった。\n\n**行動.** 検査基盤を構築した。274本の検査スクリプト中268本をコミットフックへ登録し、277本のJavaScript検査、96本のShell、17本のPython検証を組み合わせた。マイグレーションを戻せるか、翻訳キーが両言語にあるか、登録ルートがOpenAPIにあるか、行内抑制が追加されていないかなど、汎用ツールの対象外を扱う。独自ESLintルール15個でTypeScriptの社内方式を守る。fix:で始まるコミットには、その修正なしで失敗するテストを必須とし、その不具合に対する実行可能な回帰テストを用意した。壊れた検査はすべてを通して誰も気づかず、検査がないより悪いため、検査自体にも146テストを設けた。\n\n**結果.** ブランチのプッシュ前に、自動検査が組み込まれた定型的な規則を確認するため、レビュー担当者は設計により多くの時間を割けるようになった。実際のトレードオフとして、コミットは遅く、出来の悪い検査は対応に強い苛立ちを生む。そうした経験があったため、146テストを設けた。\n\n---\n\n- 役割: エンジニアリング責任者\n- カテゴリー: [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/)\n- サービス: [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/)\n\n\u003chttps://engineer.company/ja/portfolio/built-a-268-check-guard-engine-for-the-repo/\u003e\n","date_modified":"2026-11-12T05:34:23Z","description":"268件のコミット検査、277件の静的検査ルール、15件の独自ESLintルールと、検査自体の146テストを持つ検査基盤を構築した。","formats":{"gemtext":"https://engineer.company/ja/portfolio/built-a-268-check-guard-engine-for-the-repo/index.gmi","gopher":"https://engineer.company/ja/portfolio/built-a-268-check-guard-engine-for-the-repo/gophermap","html":"https://engineer.company/ja/portfolio/built-a-268-check-guard-engine-for-the-repo/","json":"https://engineer.company/ja/portfolio/built-a-268-check-guard-engine-for-the-repo/index.json","markdown":"https://engineer.company/ja/portfolio/built-a-268-check-guard-engine-for-the-repo/index.md","pdf":"https://engineer.company/ja/portfolio/built-a-268-check-guard-engine-for-the-repo/index.pdf"},"kind":"page","language":"ja","title":"268検査を持つリポジトリの検査基盤を構築","url":"https://engineer.company/ja/portfolio/built-a-268-check-guard-engine-for-the-repo/","version":1}