Communitygithub.com

asset-diet

로컬 저장소의 미디어 자산(PNG/JPG/WebP/AVIF, SVG, MP4/WebM, GLB/GLTF)을 감사, 압축, 중복 제거 및 롤백하는 주문형 CLI 도구입니다.

asset-diet란 무엇인가요?

AssetDiet는 개발자가 로컬 저장소 내 미디어 자산의 크기를 줄이고 최적화할 수 있도록 도와주는 에페메럴(ephemeral) CLI 기반 도구입니다. 별도의 MCP 서버 등록 없이 `npx [email protected]` 명령어로 즉시 실행되며, Sharp(SVG는 SVGO, 동영상은 FFmpeg, 3D 모델은 glTF-Transform)를 통해 무손실 또는 고품질 압축을 수행합니다. `audit` 하위 명령어로 읽기 전용 감사를 먼저 실행하여 잠재적 용량 절감량과 중복 파일 그룹을 확인한 후, `optimize` 명령어로 안전하게 압축을 적용합니다. `balanced` 정책은 웹 전용 폴더에서 PNG/JPG를 WebP로 변환하고 코드 참조를 자동 마이그레이션하며, `safe` 정책은 확장자를 유지하고 앱 아이콘을 보호합니다. 모든 최적화는 원자적 백업(atomic backup)과 함께 수행되며, `restore` 명령어로 즉시 원본으로 복원할 수 있습니다. 이 도구는 Claude Code, Cursor, Codex 등 모든 AI 어시스턴트 환경에서 사용할 수 있으며, 사용자가 이미지, SVG, 동영상, 3D 자산의 감사, 압축, 중복 제거를 명시적으로 요청할 때만 트리거됩니다.

지원 대상~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)을 에페메럴 100% 로컬 CLI로 엄격히 사용하세요 (npx [email protected]) — 클라우드 업로드 없음, 채팅 세션에 영구적인 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 확장자가 필요합니다 — 순수 웹 폴더(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), 정확한 파일 확장자 유지, 소스 코드 임포트는 건드리지 않으며, 코드 참조가 0개인 중복 바이트 복사본만 제거합니다:
    # 선택적 드라이런 미리보기
    npx [email protected] optimize <targetPath> --policy safe --dry-run
    
    # 원자적 백업으로 실행 (.assetdiet/backups/<runId>/)
    npx [email protected] optimize <targetPath> --policy safe
    
  • balanced 정책 (웹 전용 .png/.jpg → .webp + 코드 참조 마이그레이션 — 먼저 확인 요청):
    npx [email protected] optimize <targetPath> --policy balanced --dry-run
    npx [email protected] optimize <targetPath> --policy balanced
    
    balanced 후 즉시 수정된 모든 .ts/.tsx/.jsx/.css/.html 임포트에 대해 git status 및 git diff를 검사하고 프로젝트의 빌드/타입체크를 실행하세요.

3단계: 즉시 롤백 및 .assetdiet/ Git 위생

  1. optimize가 출력한 Run ID를 저장하세요. 자산이 손상되었거나 임포트가 깨진 경우 한 명령어로 바이트 단위 원본을 복원합니다:
    npx [email protected] restore --run <runId> --path <targetPath>
    
  2. .assetdiet/ 백업을 Git에 커밋하지 마세요: .assetdiet/가 .gitignore에 나열되어 있는지 확인하세요 (또는 시각적/빌드 확인이 통과되고 사용자가 확인하면 .assetdiet/를 삭제하세요).

관련 스킬