dir-organizer

Installation
SKILL.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. 按需更新外部引用:对于涉及外部文件(目录外文件)的引用链接,仅在用户明确要求时才进行更新。
Related skills
Installs
4
GitHub Stars
33
First Seen
Mar 28, 2026