智能文件归档助手

解决的痛点：文件管理的混乱

下载目录、桌面或项目文件夹往往成为一个“临时堆放场”，充斥着从各处获取的文档、图片、代码片段、安装包和媒体文件。手动归类不仅耗时，还容易遗漏或放错，导致重要文件难以检索。对于需要频繁处理多种文件类型的知识工作者和开发者来说，这种无序状态会拖慢工作流。

核心工作能力与流程

file-organizer 技能旨在将这一步骤自动化。它不是一个简单的移动脚本，而是一个具备规划和交互确认能力的代理。

1. 智能扫描与分析：使用 Glob 模式或 Bash 命令，技能首先会列出目标文件夹内的所有文件（默认深度为1层，可通过 --recursive 递归），并分析每个文件的扩展名、修改日期或大小。
2. 多模式归类规划：根据用户指令，它能采用三种主要策略：

按文件类型（默认）：将文件映射到如“文档”、“图片”、“代码”等预定义类别。
按修改日期（--mode date）：创建如 2023/09/ 的时间层级目录结构。
* 自定义规则：用户可提供扩展名到自定义文件夹名的映射，实现高度个性化的整理。

1. 安全的预览与确认机制：这是关键步骤。在执行任何文件操作前，技能会生成一份详细的整理计划，列出每个类别的文件数量及目标路径。用户必须审查并确认后，实际移动或复制操作才会进行。这避免了误操作。
2. 执行与报告：确认后，技能创建必要的子目录，移动或复制文件，并最终生成一份包含统计数据的整理报告。

重要注意事项与边界

• 工作深度：默认只处理目标文件夹根目录下的文件，不递归子文件夹。需要处理深层结构时，应明确要求使用 --recursive。
• 安全策略：遇到重名文件时，技能会通过追加序号（如 _1）来解决，而非覆盖。对于以 . 开头的隐藏文件，默认会跳过。
• 资源与权限：超大文件（>500MB）的移动会触发确认提示。无权限操作的文件会被跳过并在报告中注明。
• 操作模式：支持移动（默认）、复制（--copy）两种模式。整理完成后，源目录中的空文件夹默认保留，除非用户明确要求清理。

总之，它是一个谨慎、透明的文件整理助手，通过“计划-确认-执行”的流程来保证整理过程的可控性。