mcpField
M
matlab-exclude-files

matlab-exclude-files

github.com/matlab開発1.2k35 回インストール1 日前に更新
リポジトリ

matlab-exclude-files について

MATLAB ツールボックスのフォルダーを調べ、パッケージから除外するファイルを提案するスキルです。実在するファイルに該当する規則だけを示し、承認されるまで除外設定を書き込みません。

主な機能

  1. 01ツールボックスのファイルとフォルダーを調査
  2. 02検出した除外項目のみを提案
  3. 03既存の除外規則を確認
  4. 04提案ごとに根拠を提示
  5. 05承認後にのみファイルへ書き込み

活用シーン

  1. 01ツールボックスのパッケージ準備
  2. 02パッケージ上の懸念事項を確認
  3. 03既存の除外ファイルへ規則を追加

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/matlab/matlab-agentic-toolkit --skill matlab-exclude-files

インストール後、Claude Code で/matlab-exclude-filesを入力して読み込まれたか確認します。

同梱ファイルmanifest.yaml

詳細

matlab-exclude-files — 除外ファイル生成ツール

MATLAB ツールボックスのフォルダーを分析し、パッケージ化から除外すべきファイルを提案します。実際に存在するファイルのパターンだけを提案し、汎用テンプレートや定型文は提示しません。

使用する場合

  • ユーザーが無視ファイルの作成、またはパッケージ化からのファイルの除外を依頼した場合
  • ユーザーが「パッケージに含めるべきでないものは？」または「パッケージを整理したい」と尋ねた場合
  • matlab-build-toolbox の実行前に、無視ファイルが存在しない場合
  • matlab-assess-toolbox がパッケージ化に関する懸念（チェック 16）を指摘した後

使用しない場合

  • ユーザーが MATLAB プロジェクトからファイルを除外したい場合（パッケージからではない場合）— プロジェクト設定を使用します
  • ユーザーがツールボックスの範囲や公開 API を定義したい場合 — matlab-define-toolbox-api を使用します
  • toolbox.ignore がすでにプロジェクト全体を網羅している場合 — このスキルは「追加の除外項目はありません」と報告します

入力

  • toolbox_folder：ツールボックスのコンテンツフォルダーへのパス（デフォルト：toolbox/ または現在のディレクトリ）

ルール

  • 承認されるまでは読み取り専用：ユーザーから明示的な同意を得ずにファイルを書き込んではいけません。
  • 実際の情報に基づく提案のみ：スキャンで実際に見つかったファイルのパターンだけを提案します。一致するファイル／フォルダーが存在しないパターンには、「一般的に除外される」や「こちらも検討するとよい」としてであっても、決して言及したり含めたりしてはいけません。除外対象が見つからなかった場合は、その旨を伝えて終了します。
  • 重複なし：toolbox.ignore または package.ignore がすでに存在する場合は、まだ対象になっていない追加項目だけを提案します。
  • MATLAB のデフォルト設定を尊重：MATLAB がすでに自動除外するパターン（.git/、.svn/、.buildtool/、*.asv、resources/project/、*.prj）は、決して提案してはいけません。これらを提案内容や生成する無視ファイルに含めてはいけません。
  • 根拠を明記：提案ごとに、見つかった該当ファイルを具体的に示します。

検出可能なパターン

スキャンで該当ファイルが見つかった場合に限り、以下を提案します。

パターン除外する理由影響
*.DS_StoreOS メタデータで、ユーザーにとって有用ではないHIGH
Thumbs.dbWindows のサムネイルキャッシュHIGH
.vscode/VS Code の設定HIGH
.idea/JetBrains IDE の設定HIGH
*.log開発／テスト実行時のログファイルHIGH
*.origマージコンフリクトの残存ファイルHIGH
slprj/Simulink プロジェクトのキャッシュHIGH
codegen/MATLAB Coder の生成出力HIGH
*.mltbx以前にビルドされたパッケージHIGH
tmp/、temp/作業用ディレクトリHIGH
tests/、test/テストファイル（ツールボックスのフォルダー内にある場合）MEDIUM
buildUtilities/ビルドスクリプトMEDIUM
buildfile.mビルド自動化ファイル（ツールボックスのフォルダー内にある場合）MEDIUM
*.cpp、*.c、*.hMEX ソース（コンパイル済みの .mex* バイナリが存在する場合）MEDIUM
doc/internal/エンドユーザー向けではない内部ドキュメントMEDIUM
CHANGELOG.md、CONTRIBUTING.md開発者向けドキュメントMEDIUM
テストディレクトリ内の *.matテスト用フィクスチャMEDIUM
対応する .p が存在する .m ファイルソースを除外すると知的財産を保護できますが、pcode がヘルプを保持する設定で生成されていない場合は、help でのアクセスができなくなりますMEDIUM

