本文へ移動
cccskills
無料GitHub で公開

make

GNU Make / Makefile リファレンス。ターゲット、prerequisite、order-only、変数展開、自動変数、pattern rule、.PHONY、-j 並列・再帰 make、増分ビルド。

Rust / Cargo / xtask、Node.js / pnpm / Turborepo、Git hooks / CI との責務分離と開発コマンド共通化。Makefile 設計・レビュー、Bash サンプル、診断スクリプト。

インストール方法を見る

含まれるファイル(129)

  • SKILL.md11.2 KB
  • references/architecture/command-contracts.md10.5 KB
  • references/architecture/README.md660 B
  • references/architecture/responsibility-boundaries.md7.9 KB
  • references/architecture/selection-and-migration.md9.2 KB
  • references/execution/diagnostics-and-exit-codes.md4.6 KB
  • references/execution/gnu-posix-bsd-compatibility.md4.7 KB
  • references/execution/parallel-and-recursive-make.md5.6 KB
  • references/execution/README.md772 B
  • references/execution/special-targets-and-defaults.md4.4 KB
  • references/fundamentals/patterns-includes-and-functions.md6.9 KB
  • references/fundamentals/README.md1.1 KB
  • references/fundamentals/recipes-and-shell.md6.5 KB
  • references/fundamentals/rules-and-prerequisites.md3.5 KB
  • references/fundamentals/variables-and-expansion.md6.1 KB
  • references/maintenance/README.md458 B
  • references/maintenance/sources-and-compatibility.md7.9 KB
  • references/maintenance/troubleshooting.md7.8 KB
  • references/node/package-scripts-and-mixed-repos.md9.5 KB
  • references/node/README.md315 B
  • references/operations/parallelism-and-recovery.md9.5 KB
  • references/operations/README.md562 B
  • references/operations/safety-and-portability.md12.4 KB
  • references/quality/ci-hooks-and-cache.md13.4 KB
  • references/quality/README.md395 B
  • references/rust/crate-and-workspace-profiles.md12.4 KB
  • references/rust/README.md637 B
  • references/rust/xtask-and-validation.md7.6 KB
  • samples/ci.md6.6 KB
  • samples/ci/azure-pipelines.yml.example3.1 KB
  • samples/ci/github-actions.yml.example3.5 KB
  • samples/incremental-build.md6.4 KB
  • samples/mixed.md8.8 KB
  • samples/node-pnpm.md7.8 KB
  • samples/plans.md6.9 KB
  • samples/plans/mixed-repo-verify-delegation.json12.3 KB
  • samples/plans/rust-crate-thin-makefile.json10.3 KB
  • samples/projects/incremental-build/.gitignore8 B
  • samples/projects/incremental-build/Makefile4.7 KB
  • samples/projects/incremental-build/src/01-intro.txt149 B
  • samples/projects/incremental-build/src/02-setup.txt240 B
  • samples/projects/incremental-build/src/03-usage.txt199 B
  • samples/projects/mixed/.gitignore238 B
  • samples/projects/mixed/Cargo.lock151 B
  • samples/projects/mixed/Cargo.toml56 B
  • samples/projects/mixed/crates/codegen/Cargo.toml125 B
  • samples/projects/mixed/crates/codegen/src/main.rs2.9 KB
  • samples/projects/mixed/Makefile3.4 KB
  • samples/projects/mixed/package.json598 B
  • samples/projects/mixed/packages/web/package.json216 B
  • samples/projects/mixed/packages/web/src/index.mjs1.5 KB
  • samples/projects/mixed/packages/web/test/index.test.mjs698 B
  • samples/projects/mixed/pnpm-lock.yaml134 B
  • samples/projects/mixed/pnpm-workspace.yaml27 B
  • samples/projects/mixed/scripts/build.mjs3.1 KB
  • samples/projects/mixed/scripts/clean.mjs4.4 KB
  • samples/projects/mixed/scripts/lint.mjs3.2 KB
  • samples/projects/node-pnpm/.gitignore39 B
  • samples/projects/node-pnpm/Makefile2.5 KB
  • samples/projects/node-pnpm/package.json663 B
  • samples/projects/node-pnpm/packages/cli/package.json280 B
  • samples/projects/node-pnpm/packages/cli/src/index.mjs551 B
  • samples/projects/node-pnpm/packages/cli/test/index.test.mjs344 B
  • samples/projects/node-pnpm/packages/core/package.json217 B
  • samples/projects/node-pnpm/packages/core/src/index.mjs699 B
  • samples/projects/node-pnpm/packages/core/test/index.test.mjs625 B
  • samples/projects/node-pnpm/pnpm-lock.yaml2.2 KB
  • samples/projects/node-pnpm/pnpm-workspace.yaml27 B
  • samples/projects/node-pnpm/scripts/build.mjs3.1 KB
  • samples/projects/node-pnpm/scripts/clean.mjs4.1 KB
  • samples/projects/node-pnpm/scripts/lint.mjs3.1 KB
  • samples/projects/node-pnpm/turbo.json247 B
  • samples/projects/rust-crate/.gitignore171 B
  • samples/projects/rust-crate/Cargo.lock167 B
  • samples/projects/rust-crate/Cargo.toml438 B
  • samples/projects/rust-crate/Makefile2.0 KB
  • samples/projects/rust-crate/scripts/check.sh679 B
  • samples/projects/rust-crate/scripts/doctor.sh1.9 KB
  • samples/projects/rust-crate/scripts/help.sh1.5 KB
  • samples/projects/rust-crate/scripts/lib.sh1.8 KB
  • samples/projects/rust-crate/scripts/verify.sh770 B
  • samples/projects/rust-crate/src/lib.rs936 B
  • samples/projects/rust-crate/tests/integration.rs95 B
  • samples/projects/rust-workspace-xtask/.cargo/config.toml627 B
  • samples/projects/rust-workspace-xtask/.gitignore171 B
  • samples/projects/rust-workspace-xtask/Cargo.lock278 B
  • samples/projects/rust-workspace-xtask/Cargo.toml2.2 KB
  • samples/projects/rust-workspace-xtask/crates/cli/Cargo.toml186 B
  • samples/projects/rust-workspace-xtask/crates/cli/src/main.rs778 B
  • samples/projects/rust-workspace-xtask/crates/core/Cargo.toml341 B
  • samples/projects/rust-workspace-xtask/crates/core/src/lib.rs713 B
  • samples/projects/rust-workspace-xtask/xtask/Cargo.toml468 B
  • samples/projects/rust-workspace-xtask/xtask/src/main.rs9.2 KB
  • samples/README.md1.4 KB
  • samples/rust-crate.md7.0 KB
  • samples/rust-workspace-xtask.md7.8 KB
  • scripts/bin/inspect-repo.mjs9.4 KB
  • scripts/bin/lib/apply.mjs7.2 KB
  • scripts/bin/lib/args.mjs949 B
  • scripts/bin/lib/exec-safe.mjs5.7 KB
  • scripts/bin/lib/paths.mjs5.1 KB
  • scripts/bin/lib/plan.mjs20.4 KB
  • scripts/bin/lib/result.mjs5.0 KB
  • scripts/bin/lib/scan.mjs3.6 KB
  • scripts/bin/preview-sample.mjs20.0 KB
  • scripts/bin/run-checks.mjs11.8 KB
  • scripts/bin/validate-plan.mjs4.0 KB
  • scripts/bin/verify-layout.mjs9.4 KB
  • scripts/inspect.md8.9 KB
  • scripts/make-commands.md6.0 KB
  • scripts/plan-and-preview.md22.7 KB
  • scripts/README.md861 B
  • scripts/verify.md23.1 KB
  • tests/apply.test.mjs2.9 KB
  • tests/eval-cases.json3.5 KB
  • tests/exec-safe.test.mjs3.6 KB
  • tests/fixtures/dummy-secrets/dot-env.fixture49 B
  • tests/help-contract.test.mjs2.8 KB
  • tests/helpers.mjs1.9 KB
  • tests/inspect-repo.test.mjs6.6 KB
  • tests/preview-sample.test.mjs23.1 KB
  • tests/README.md7.8 KB
  • tests/run-checks.test.mjs18.4 KB
  • tests/sample-plans.test.mjs3.4 KB
  • tests/sample-projects.test.mjs4.1 KB
  • tests/sample-scripts.test.mjs9.1 KB
  • tests/secrets-fixture.test.mjs2.1 KB
  • tests/validate-plan.test.mjs17.3 KB
  • tests/verify-layout.test.mjs6.6 KB

