GNU Make / Makefile リファレンス

GNU Make / Makefile の仕様、設計、実装、運用、検証を扱う参照 Skill。出典基準は GNU Make Manual 4.4.1（Edition 0.77, 2023-02-26）。ローカル検証は GNU Make 3.81（macOS）で行っており、 3.82+ / 4.x 専用機能（

.RECIPEPREFIX

、

.ONESHELL

、

.WAIT

等）は該当ページ・サンプルに最低バージョンを明記する。 Make 自動化 SaaS・CMake・cargo-make とは別の対象であることに注意する。

ディレクトリ構成

text

skills/make/
  SKILL.md
  references/
    architecture/
      README.md
      responsibility-boundaries.md
      command-contracts.md
      selection-and-migration.md
    fundamentals/
      README.md
      rules-and-prerequisites.md
      variables-and-expansion.md
      patterns-includes-and-functions.md
      recipes-and-shell.md
    execution/
      README.md
      special-targets-and-defaults.md
      parallel-and-recursive-make.md
      diagnostics-and-exit-codes.md
      gnu-posix-bsd-compatibility.md
    rust/
      README.md
      crate-and-workspace-profiles.md
      xtask-and-validation.md
    node/
      README.md
      package-scripts-and-mixed-repos.md
    quality/
      README.md
      ci-hooks-and-cache.md
    operations/
      README.md
      safety-and-portability.md
      parallelism-and-recovery.md
    maintenance/
      README.md
      sources-and-compatibility.md
      troubleshooting.md
  samples/
    README.md
    incremental-build.md
    rust-crate.md
    rust-workspace-xtask.md
    node-pnpm.md
    mixed.md
    ci.md
    plans.md
    projects/                        # 動く例の正本
      incremental-build/             # Make がファイル依存関係を直接管理する例
      rust-crate/                    # 薄い Makefile + Bash help/doctor/check/verify（Node 不要）
      rust-workspace-xtask/          # Makefile なし。cargo xtask が正本
      node-pnpm/                     # pnpm workspace + Turborepo 委譲
      mixed/                         # Rust + Node の受け渡しのみ Make が仲介
    ci/                              # 非アクティブな CI テンプレート（.example）
    plans/                           # 承認前の適用計画サンプル（JSON）
  scripts/
    README.md
    make-commands.md
    inspect.md
    plan-and-preview.md
    verify.md
    bin/                             # Claude が明示的に実行する補助 CLI（Node.js 標準ライブラリのみ）
      inspect-repo.mjs
      validate-plan.mjs
      preview-sample.mjs
      verify-layout.mjs
      run-checks.mjs
      lib/
  tests/
    README.md
    helpers.mjs
    fixtures/
    eval-cases.json
    *.test.mjs

公式仕様と独自設計の区別

references/

の各ページは次の3種類を明示的に分けて記述する。

Source-backed behavior — GNU Make Manual 4.4.1 等、一次情報に基づく仕様。出典 URL・対象版・確認日付き（一覧は references/maintenance/sources-and-compatibility.md）
Design guidance — この Skill が提案する構成・判断基準。採用条件・根拠・トレードオフ付き
Example contract —
```
samples/
```
内だけで定義したコマンド名・JSON 形式・終了コード・ディレクトリ構成

help

doctor

setup

check

fix

verify

clean

という公開コマンドの共通化、および「入口は複数でも実処理の定義は一つ」という設計は、この Skill 独自の Design guidance であり、GNU Make・Cargo・Anthropic の公式仕様が要求するものではない。

探索手順

参照だけでよい場合（consult、既定の使い方）は、下記マッピング表でタスクに対応するカテゴリを探し、そのカテゴリの
```
README.md
```
で目的のページを特定して Read する。外部プログラムは実行しない
既存構成の診断・計画・検証が必要な場合は「利用パターン」の表で consult 以外のどの段階かを確認し、対応する
```
scripts/*.md
```
の手順に従う
安全上の制約は必ず references/operations/safety-and-portability.md で確認する

タスク → カテゴリマッピング

