本文へ移動

6言語に警告ゼロの基準を設定

Go、TypeScript、SQL、Python、Shell、Markdownの6言語に警告ゼロの品質基準を設け、pre‑commitフックで適用した。

6言語に適用する警告ゼロの基準

状況. 積み重なる警告は徐々に基準を損なう。指摘を無視するたび少しずつ基準が下がり、ビルドが40件出すようになると誰も読まず、本当の問題も背景の雑音の中に埋もれる。多言語コードでは、その雑音の発生源がさらに多かった。

課題. 各言語に共通する妥協のない基準を設け、問題を蓄積せず直す必要があった。

行動. 忙しい週には個人の注意に頼る方針は破れるため、ツールが適用する警告ゼロ方針を導入した。全指摘をエラーとし、逃げ込める警告区分を置かなかった。Goはgolangci‑lint、TypeScriptはESLint、SQLはSQLFluff、PythonはRuff、ShellはShellCheck、Markdownはmarkdownlintで、全体に同じ基準を設けた。行内抑制を禁じ、隠すのでなく修正を必須にした。pre‑commit・pre‑pushで静的検査とテストを実行し、対象の規則やテストで失敗した場合は、それぞれコミットまたはpushを止めるようにした。読みやすさを超えて膨張しないよう、関数・ファイル長の制限も設けた。

結果. 未消化の課題へ先送りせず発生源で修正し、ときどきの大掃除でなく、通常状態としてコードを整えた。言語によらず同じ基準を、意志力でなくツールが守るため、実際に維持できた。

  • 夕暮れに跳び上がる人のシルエット
    写真: Simedblack / Pixabay
  • 金色のコインに囲まれた白いクマのおもちゃ
    写真: MiGallery23 / Pixabay

この経験をお客様のプロジェクトに

「6言語に警告ゼロの基準を設定」を、お客様の組織の似た課題を考える出発点にしてください。この実績を支えたサービスを、お客様のプロジェクトにも提供できます。 取引先、予算、設計について、知識に基づく別の見解が必要なときに、同じ側に立って判断を支えます。

サービスを見る お問い合わせ

結果の背景を確かめる

この事例の状況、判断、結果をご覧ください。どの部分がお客様の制約の下でも生かせるか、どこに別の方法が必要かをご相談いただけます。 6言語に警告ゼロの基準を設定 — 6言語に適用する警告ゼロの基準

サービスを見る お問い合わせ

より多くの実績の 一つです — そのすべてをこのサイトで公開しています。

どの項目も、状況、課題、実施内容、変化という同じ構成で記載しています。

すべての実績を見る

必要な改善を定める

必要な判断、影響を受ける人々、すでに検討した選択肢をお知らせください。選択に伴う利点と不利益を明確にし、推奨案を文書に残せます。

料金を見る お問い合わせ

コードの整った状態を保ちたいですか?

「6言語に警告ゼロの基準を設定」の判断の背景についてお尋ねください。仕事内容を説明し、お客様のプロジェクトを検討できる担当者が対応します。

サービスを見る
welcome@engineer.company +45 50 10 61 84 デンマーク、コペンハーゲン
Go、TypeScript、SQL、Python、Shell、Markdownの6言語に警告ゼロの品質基準を設け、pre‑commitフックで適用した。のQRコード
このページを持ち歩くhttps://advisory.engineer.company/ja/portfolio/set-a-zero-warnings-bar-across-six-languages/