mcpField
F
file-organizer

file-organizer

github.com/acaprino生产力9132 次安装2 天前更新
代码仓库

关于 file-organizer

file-organizer 是整理个人文件、文档文件夹和不活跃归档的技能。它要求变更前先获批准、记录移动操作以便撤销，并将活跃代码仓库排除在通用整理之外。

主要功能

  1. 01分析文件类型与存储占用
  2. 02建议文件夹结构
  3. 03查找并检查重复文件
  4. 04变更前要求批准
  5. 05记录移动并保留日期
  6. 06排除活跃代码仓库

适用场景

  1. 01整理杂乱的 Downloads 文件夹
  2. 02规划个人文档的目录结构
  3. 03删除前核对重复文件
  4. 04归档不活跃的个人项目

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/acaprino/daodan --skill file-organizer

安装后在 Claude Code 中输入/file-organizer确认已加载。

附带文件references/organization-guide.mdSKILL.toml

详细介绍

文件整理

处理个人文件夹、文档文件夹和不活跃的归档文件。不要将活跃仓库纳入通用文件整理：它们的源代码布局、测试、说明和运行产物都有项目专属的管理和验证流程。绝不能仅凭哈希值或文件年龄，就将仓库中名称相似的文件视为可删除的重复文件。说明这一界限，并将项目交由其开发或仓库清理流程处理，不要移动其中的内容。

说明

1. 明确范围

开始前先询问澄清问题：

  • 需要整理哪个目录？
  • 主要问题是什么？（找不到东西、重复文件、缺乏结构、整体杂乱）
  • 有哪些文件或文件夹需要避开？（活跃项目、敏感数据）
  • 整理力度如何？（保守整理还是全面清理）

对于范围较广的整理，简要介绍一个参考指南中的整理理念（PARA、Johnny Decimal、GTD、7-Folder），供用户选择，绝不强行指定。对于清理 Downloads 等范围明确的任务，可跳过此步骤。

2. 分析当前状态
ls -la [target_directory]
find [target_directory] -type f -exec file {} \; | head -20
du -sh [target_directory]/* | sort -rh | head -20
find [target_directory] -type f | sed 's/.*\.//' | sort | uniq -c | sort -rn

总结：文件和文件夹总数、类型分布、大小分布、日期范围、明显问题。

需要指出的反模式：

  • 将桌面用作永久归档（目标：桌面上永久文件数量为零）
  • 未命名文件夹（New Folder、New Folder (3)）
  • 版本管理混乱（document_FINAL_v2_DEFINITIVE_copy.docx）
  • Downloads 文件夹从不清理（数千个未分类文件）
  • 同一文件重复存放于不同位置（改用快捷方式）
3. 识别整理模式

按类型：

  • 文档（PDF、DOCX、TXT）、图片（JPG、PNG、SVG）、视频（MP4、MOV）
  • 归档文件（ZIP、TAR、DMG）、代码/项目、电子表格（XLSX、CSV）、演示文稿（PPTX、KEY）

按用途：

  • 工作与个人、活跃与归档、特定项目、参考资料、临时文件/草稿

按日期：

  • 当前年/月、前几年、非常久远的文件（可考虑归档）

特定场景的结构：

  • 照片/视频：Year/YYYY-MM_event-location/，包含 RAW、Edited、Export 子文件夹
  • 音乐：Artist/[Year] Album/NN - Track.ext
  • 工作项目：使用数字前缀（01_Brief/、02_Research/、03_Assets/、04_Deliverables/），并将 WIP 与 FINAL_APPROVED 分开
  • 财务/个人文档：在文件名中注明到期日期（passport_exp_2030.pdf），先按年份、再按类型整理
  • 代码：将本地路径对应到远程 URL（github.com/username/repo/）

详细模板请参阅 references/organization-guide.md。

4. 查找重复文件

按需执行：

find [directory] -type f -exec md5 {} \; | sort | uniq -d
find [directory] -type f -printf '%f\n' | sort | uniq -d

对每组重复文件：显示路径、大小和日期，并建议保留哪个。删除前务必确认。建议使用快捷方式/别名代替保留多个副本。

5. 提出整理计划

执行任何更改前先展示计划。包括：

  • 当前状态摘要（文件数量、大小、类型分布、发现的问题）
  • 检测到的反模式
  • 拟议的文件夹树结构
  • 要进行的更改：新建文件夹、移动文件、重命名、删除
  • 需要用户决定存放位置的文件
  • 询问用户是否明确批准后再继续
6. 执行整理

获得批准后，系统地进行整理。

规则：

  • 删除任何内容前务必确认
  • 记录所有移动操作，以便必要时撤销
  • 保留原始修改日期
  • 妥善处理文件名冲突
  • 遇到意外情况时停止并询问

文件重命名约定（仅在用户同意后采用——绝不自动重命名）：

  • ISO 日期：使用 YYYY-MM-DD，确保字母排序正确
  • 格式：[Date]_[Context]_[Description]_[Version].ext
  • 版本号补零：v01、v02（小版本：v01.1）
  • 分隔符：kebab-case 或 snake_case（不要使用空格）
  • 全部使用小写，文件名不超过 25-30 个字符，其余信息由文件夹上下文提供
  • 序号补零：001、002（避免排序结果为 1, 10, 11, 2）
  • 适用时使用状态前缀：WIP_、DRAFT_、REVIEW_、APPROVED_
  • 避免使用：< > : " / \ | ? *、重音符号、表情符号、开头为点的文件名、Windows 保留名称（CON、PRN、AUX、NUL）
  • 注意完整路径长度是否接近 Windows 的 260 个字符限制
7. 提供摘要

整理完成后，报告：

  • 创建的文件夹、整理的文件、释放的空间、修复的反模式
  • 新的文件夹树结构
  • 维护计划（如下）
  • 用于持续清理的自定义 bash 命令

维护计划：

频率时间任务
每周15 分钟清空 Downloads，将 Inbox 处理至清空，确认最近的文件已归位
每月45 分钟扫描重复文件，确认备份正常，归档已完成的项目
每季度2 小时检查磁盘空间，归档 3 个月以上未活动的项目，测试备份还原
每年半天进行灾难恢复测试，审查保留策略，更新结构

评论

支持 Markdown