タスク	カテゴリ	参照 README
Make と Cargo/xtask/Turborepo/CI の責務分離、コマンド契約、Make 採用可否・移行の判断基準を知りたい	architecture	references/architecture/README.md
target / prerequisite / recipe、order-only prerequisite、変数展開（ `=` `:=` `?=` `+=` ）、自動変数、Make と shell の `$` の区別を調べる	fundamentals	references/fundamentals/README.md
pattern rule、include、条件分岐、レシピと shell（tab / `.RECIPEPREFIX` / `.ONESHELL` ）を調べる	fundamentals	references/fundamentals/README.md
`.PHONY` ・ `.DEFAULT_GOAL` 等の特殊ターゲット、 `-j` 並列・再帰 make、 `-n` / `-q` 診断、GNU/POSIX/BSD 互換性を調べる	execution	references/execution/README.md
単一 crate / workspace / virtual workspace の profile、fmt/clippy/test/doc の使い分け、cargo xtask の採否を調べる	rust	references/rust/README.md
pnpm workspace、package.json scripts、Turborepo への委譲、Rust+Node 混在の責務境界を調べる	node	references/node/README.md
Git hooks と CI の共通コマンド契約、パイプライン定義とマージ保護の違い、キャッシュ・外部状態の境界を調べる	quality	references/quality/README.md
consult/audit/plan/apply/verify の安全境界、再実行可能な setup、並列 worktree 分離、clean の対象範囲を調べる	operations	references/operations/README.md
出典台帳、GNU Make のよくある失敗パターンと診断手順を調べる	maintenance	references/maintenance/README.md
動くサンプル（増分ビルド、Rust crate/workspace、Node、混在、CI テンプレート、適用計画）を見たい	samples	samples/README.md
Claude が使う調査・計画検証・プレビュー・検証スクリプトの実行方法を知りたい	scripts	scripts/README.md
補助スクリプトの回帰テスト・終了コード契約・eval-cases を知りたい	tests	tests/README.md

利用パターン

参照しただけでは対象ファイルを変更せず、外部プログラムも自動実行しない。Skill を読み込んだこと自体は適用の承認ではない。

パターン	内容	使う script
consult	設計・レビュー中の参照（既定）	なし。references / samples / scripts の文書のみ読む
audit	利用者が指定した対象の静的診断。書き換え・依存導入・build は行わない	`inspect-repo.mjs` （ `--root` 必須）
plan	適用案・変更対象・検証計画の提示。対象ファイルは変更しない	`validate-plan.mjs` 、 `preview-sample.mjs` （既定は書き込まない）
apply	利用者が別途承認した範囲だけの適用。既存ファイルの編集は Skill 独自のパッチ適用エンジンではなく通常の編集ツールで行う	サンプル導入のみ `preview-sample.mjs --apply --plan <計画> --approve <planDigest>` （承認した計画ファイルと一致する場合だけ、明記したファイルを書き込む）
verify	承認済みの検証。静的整合性確認と実コマンド実行を分離する	`verify-layout.mjs` 、 `run-checks.mjs` （既定 dry-run。 `--execute` は利用者が確認した計画の `--approve <planDigest>` と各 check の `approved:true` が揃う場合のみ）

安全上の最小ルール

不審なリポジトリで
```
make -n
```
/
```
make -q
```
を安全な静的解析の代わりに使わない（設定読込時のコード実行がありうる）
```
.env
```
等の秘密情報の値を表示・ログ出力・JSON へ混入させない
ツールの自動導入、sudo、hooks / CI の回避を行わない
環境不足・未実行・非該当（
```
BLOCKED
```
/
```
SKIPPED
```
/
```
NOT_APPLICABLE
```
）を
```
PASS
```
に丸めない

詳細は references/operations/safety-and-portability.md を参照。

補助スクリプトのパス

scripts/bin/*.mjs

は Skill 設置位置からの相対パスで解決する。導入形態（upstream

skills/make/

、

.agents/skills/make/

、

.claude/skills/make/

の実体・symlink、グローバル導入）によって Skill 自身の絶対パスは変わるため、実行時は

<skill-dir>

をその時点の実際の Skill 設置先に置き換える。

bash

node <skill-dir>/scripts/bin/inspect-repo.mjs --root /path/to/target-repo --json

対象 root は必ず

--root

で明示する。

${CLAUDE_SKILL_DIR}

のような置換は使わない（外部 shell に常に存在する環境変数ではない）。補助 CLI は Node.js 標準ライブラリのみで動作するが、これは Skill 側の依存であり、利用者プロジェクトに採用するサンプル（

rust-crate

等）自体が Node.js を必要とするわけではない。

利用例

「make を参考に、この Rust crate の Makefile と検証コマンドの改善計画を作って」
「このリポジトリの Makefile を GNU Make の仕様に照らしてレビューして、
```
.PHONY
```
の抜けがないか教えて」
「Rust + Node の混在リポジトリで、Make・Cargo・Turborepo・CI の責務分離が適切か静的に診断して」

make

NPX Install

SKILL.md Content

GNU Make / Makefile リファレンス

ディレクトリ構成

公式仕様と独自設計の区別

探索手順

タスク → カテゴリマッピング

利用パターン

安全上の最小ルール

補助スクリプトのパス

利用例

関連スキルとの使い分け

make

NPX Install

SKILL.md Content

GNU Make / Makefile リファレンス

ディレクトリ構成

公式仕様と独自設計の区別

探索手順

タスク → カテゴリ マッピング

利用パターン

安全上の最小ルール

補助スクリプトのパス

利用例

関連スキルとの使い分け

タスク → カテゴリマッピング