check-tools

Check Tools - 開発環境バリデーター

インストールされている開発ツールとそのバージョンを、エコシステムごとにまとめて報告します。デフォルトでは、検証に失敗することなくすべてのツールを報告します。エコシステムの一部のみが存在することを想定する、多様な PaaS／コンテナー環境に適しています。

使用する場面

• タスクに必要なツールがコンテナーまたは環境にあることを確認する
• 依存関係の不足が原因の可能性があるビルド失敗を調査する
• システム要件を文書化する
• オンボーディング時に、開発環境の準備が整っていることを確認する

実行方法

# Fast check with exit code (0 = all required core tools present)
bash assets/check-tools.sh

# Development tools only
bash assets/environment-diagnostic.sh tools

# System info: hardware, mounts, processes
bash assets/environment-diagnostic.sh system

# Complete diagnostic (tools + system + package inventories), written to a file
bash assets/environment-diagnostic.sh full /path/to/report.txt

check-tools.sh がゼロ以外の終了コードを返すのは、必須のコアツール（python3、 pip、node、npm、java、gcc、git、curl、awk、grep、gzip、tar、make、sed）が 見つからない場合のみです。それ以外のツールはすべて報告されます（✅ 見つかった／⚠️ 任意で未インストール）が、 実行の失敗にはなりません。

エコシステム別の必須ツールと任意ツール

エコシステム	必須	任意
Python	python3, pip	python, uv, poetry, black, mypy, pytest, ruff
Node.js	node, npm	nvm, yarn, pnpm, eslint, prettier, chromedriver
Java	java	mvn, gradle
Go	—	go
Rust	—	rustc, cargo
C/C++	gcc	clang, cmake, ninja, conan
ユーティリティ	git, curl, awk, sed, grep, gzip, tar, make	jq, rg, tmux, yq, vim, nano

ツールごとの詳細なバージョン確認コマンドとインストールに関する説明は、 references/tool-categories.md にあります。

拡張

必須／任意の区分はこのファイルではなく、assets/check-tools.sh の check_required_tool／check_optional_tool の呼び出しにあります。必須ツールを変更するには、スクリプトを編集してください。