makefile-review

テスト

レビューのロジックを検証するには、pytest plugins/pensive/tests/skills/test_makefile_review.py を実行します。

Makefile レビューワークフロー

Makefile のベストプラクティス、重複排除、移植性を監査します。

クイックスタート

/makefile-review

使用する場面

• Makefile の変更または追加
• ビルドシステムの最適化
• 移植性の向上
• CI/CD パイプラインの更新
• 開発者エクスペリエンスの向上

使用しない場面

• 新しい Makefile の作成には、abstract:make-dogfood を使用します
• アーキテクチャのレビューには、architecture-review を使用します

必須の進捗項目

1. makefile-review:context-mapped
2. makefile-review:dependency-graph
3. makefile-review:dedup-candidates
4. makefile-review:tooling-alignment
5. makefile-review:evidence-logged
6. makefile-review:findings-verified

ワークフロー

ステップ 1：コンテキストの把握（makefile-review:context-mapped）

ベースラインを確認します。

pwd && git status -sb && git diff --stat

検証： git status を実行して、作業ツリーの状態を確認します。

Make 関連のファイルを探します。

rg -n "^include" -g'Makefile*'
rg --files -g '*.mk'

変更されたターゲット、プロジェクトの目標、ツール要件を記録します。

ステップ 2：依存関係グラフ（makefile-review:dependency-graph）

@include modules/dependency-graph.md

ステップ 3：重複排除の監査（makefile-review:dedup-candidates）

@include modules/deduplication-patterns.md

ステップ 4：移植性の確認（makefile-review:tooling-alignment）

@include modules/portability-checks.md

ステップ 5：証拠の記録（makefile-review:evidence-logged）

imbue:proof-of-work を使用して、コマンドの出力をファイル名と行番号の参照とともに記録します。

所見を要約します。

• 重要度（critical、major、minor）
• 予想される影響
• 推奨するリファクタリング
• フォローアップの担当者と日付

段階的な読み込み

必要に応じて追加のコンテキストを読み込みます。

ベストプラクティスと例： @include modules/best-practices.md

プラグインのドッグフードチェック： @include modules/plugin-dogfood-checks.md - Makefile の完全性分析、ターゲットの生成、ドッグフーディングによる検証。

出力形式

## Summary
Makefile review findings

## Context
- Files reviewed: [list]
- Targets changed: [list]

## Dependency Analysis
[graph and issues]

## Duplication Candidates
### [D1] Repeated command
- Locations: [list]
- Anchor: `verbatim source text at file:line`
- Recommendation: [pattern rule]

## Portability Issues
[cross-platform concerns]

## Missing Targets
- [ ] help
- [ ] format
- [ ] lint

## Recommendation
Approve / Approve with actions / Block

所見の根拠を検証（makefile-review:findings-verified）

所見を .review/findings.json に書き込み、引用検証ツール（Skill(imbue:review-core) のステップ 5）を実行します。検証ツールが却下した所見は削除するか、UNVERIFIED とラベル付けします。

完了条件

• コンテキストを把握した
• 依存関係を分析した
• 重複排除をレビューした
• 移植性を確認した
• 証拠を記録した
• 報告するすべての所見に、citation_verifier.py で確認された Location と逐語的な Anchor が含まれている（終了コード 0）、または未検証の所見が削除されているか UNVERIFIED とラベル付けされている

トラブルシューティング

よくある問題

Makefile が見つからない プロジェクトのルートに Makefile または *.mk ファイルが存在することを確認するか、パスを明示的に指定してください。

Include ディレクティブが解決されない rg -n "^include" -g'Makefile*' を実行して、インクルードの連鎖を手動で追跡してください。