forceinjection/awesome-skills/dir-organizer

English version: SKILL-en.md

目录整理技能

本技能旨在帮助用户规范化和优化项目目录结构，提升工程的可维护性。

1. 触发时机

以下场景应触发本技能的执行，以确保目录结构的合理性。

• 用户明确请求整理当前或指定目录；
• 目录中存在大量未分类的零散文件；
• 需要对项目进行结构重构或清理临时文件。

2. 核心操作能力

本技能支持对目录和文件进行多种基础及高级操作，以满足不同程度的整理需求。

• 创建目录：可以根据文件分类需求，在合适的位置创建新的目标目录。
• 重命名目录：可以对当前目录进行重命名，以更准确地反映其内容。
• 移动文件：可以将零散或位置不当的文件移动到合适的归档目录中。
• 重命名文件：可以对单个或多个文件进行重命名，确保命名风格的统一和规范。

3. 执行原则

在进行目录整理时，需要遵循以下核心原则，确保操作的安全与规范。

• 结构分析：在进行任何操作前，必须先分析当前的文件分布与依赖关系。
• 安全保障：对于可能影响项目运行的核心文件或依赖（如配置、源码），移动前需与用户确认。
• 规范命名：新建的目录和文件需遵循项目统一的命名规范（如中英文之间保留空格）。
• 清理冗余：识别并清理常见的无用缓存或日志文件。

4. 标准执行步骤

规范的执行流程能够确保目录整理工作有条不紊地进行。

4.1 状态收集

收集当前目录的详细状态信息。

1. 使用终端工具或脚本读取目标目录下的所有文件列表。
2. 识别文件的扩展名和潜在用途。

4.2 方案制定与审核

基于收集到的信息，制定详细的结构调整方案，并必须交由用户审核（Review）。【关键强制要求】：必须先在常规的文本回复中完整打印出重构计划，让用户能够切实看到，然后再发起确认请求（如调用 AskUserQuestion 工具）。绝不能在未输出计划内容的情况下直接发起提问。

输出重构计划时需遵循以下规范格式：

1. 目录与文件调整计划：在文本回复中使用 Markdown 树状结构清晰展示目标状态，并使用标签明确标注变更类型（如：[新建]、[不变]、[重命名自: xxx]、[移动自: xxx]）。树状结构中必须包含目录下的具体文件，而不仅仅是目录层级。
2. 清理计划：单独使用列表展示将要删除的无用文件清单。
3. 等待确认：在确保上述计划内容已经完整呈现在用户的聊天界面后，再使用工具或语言明确询问用户是否同意执行上述重构计划。

4.3 执行与验证

在用户明确同意重构计划后，实际执行目录调整操作。

1. 使用终端命令执行文件移动、重命名和目录创建。
2. 验证操作结果，并向用户展示最终的目录树结构。

4.4 引用链接自动更新

在完成文件移动和结构调整后，无需再次询问，自动妥善处理文件之间的引用关系。

1. 自动更新内部引用：整理完目录之后，必须自动扫描并更新该目录下各个文件之间的引用链接，确保相对路径或绝对路径的准确性。
2. 按需更新外部引用：对于涉及外部文件（目录外文件）的引用链接，仅在用户明确要求时才进行更新。