SKILL.md(原文)

インストールする前に、エージェントに与えられる指示の中身を確認できます。

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 とは別の対象であることに注意する。

ディレクトリ構成

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 の公式仕様が要求するものではない。

探索手順

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

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

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

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 の責務分離が適切か静的に診断して」

関連スキルとの使い分け

  • rust — Cargo・rustc・rustdoc 等 Rust 言語・ツールチェーン全体の API リファレンスを担当。make の references/rust/ は Cargo 標準機能と xtask パターンの Make 文脈での使い分けのみを扱い、Rust 言語仕様は複製しない
  • turborepo — Turborepo 自体のタスクグラフ・キャッシュ・パイプライン定義を担当。make の references/node/ は Turborepo への委譲境界のみを扱う
  • lefthook — Git hooks の設定・実装を担当。make の references/quality/ は hooks と CI が同じコマンド契約を共有する設計指針のみを扱う

いずれもスキル名による探索を前提とし、単独インストール時に壊れる兄弟ディレクトリへの相対リンクは使わない。

レビュー

まだレビューはありません。使ってみた感想をお寄せください。

同じリポジトリのスキル

概要と使いどころ

amd-rocm

無料日本語概要

AMD ROCm / HIP GPU コンピューティングリファレンス。 hipMalloc, hipLaunchKernelGGL, HIP Graph, HIPRTC, hipify, rocBLAS, MIOpen, RCCL, rocprofv3, amd-smi, rocminfo, CDNA1-4 / RDNA1-4, MI300 / MI350, gfx942, Matrix Core, wave32/64。

