Communitygithub.com

AssetDiet(オンデマンドローカルメディア監査・圧縮)

ローカルリポジトリ内のメディアアセット(PNG/JPG/WebP/AVIF、SVG、MP4/WebM、GLB/GLTF)を監査、圧縮、重複排除、ロールバックするオンデマンドCLIツールです。

AssetDiet(オンデマンドローカルメディア監査・圧縮) とは?

AssetDiet は、`npx [email protected]` という一時的な CLI として実行され、チャットセッションに永続的な MCP スキーマを追加せずに、ローカルリポジトリのメディアアセットを監査・圧縮・重複排除・ロールバックできます。ユーザーが明示的に画像、SVG、動画、3Dアセットの最適化を依頼した場合のみトリガーされます。まず読み取り専用の監査(audit)を実行し、圧縮による削減量や重複グループを表示した後、安全なポリシー(safe: 同一拡張子、ロスレス/SSIM≧0.98)で圧縮を実行します。また、圧縮前のバックアップを `.assetdiet/backups/<runId>/` に作成し、`restore` コマンドで即座にロールバック可能です。対応プラットフォームは Claude Code、Cursor、Codex などを含む、任意のエージェントまたはターミナル環境です。

対応~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/TursunboyevJahongir/tasted-skills/tree/HEAD/skills/asset-diet

お気に入りのAIに質問する

このエージェントスキルを事前に読み込んだ状態で新しいチャットを開きます。

ドキュメント

AssetDiet(オンデマンドローカルメディア監査・圧縮) は何をしますか?

092Abdullah/AssetDiet(npm: assetdiet-mcp)を、npx [email protected] を介して一時的な100%ローカルCLIとして厳密に使用します。クラウドへのアップロードは一切なく、チャットセッションに永続的な16ツールMCPスキーマの肥大化もありません。

1. 絶対的なガードレール

  1. MCPサーバーを絶対に登録しない: assetdiet setup や assetdiet mcp は絶対に実行しないでください。常にCLIサブコマンド(audit、scan、optimize、restore、doctor)を直接呼び出します。
  2. 監査済みバージョン([email protected])を固定する: 自動実行では固定されていない @latest を避け、サプライチェーンの動作が監査済みリリースと一致するようにします。
  3. 書き込み前に読み取り専用監査を実行する: リポジトリアセットを変更する前に、必ず最初に audit を実行し、潜在的な削減量と重複グループを表示します(ただし、ユーザーが明示的に --policy safe を即座に適用するよう要求した場合を除く)。
  4. Expo / React Native およびアプリアイコンの保護: Expo / React Native プロジェクト(app.json / app.config.ts)では、ネイティブアプリアイコン、スプラッシュスクリーン、通知アイコン、および静的な require('./foo.png') アセットは、多くの場合 .png 拡張子を維持する必要があります。純粋なWebフォルダ(public/、static/)を対象とし、ユーザーが明示的に .webp 変換を承認した場合を除き、--policy safe(同一拡張子、ロスレス/SSIM ≥ 0.98)を維持してください。

2. ステップバイステップのワークフロー

ステップ 1: 読み取り専用監査(ファイル変更なし)

# クイック3行スコアカードサマリー(合計サイズ、削減量、SHA-256重複グループ)
npx [email protected] audit <targetPath> --policy safe --summary

# ファイルごとの完全な内訳(または構造化フィルタリングのために --json を追加)
npx [email protected] audit <targetPath> --policy safe

ステップ 2: アトミックジャーナルとバックアップによる安全な最適化

  • safe ポリシー(デフォルト — 推奨): インプレースで圧縮(Sharp ロスレス/85、viewBox を保持する SVGO)、ファイル拡張子をそのまま維持し、ソースコードのインポートには一切触れず、コード参照がゼロの場合にのみ重複バイトコピーを削除します。
    # オプションのドライランによるプレビュー
    npx [email protected] optimize <targetPath> --policy safe --dry-run
    
    # アトミックバックアップ付きで実行(.assetdiet/backups/<runId>/)
    npx [email protected] optimize <targetPath> --policy safe
    
  • balanced ポリシー(Web限定 .png/.jpg → .webp + コード参照の移行 — 最初に確認を得ること):
    npx [email protected] optimize <targetPath> --policy balanced --dry-run
    npx [email protected] optimize <targetPath> --policy balanced
    
    balanced の実行後、直ちに git status と git diff で変更されたすべての .ts/.tsx/.jsx/.css/.html のインポートを確認し、プロジェクトのビルド/型チェックを実行します。

ステップ 3: 即時ロールバックと .assetdiet/ のGit管理

  1. optimize によって出力された Run ID を保存します。アセットが劣化したように見えたり、インポートが壊れたりした場合は、1つのコマンドでバイト単位のオリジナルを復元します。
    npx [email protected] restore --run <runId> --path <targetPath>
    
  2. .assetdiet/ のバックアップをGitにコミットしないでください: .assetdiet/ が .gitignore にリストされていることを確認するか(または、ビジュアル/ビルド検証が合格し、ユーザーが確認したら .assetdiet/ を削除してください)。

関連スキル