# Dir Organizer

> 整理和优化项目目录结构。当用户请求整理目录、分类文件、清理无用文件或重构文件夹结构时调用此技能。

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

---

> English version: [SKILL-en.md](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. 按需更新外部引用：对于涉及外部文件（目录外文件）的引用链接，仅在用户明确要求时才进行更新。