dir-organizer
目录整理技能
本技能旨在帮助用户规范化和优化项目目录结构,提升工程的可维护性。
1. 触发时机
以下场景应触发本技能的执行,以确保目录结构的合理性。
- 用户明确请求整理当前或指定目录;
- 目录中存在大量未分类的零散文件;
- 需要对项目进行结构重构或清理临时文件。
2. 核心操作能力
本技能支持对目录和文件进行多种基础及高级操作,以满足不同程度的整理需求。
- 创建目录:可以根据文件分类需求,在合适的位置创建新的目标目录。
- 重命名目录:可以对当前目录进行重命名,以更准确地反映其内容。
- 移动文件:可以将零散或位置不当的文件移动到合适的归档目录中。
- 重命名文件:可以对单个或多个文件进行重命名,确保命名风格的统一和规范。
3. 执行原则
在进行目录整理时,需要遵循以下核心原则,确保操作的安全与规范。
- 结构分析:在进行任何操作前,必须先分析当前的文件分布与依赖关系。
- 安全保障:对于可能影响项目运行的核心文件或依赖(如配置、源码),移动前需与用户确认。
- 规范命名:新建的目录和文件需遵循项目统一的命名规范(如中英文之间保留空格)。
- 清理冗余:识别并清理常见的无用缓存或日志文件。
4. 标准执行步骤
规范的执行流程能够确保目录整理工作有条不紊地进行。
4.1 状态收集
收集当前目录的详细状态信息。
- 使用终端工具或脚本读取目标目录下的所有文件列表。
- 识别文件的扩展名和潜在用途。
4.2 方案制定与审核
基于收集到的信息,制定详细的结构调整方案,并必须交由用户审核(Review)。【关键强制要求】:必须先在常规的文本回复中完整打印出重构计划,让用户能够切实看到,然后再发起确认请求(如调用 AskUserQuestion 工具)。绝不能在未输出计划内容的情况下直接发起提问。
输出重构计划时需遵循以下规范格式:
- 目录与文件调整计划:在文本回复中使用 Markdown 树状结构清晰展示目标状态,并使用标签明确标注变更类型(如:
[新建]、[不变]、[重命名自: xxx]、[移动自: xxx])。树状结构中必须包含目录下的具体文件,而不仅仅是目录层级。 - 清理计划:单独使用列表展示将要删除的无用文件清单。
- 等待确认:在确保上述计划内容已经完整呈现在用户的聊天界面后,再使用工具或语言明确询问用户是否同意执行上述重构计划。
4.3 执行与验证
在用户明确同意重构计划后,实际执行目录调整操作。
- 使用终端命令执行文件移动、重命名和目录创建。
- 验证操作结果,并向用户展示最终的目录树结构。
4.4 引用链接自动更新
在完成文件移动和结构调整后,无需再次询问,自动妥善处理文件之间的引用关系。
- 自动更新内部引用:整理完目录之后,必须自动扫描并更新该目录下各个文件之间的引用链接,确保相对路径或绝对路径的准确性。
- 按需更新外部引用:对于涉及外部文件(目录外文件)的引用链接,仅在用户明确要求时才进行更新。
More from forceinjection/awesome-skills
doc-reviewer
审查技术文档。支持四种独立评审类型:大纲评审(检查目录与结构逻辑)、内容评审(检查文字准确性与代码质量)、资产评审(校验链接与引用合规)、格式评审(校对纯视觉排版与标点)。当用户请求审查或修正 Markdown 文档时使用。
5code-reader
Use when you want to deeply understand an unfamiliar codebase and generate reusable cognitive skills from it, by providing a local path or GitHub URL
4md-summarizer
分析和总结指定的本地 Markdown 文件,并输出结构化的中文总结。当用户请求总结、分析或提取本地 Markdown 文档信息时调用此技能。
4update-submitter
Analyzes git status, groups related file changes, and generates standardized Conventional Commits. Invoke when the user wants to commit changes, submit updates, or create a PR.
3md-translator
将指定的本地 Markdown 文件翻译成指定语言(默认中文),并在文件名中添加语言标识后缀。当用户请求翻译本地 Markdown 文档时调用此技能。
3web-content-downloader
下载网页并转换为 Markdown 文件,保留原网页语言(不翻译)。当用户请求下载网页、保存文章并提取图片时调用此技能。
3