# File Organizer

> File Organizer

- Skill: `ntygod/file-organizer` (Agent Skill, multi-file: 4 files)
- Install (CLI): `npx skillmds@latest add ntygod/file-organizer`
- Raw SKILL.md: https://api.skillmd.com/api/skills/ntygod/file-organizer/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: ntygod (https://skillmd.com/u/ntygod)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/ntygod/file-organizer

---


# 文件管理指南

批量整理 / 重命名 / 归档 / 去重 / 磁盘分析。**核心约束：所有破坏性操作必须先输出预览，用户确认才执行。**

## 适用场景

- 批量重命名（按规则 / 日期 / 序号）
- 目录结构整理（按类型 / 日期 / 项目分类归档）
- 重复文件检测与清理
- 磁盘空间分析（哪些目录大）
- 旧文件清理（按修改时间）

## 不适用场景

- 单个文件读 / 写 → `file_read` / `file_write`
- 代码文件重构 → code-assistant
- 文档格式转换（docx ↔ pdf 等）→ doc-processor

## 工作流（按用户表达分流）

| 用户表达 | 路径 |
|---|---|
| "整理一下 X 目录" | 现状 → 方案 → 预览 → 执行 |
| "把所有 X 改成 Y 命名" | 列匹配文件 → 预览映射 → 批量重命名 |
| "看看哪些文件重复" | 扫 + 算 hash → 列重复组 → 用户决定保留哪个 |
| "磁盘满了" | 按大小排序目录 → 给用户高占用清单 |
| "清理 30 天前没改过的" | 按 mtime 筛 → 预览 → 移到回收目录 |

各路径要点：

- **预览不可省**：执行前列出"会改哪些 / 改成什么"给用户对，不直接动手
- **优先 file_manage**：跨平台，避免 `shell_exec` 的 mv / rm 差异（Windows 没有 mv）
- **移动优于删除**：删除 / 覆盖先归档到操作目录下 `.trash/<日期>/` 子目录，用户确认无误后再清
- **大批量分批**：> 100 个文件分批跑，每批后让用户回看
- **重命名记映射**：批量重命名后落 `rename-map.json`（旧名→新名）到操作目录，便于回溯

## 详细参考

- 分类依据矩阵、命令模板、错误处理：`{skill_dir}/references/organize-patterns.md`