ワークフロー

ステップ 1 — スキャン

ツールボックスのフォルダーを再帰的に検索します。すべてのファイルパスとフォルダー名を収集します。

ステップ 2 — 既存の設定を確認

フォルダー内に toolbox.ignore または package.ignore があるか確認します。存在する場合はその内容を読み、すでに対象となっているパターンを記録します。

ステップ 3 — 検出

スキャンで見つかった各ファイルについて、上の表にある既知の除外可能なパターンに一致するか確認します。実際に存在するファイルに一致するものだけを報告します。pcode の組み合わせについては、.p ファイルと同名の対応する .m ファイルが同じディレクトリにあるか確認します。

結果から除外するもの：

  • 既存の無視ファイルですでに対象となっているパターン
  • MATLAB がすでに自動除外するパターン（.git/、.svn/、.buildtool/、*.asv、resources/project/、*.prj）
Step 4 — 提示

新たに見つかった提案のみを表示します。つまり、存在していて、すでに除外されておらず、除外すべきファイルです。すでに処理済みの項目や見つからなかった項目は一覧に含めないでください。内部の推論、確認メモ、検出プロセスに関する説明は表示しないでください。提案は、名前付きのカテゴリ見出しごとにまとめます。

## Ignore Suggestions — [Toolbox Name]

### OS / IDE Metadata
| # | Pattern | Found | Reason |
|---|---------|-------|--------|
| 1 | *.DS_Store | 3 files | OS metadata not useful to end users |
| 2 | .vscode/ | 1 folder | IDE settings |

### Test Infrastructure
| # | Pattern | Found | Reason |
|---|---------|-------|--------|
| 3 | tests/ | 12 files | Test files inside toolbox folder |

### Source Protection
| # | Pattern | Found | Reason |
|---|---------|-------|--------|
| 4 | myFunc.m | paired with myFunc.p | Source alongside pcode — excluding protects IP but removes help text access |

新たな提案がない場合は、「追加で推奨する除外項目はありません。」とのみ記載してください。

pcode の提案には、次の注記を含めてください。

対応する .p ファイルがある .m ファイルを除外すると、ソースコードが配布されるのを防げます。ただし、ヘルプ情報を保持して pcode が生成されていない場合（ヘルプブロックを含む .m ファイルに対して pcode -inplace を実行していない場合）、エンドユーザーは help functionName を使用できません。

Step 5 — 質問

どの提案を含めますか？

A) すべて — 提案された項目をすべて含めます B) HIGH のみすべて — 影響度が HIGH の項目のみを含めます C) 選択 — 番号を指定して選択します（例：「1, 2, 4」） D) スキップ — ignore ファイルを作成または変更しません

Step 6 — 書き込み

選択したパターンをカテゴリごとにまとめ、MATLAB 形式のコメント（%）を付けて toolbox.ignore に作成または追記します。

注： MATLAB R2025a 以降では、toolbox.ignore により非推奨の警告が表示されます。希望する場合は、代わりにファイル名を package.ignore にすることを提案してください。

出力例：

% toolbox.ignore
% Files excluded from toolbox packaging

% OS metadata
*.DS_Store

% IDE settings
.vscode/

% Test files (not distributed to end users)
tests/

% Source excluded (distributed as pcode)
myFunc.m

チェックポイント

はい — 必ず提案を提示し、何かを書き込む前にユーザーの選択を待ちます。

主なルール

  • toolbox フォルダーに存在しないファイルを除外対象として提案しないでください
  • MATLAB のデフォルトの除外設定ですでに処理されているパターンを提案しないでください
  • 既存の ignore ファイルでパターンがカバーされている場合は、対象から除外してください
  • .p／.m のペアが見つかった場合は、pcode のトレードオフに関する説明を必ず表示してください
  • 生成するファイルのコメントには %（MATLAB の慣例）を使用します
  • 既存の ignore ファイルがあるフォルダーで再実行した場合は、追加項目のみを提案します

Copyright 2026 The MathWorks, Inc.

コメント

Markdown 対応