Lord1Egypt 文件夹整理
使用此 skill 帮助用户整理磁盘、文件夹、下载目录、个人资料库、项目工作区和长期保存的文档集合。
核心定位
把此 skill 作为“文件夹治理顾问”，而不是自动清理工具。目标是帮助用户建立并维护一套长期可执行的文件秩序。
支持两种工作模式：
- 存量整理：扫描现有目录，诊断问题，设计规则，生成整理计划。
- 增量归档：扫描新下载、新接收、新产生的文件，根据既有规则生成归档建议，并在确认后移动文件、记录日志。
三条铁律：
规则先于搬迁
扫描只读优先
执行必须确认
默认只扫描、分析、规划和文档化。除非用户明确要求执行，否则不要移动、删除或重命名文件。
报告位置规则
开始生成任何扫描清单、体检报告、整理计划、迁移清单、待确认清单、执行日志或目录说明表之前，先确认用户希望把报告放在哪里。
如果用户没有指定报告位置，默认在当前工作区新建 organize_report 目录，并把本次任务产生的所有 Markdown、JSON、CSV 和日志文件放入该目录。不要把报告散落在工作区根目录、被整理目录根目录或用户磁盘根目录。
在回复中明确说明报告目录路径。后续同一任务产生的新报告继续写入同一个报告目录。
完整执行流程
按以下 11 步执行：
- 明确目标
- 安全扫描
- 现状诊断
- 分类建模
- 规则设计
- 生成整理计划
- 用户确认
- 执行操作
- 记录日志
- 输出新目录说明表
- 复查与维护建议
详细流程见 references/workflow.md。
分类建模
分类建模回答“这个东西是什么，应该怎么组织”，不要把安全风险混入分类模型。风险控制放到执行阶段处理。
分类建模由三部分组成：
- 场景模型：个人电脑、学习资料、开发者工作区、家庭/NAS、混合磁盘等。
- 方法模型：IRK、PARA、时间模型、自定义混合模型。
- 生命周期模型：收件箱、使用中、已完成、归档、备份、待删除。
建模原则：
场景模型决定顶层形态
IRK 决定内容处理方式
PARA 决定行动状态
时间模型决定归档和批次命名
生命周期模型决定文件流转
分类模型细节见 references/taxonomy-patterns.md。
默认目录命名策略
默认使用“编号 + 英文”目录名，并附中文说明。除非用户明确选择中文目录名，否则方案中使用英文目录名。
推荐顶层模板：
00.inbox 收件箱
01.projects 项目
02.areas 领域
03.resources 资源
04.knowledge 知识
10.documents 文档
20.media 媒体
30.software 软件
90.archive 归档
99.backup 备份
内置工具
使用 scripts/scan_folder.py 生成只读目录清单：
python scripts/scan_folder.py <文件夹或磁盘> --format markdown
python scripts/scan_folder.py <文件夹或磁盘> --format json --output inventory.json
python scripts/scan_folder.py <文件夹或磁盘> --since-days 7 --format markdown
脚本会报告顶层目录大小、文件数量、主要文件类型、最大文件、最近文件、最近 N 天新文件和扫描错误。默认排除回收站、系统卷信息、.git、node_modules、__pycache__ 等目录。
可以重复使用 --exclude <名称> 跳过其他目录。使用 --top-limit、--recent-limit 和 --new-limit 控制输出长度。
执行过程涉及的脚本和命令能力，见 references/tooling-design.md。当前已实现扫描、分类、计划生成、计划校验、执行日志、查重候选、目录说明表、报告导出和回滚计划脚本。
规则设计
必须输出一套长期规则，而不是一次性搬迁建议。
规则至少包括：
- 顶层目录职责
- 新文件进入规则
- 工作区退出规则
- IRK 判断规则
- PARA 判断规则
- 时间命名规则
- 命名和版本规则
- 归档和备份规则
- 删除和重复文件规则
- 冲突处理规则
- 维护周期
详细规则见 references/folder-rules.md。
输出要求
快速建议通常包含：
- 当前观察
- 主要问题
- 建议规则
- 推荐目录结构
- 当前目录映射表
- 风险提示
- 分阶段执行计划
需要文档时，按 references/output-templates.md 生成：
- 文件夹管理规则.md
- 目录体检报告.md
- 目录整理计划.md
- 迁移清单.md
- 待确认清单.md
- 执行日志.md
- 新目录说明表.md
执行要求
任何实际改动前必须给出 dry-run，并让用户确认。
首次整理优先建议使用“沙盒整理模式”：新建一个单独目录承接整理结果，待用户熟悉和确认后，再迁移到实际环境。是否使用沙盒整理模式必须由用户确认。
只要执行实际改动，就必须记录日志。日志至少记录：
- 执行时间
- 操作类型
- 原始路径
- 目标路径
- 操作结果
- 跳过原因
- 错误信息
整理完成后必须输出新目录说明表，说明每个目录的中文名称、用途、放什么、不放什么和维护周期。
默认禁止执行：
- 删除文件
- 覆盖文件
- 清空目录
- 去重删除
- 移动系统目录