ソフトウェア開発者のタスクランナー：Bash スクリプトから Makefile まで

本稿は読者からの「もう一度読みたいです」というご要望を受けて、アーカイブより復刻・リニューアルいたしました。
ソフトウェア開発において、異なるリポジトリ間で共通する業務（依存関係のインストール、ビルド、リンター実行、テストなど）を効率的に処理するための手法を整理しました。

開発者の悩み：コマンドの呪文

各リポジトリには独自の技術スタックが存在しますが、共通して実行すべきタスクは多岐にわたります。

• 依存関係のインストール
• ソースコードのビルド
• コードのリンター（静的解析）チェック
• フォーマットの適用
• テストの走査
• データベースマイグレーションの実行
• デプロイと新バージョンの作成

しかし、ツールによって呼び出しコマンドは異なります。

rust fmt

mix deps.update

./gradlew build

mvn

npm run prettier

これらの複雑で覚えにくいコマンドを記憶させたくないのが本稿の目的です。
「コードをビルドする」「リンターを実行する」といった意図（インテンション）のみで動作する利便性の高いツールを探ります。

ツール選定の比較概観

古くからの Bash スクリプトから、現代的な

mise

just

各ツールの特徴と実装例を比較します。

1. シンプルな Bash スクリプト

よく使うコマンドをラップアップする小型のシェルスクリプトを作成し、コード操作に必要なタスクを統括できます。

実装例（Node.js/NPM 環境）

異なる環境の場合は適宜補填してください。

#!/usr/bin/env bash
set -e

# --- 関数定義 ---

function usage {
    # 使用方法の情報を出力
}

function install {
    # 依存関係をインストール
    npm run ci
}

function build {
    # ビルドプロセスを起動
    npm run build
}

function test {
    # テストスイートを実行
    npm run test:unit
    npx playwright
    
    # ※1 つのコマンドで複数ステップを実行可能
}

function format {
    # 下流コマンドへの引数隠蔽にも役立ちます
    npm run prettier --write
}

# --- メイン処理 ---

# コマンドライン引数が指定されていない場合
if [[ $# -lt 1 ]]; then
    usage
    exit 1
fi

TARGET=$1
case $TARGET in
    "help" )   usage ;;
    "install" ) install ;;
    "build" )   build ;;
    "test" )    test ;;
    "format" )  format ;;
    *)          fail "Unknown command '${TARGET}'"; usage; exit 1 ;;
esac

使用方法

1. リポジトリのルートディレクトリに保存（例：

   run

   ）
2. 実行権限を付与：

   chmod +x run

3. コマンド実行：

   run build

   、

   run lint

   、

   run test

   など

メリットと注意点

• 柔軟性が高い: 複雑なタスクやバリデーション（例：本番 DB 破壊防止）を追加可能。
• 抽出推奨: スクリプトが大きくなれば、関数を

  bin/

  ディレクトリなどに分離するのが慣習です。

2. Make

1970 年代に登場した古典的なビルド自動化ツールであり、ほぼすべての開発者マシンに標準搭載されています。

仕組み

現在のディレクトリ内に

Makefile

# ターゲット名：依存関係（空）
# インデント：必須はスペースではなく「タブ」です！
.PHONY: install build test format

install:
	npm run ci

build:
	npm run build

test:
	npm run test:unit
	npx playwright

format:
	npm run prettier --write

重要なポイント

.PHONY

ターゲットの役割

Makefile の先頭に以下のように宣言します。

.PHONY: install build test format

• 理由: Makefile に同名のファイルが存在する場合、

  make

  は「更新不要（up to date）」として無視してしまいます。
• 対策: 意図的にタスクを実行させるため、すべてのターゲットを

  .PHONY

  で宣言するのが推奨です。

タブ自動補完

いくつかのシェルでは Makefile のターゲットに対して自動補完をサポートします。

• zsh

  /

  fish

  : 設定なしで標準搭載されることが多い

• bash

  : scop/bash-make-autocomplete をインストールすることで対応可能

メリット・デメリット

• 強み: ファイルベースの依存関係管理や、高度な変数機能を持つ。
• 弱み: 構文（特にタブインデント）が厳格で、学習コストがある。

3. Just

make

.PHONY

特徴

• justfile

  をルートディレクトリに配置するだけで即座に動作します。
• 構文が直感的で、Bash や Makefile ユーザーにとって馴染みやすいです。

# justfile (Makefile と似ていますが、タブ不要な場合が多い)

install:
    npm run ci

build:
    npm run build

test:
    npm run test:unit
    npx playwright

format:
    npm run prettier --write

注意点

• 開発者マシンに標準搭載されていないため、一度インストールする必要があります（パッケージマネージャーから入手可能）。

4. Mise

開発者のための**「スイスアーミーナイフ」**として近年注目されているツールです。

• 機能: パッケージインストール、バージョン管理、環境変数設定、タスク実行まで統合
• 宣言形式: プロジェクトルートに

  mise.toml

  を配置して定義します。

[tasks.install]
description = "Install dependencies"
run = "npm ci"

[tasks.build]
description = "Build the application"
run = "npm run dev"

[tasks.test]
description = "Run unit and e2e tests"
run = "npm run test:unit && npx playwright"

[tasks.format]
description = "Format the code"
run = "npm run prettier --write"

• 拡張性: 単一ファイルから始まり、必要に応じてタスクファイルを分割したり、Bash スクリプトをラッパーとして組み合わせたりできます。

結論：導入をおすすめします

上記は、複数のリポジトリ間で共通かつ一貫した方法でコーディングタスクを実行するための選択肢です。

• 難易度: 導入は非常に簡単
• 効果: チームの品質生活（QoL）向上に直結する小さな施策
• 推奨: 明日のコーヒーを淹れながら、まずは一つ試してみてください。