AgentSkillsCN

mp3-fix-comments

通过移除 iTunes 归一化数据和陈旧的 ID3v1 注释帧，同时保留 Songs-DB_Custom1，解决 MP3 注释字段的冲突。支持单个文件模式与批量目录模式。为确保安全，始终默认执行干运行。

SKILL.md
--- frontmatter
name: mp3-fix-comments
description: Fix MP3 comment field conflicts by removing iTunes normalization data and stale ID3v1 comment frames while preserving Songs-DB_Custom1. Supports single file and batch directory mode. Always defaults to dry-run for safety.
argument-hint: <file.mp3 | --batch dir> [--apply]
allowed-tools: Bash, Read

Fix comment field conflicts in MP3 files. This removes problematic COMM frames (ID3v1 Comment, empty-description XXX) while preserving Songs-DB_Custom1 fields used by MediaMonkey.

Argument Handling

The arguments map directly to the Python script:

ExampleBehavior
song.mp3Dry-run on a single file (shows what would change)
song.mp3 --applyApply changes to a single file
--batch /music/dirDry-run on all MP3s recursively in directory
--batch /music/dir --applyApply changes to all MP3s in directory

Execution

Run the following command with the user-provided arguments:

code
python /workspaces/mako-sync/python/fix_comments.py $ARGUMENTS

Instructions

  • •Default is always dry-run. If the user did not pass --apply, emphasize that no changes were made and show what would happen.
  • •When --apply is used, confirm that changes were applied and summarize what was removed vs preserved.
  • •For batch mode, report the total number of files scanned and how many needed fixing.
  • •After a dry-run, prompt the user: "Run again with --apply to make these changes."
  • •After applying fixes, suggest running /mp3-diagnose on the file to verify the result.
  • •Warn clearly if batch mode with --apply will modify many files.