cli-tools

CLI ツールスキル

カタログに登録された77項目の CLI ツールをインストール、監査、更新し、おすすめします。

トリガー

• リアクティブ：command not found エラーを自動で解決します
• プロアクティブ：「環境をチェック」「Xをインストール」「ツールを更新」
• アドバイザリー：最新の代替ツールをおすすめします（grep→rg、find→fd、JSON→jq）

推奨する最新ツール

従来のツールよりも優先しておすすめします。例については references/preferred-tools.md を参照してください。

従来のツール	最新のツール	従来のツール	最新のツール
grep -r	rg	diff	difft
find	fd	time	hyperfine
JSON に対する grep	jq	cat	bat
YAML に対する sed	yq	cloc	tokei/scc
CSV に対する awk	qsv	セキュリティ用途の grep	semgrep
TOML に対する sed	dasel

ワークフロー

不足しているツールの解決

1. 診断：which <tool>、command -v <tool>、type -a <tool>
2. バイナリを対応付ける：references/binary_to_tool_map.md を確認します（rg→ripgrep、ansible→ansible-core、batcat→bat）
3. インストール：scripts/install_tool.sh <tool> install
4. 確認：which <tool> と <tool> --version を実行します。それでも見つからない場合は、hash -r を実行して PATH を確認します

診断の詳しい手順については、references/resolution-workflow.md を参照してください。

環境の監査

scripts/check_environment.sh audit . と scripts/detect_project_type.sh を実行し、次に references/project_type_requirements.md と照合して、プロジェクトの種類ごとのツール一覧を確認します。

一括更新

scripts/auto_update.sh（すべてのパッケージマネージャー）または scripts/install_tool.sh <tool> update（個別）。

トラブルシューティング

症状	対処方法
インストール済みなのに見つからない	hash -r を実行するか、ディレクトリを PATH に追加します
sudo を使えない	cargo install、pip install --user、バイナリの手動インストールを使います。Debian/Ubuntu では apt-get download と dpkg -x を使います
Debian では bat=batcat、fd=fdfind	~/.local/bin/ にシンボリックリンクを作成します

Docker での代替手段や権限に関する回避策については、references/troubleshooting.md を参照してください。

スクリプト

スクリプト	目的
scripts/install_tool.sh	インストール／更新／アンインストール／ステータス確認
scripts/auto_update.sh	パッケージマネージャーの一括更新
scripts/check_environment.sh	環境と PATH の監査
scripts/detect_project_type.sh	プロジェクトの種類を検出

参考資料

ファイル	目的
references/binary_to_tool_map.md	バイナリとカタログの対応表
references/project_type_requirements.md	プロジェクトの種類ごとのツール
references/preferred-tools.md	最新ツールの使用パターン
references/resolution-workflow.md	診断／インストール／確認の手順
references/troubleshooting.md	PATH、権限、代替手段