# 22静的検査のコミットゲートを構築

HTML、CSS、JavaScript、Python、YAML、Markdown、Shell、リンク、綴り、秘密情報、組版を対象に、1行で説明できる検査22個と詳しい説明が必要な検査5個からなるコミットゲートを構築し、警告扱いや行内抑制を認めない方針にした。

8月 2026

状況. 参加ガイドは提案にとどまり、金曜の小さな変更では負ける。1人のプロジェクトではレビュー担当者もおらず、書いた本人が自分に最も異議を唱えたくない瞬間に、本番との唯一の防壁となるため、さらに深刻だった。

課題. 気づかれるのを待たず違反でコミットを失敗させる、実行可能な基準が必要だった。

行動. 全指摘をエラーにする22の静的検査を整え、生成器にも警告を失敗へ昇格させ、非推奨警告でも停止させた。HTML、CSS、JavaScript、Python、YAML、Markdown、Shell、綴り、秘密情報、リンクを検査する。さらに、両テーマの多層面の層数一致、写真表示幅が原画素の半分以内、私的なパス・ホスト名の非混入、3言語の文体、Markdown・代替プロトコル形式の存在など、汎用ツールにない固有規則も設けた。ignoreコメント、disable指定、フック回避、検出逃れの改名など、行内抑制と迂回を全面禁止した。既存の失敗も言い訳にせず、導入していない不備でも検出した回で修正することを、規則の実効性を保つ条件にした。

結果. コミット前に機械が定型的な異議を出し、このプロジェクト唯一のレビュー担当となった。コミットは遅く、出来の悪い検査への対応には強い苛立ちがあるという費用も隠さず記した。そのため後に、検査自体を整形・静的検査の対象にした。

役割: ビルド・リリースエンジニア
=> /ja/categories/frontend/ カテゴリー: フロントエンド開発
=> /ja/categories/devops/ カテゴリー: DevOps
=> /ja/categories/automation/ カテゴリー: 自動化・CI/CD
=> /ja/categories/testing/ カテゴリー: テスト・品質保証
=> /ja/categories/python/ カテゴリー: Python
=> /ja/categories/documentation/ カテゴリー: 文書作成
=> /ja/services/devops-cicd/ サービス: DevOps・CI/CD自動化
=> /ja/services/ai-agents/ サービス: 専用AIエージェント開発
=> /ja/services/product-strategy/ サービス: プロダクト戦略・要件定義
=> /ja/services/technical-documentation/ サービス: 技術文書の作成

=> https://engineer.company/ja/portfolio/built-a-22-linter-commit-gate/ このページのウェブ版