Fandhe-AI/agent-reference-skills42026年10月11日 更新

android-architecture

無料日本語概要

Android アプリ開発 (Kotlin) の推奨アーキテクチャリファレンス。 Jetpack, androidx, UI layer, Domain layer, Data layer, state holder, UDF, SSOT, オフラインファースト, モジュール化, ViewModel, viewModelScope, SavedStateHandle, Lifecycle, repeatOnLifecycle, collectAsStateWithLifecycle, LiveData, Hilt による DI, Paging 3 によるページング処理。

Fandhe-AI/agent-reference-skills42026年10月11日 更新

android-background-work

無料日本語概要

Android アプリ開発 (Kotlin) のバックグラウンド・非同期処理リファレンス。 Jetpack androidx WorkManager: Worker, CoroutineWorker, WorkRequest, Constraints, WorkInfo, WorkContinuation, expedited work, テスト。 Service: フォアグラウンドサービス, バウンドサービス, AIDL, Messenger。 AlarmManager, PendingIntent, BroadcastReceiver, JobScheduler, Doze。 Kotlin コルーチン, Flow, StateFlow, SharedFlow, Channel。

Fandhe-AI/agent-reference-skills42026年10月11日 更新

android-build-gradle

無料日本語概要

Android アプリ開発 (Kotlin) の Gradle ビルドシステムリファレンス。 Android Gradle Plugin (AGP), Kotlin DSL (build.gradle.kts), version catalog, KSP, R8/ProGuard, App Bundle, baseline profile。

Fandhe-AI/agent-reference-skills42026年10月11日 更新

android-compose-components

無料日本語概要

Android Jetpack Compose (Kotlin) の androidx Material3 コンポーネントリファレンス。 Button, IconButton, FloatingActionButton, Checkbox, Switch, Slider, TextField, SearchBar, DropdownMenu, Chip, DatePicker, TimePicker, Card, Scaffold, Dialog, BottomSheet, TopAppBar, NavigationBar, NavigationRail, Tab, Snackbar, ProgressIndicator, Badge, Icon, MaterialTheme, ColorScheme, Typography, Shapes。

Fandhe-AI/agent-reference-skills42026年10月11日 更新

Android Jetpack Compose (Kotlin) のアニメーション・描画リファレンス。 androidx.compose.animation / graphics API。 AnimatedVisibility, AnimatedContent, animate*AsState, Animatable, AnimationSpec, Canvas, DrawScope, Brush, Path, Color, Image。

Fandhe-AI/agent-reference-skills42026年10月11日 更新

Fandhe-AI のスキルをすべて見る

このスキルの問題を報告する