用途:将一个包含杂乱媒体文件的目录整理成本项目内的标准化结构,强调与用户协作,确保组织方式符合需求。
主要能力与流程:
- 确定源目录:请用户提供待整理目录的绝对或相对路径,并确认路径有效可访问。
- 提出整理计划:使用 ls -R <source_directory> 查看内容;对含义不明的文件名主动询问用户;文件名含数字时确认其含义(如版本号 v... 或示例编号 no...)。默认子分类为 community-content、internal-demos、generated-examples、assets。根据项目 GEMINI.md 提出命名规范,默认 {YYYYMMDD}{分类}{描述}_{编号}.{后缀};其中 {YYYYMMDD} 须用 stat 命令取文件最后修改时间确定,而非文件名中的日期。生成旧路径到新路径的完整迁移计划,以 Markdown 表格或列表呈现,暂停并请求用户确认与修改意见,未获明确批准前不得继续。
- 执行迁移:批准后创建新子分类目录(如 mkdir -p ...),按批准计划逐个或小批量运行 mv 迁移文件;完成后清理源目录,可能删除空子目录和 .DS_Store 等系统垃圾文件,执行 rm -rf 前须与用户确认。
- 生成文档:为每个新分类目录生成 README.md,使用 skills/media-organizer/assets/readme.md.template 模板,简要描述分类并可附关键文件链接示例;更新父目录 README.md 反映新结构。
- 最终审查:通知用户整理、清理与文档化完成,用 ls 显示新目录结构,询问是否满意。
适用场景:需要按项目约定归档、分类和重命名媒体文件,并同步生成分类文档的整理工作流。
限制:资料未提供具体实现语言、依赖、安装命令、平台要求或收费信息;执行迁移与删除操作需用户明确确认。