一、它能做什么

这个 Skill 提供两个功能：

1. 打开 Windows 资源管理器到指定文件夹 — 你可以只说文件夹名，也可以直接给完整路径。

2. 启动已注册的应用 — 通过应用名启动对应的 .exe，首次使用只需登记一次路径。

两个功能共用同一个 Skill，系统根据关键词自动判断走哪条分支。

二、文件结构

C:\Users\<你>\.claude\skills\explore-folder\
├── SKILL.md    ← Skill 主文档，定义触发条件和流程
└── games.json  ← 游戏路径缓存

games.json 文件格式如下：

{
  "XX": "D:XXX"
}

每添加一个新游戏，只需追加一个键值对即可，不会覆盖已有内容。

三、触发条件

Skill 仅在明确的指令下触发，避免误伤。

会触发

指令格式	示例	效果
打开文件夹 <名称>	打开文件夹 我的项目	搜索并打开同名文件夹
打开文件夹 <完整路径>	打开文件夹 D:\数据\项目A	直接打开指定路径
打开目录 <名称>	打开目录 我的项目	同上，中文别名
open folder <name>	open folder myproject	同上，英文别名
open directory <name>	open directory myproject	同上，英文别名
启动 <应用名>	启动原神！	启动已注册的游戏
打开 <应用名> 应用	打开原神应用	同上
启动 <应用名> 应用	启动英雄联盟应用	同上

不会触发

指令	原因
只说"打开文件夹"	缺少目标名
只说"打开 xxx"	无法区分是文件夹还是游戏
随意提到"文件夹"这个词	缺少触发动词+目标名的组合

触发规则总结：必须同时包含"触发动词" + "具体目标名"，缺一不可。

四、功能一：打开文件夹

方式 A — 你提供完整路径

1. 你说：打开文件夹 D:\工作\2024\项目A

2. Skill 识别出 D:\... 格式的 Windows 路径，直接执行 explorer "D:\工作\2024\项目A"

3. 打开后确认是否正确

方式 B — 你只提供文件夹名

1. 你说：打开文件夹 我的项目

2. Skill 在以下目录中递归搜索（最多 5 层）：

   • 桌面（C:\Users\<你>\Desktop）

   • 文档（C:\Users\<你>\Documents）

   • 下载（C:\Users\<你>\Downloads）

   • D:\、E:\ 等常见盘符根目录

3. 如果找到匹配文件夹（最多 10 个），列出编号让你选择：

   找到以下匹配的文件夹：
   1. C:\Users\XXX\Desktop\我的项目
   2. D:\数据\我的项目
   ​
   请输入编号选择要打开的文件夹：

4. 你输入编号（如 1），Skill 打开该文件夹

5. 如果未找到任何匹配：提示你提供新名称或完整路径

走错了怎么办

打开后 Skill 会询问是否打开的是正确的文件夹。如果不是：

• 输入新路径 → 重新执行方式 A

• 说"继续搜索" → 重新执行方式 B

五、功能二：启动应用

首次使用 — 需要注册路径

1. 你说：启动XX

2. Skill 读取 games.json，发现没有"XX"这个条目

3. 提示：这是第一次为应用 <XX> 记录路径，请提供该游戏可执行文件 (.exe) 的完整路径。

4. 你输入路径，如：D:XXXX

5. Skill 验证路径是否存在（文件存在性检查）

6. 保存到 games.json，然后启动XX

7. 提示：已记录游戏 "XX" 的路径：D:XXXXe

后续使用 — 一条命令启动

1. 你说：启动应用

2. Skill 从 games.json 中找到对应的 .exe 路径

3. 执行 start "" "D:XXX"

4. 提示：已为你启动应用 "XX"。

start "" 中的空白引号是 Windows 命令的必需语法 — 路径含空格时指定窗口标题，否则会出错。

路径变更

如果游戏重新安装到别的位置，重新注册即可。Skill 会读取最新的 games.json 内容，每次都是重新查找匹配。

启动失败

如果路径失效（文件被删除、游戏卸载、盘符更换），命令会报错。Skill 会提示你检查路径是否仍然有效。

六、安装方法

1. 放置 Skill 文件

将 SKILL.md 和 games.json 放到以下位置（根据你的操作系统选择）：

C:\Users\<你的用户名>\.claude\skills\explore-folder\

如果 skills 目录不存在，先创建：

mkdir "%USERPROFILE%\.claude\skills\explore-folder"

然后将 SKILL.md 放入该目录。games.json 可以稍后首次注册应用时自动创建。

2. 初始化 games.json

在 explore-folder 目录下创建 games.json，初始内容为空对象：

{}

3. 验证安装

打开 Claude Code，输入：

打开文件夹 Desktop

如果能正确打开资源管理器，说明安装成功。

4. 注册第一个应用

启动 <应用名>

按提示输入应用 .exe 的完整路径即可。

七、使用场景

场景 1 — 工作文件夹太多，找不到

你有十几个项目，每个项目在磁盘的不同位置。以前需要打开文件管理器，一层层翻目录树，才能找到 项目A。

现在：打开文件夹 项目A，Skill 自动搜索并列出所有匹配项，选编号即可。

场景 2 — 你知道完整路径

你想打开一个路径很长的文件夹，手动复制粘贴太麻烦。

直接说：打开文件夹 D:\工作\2024\Q3\数据分析\报告，一条指令打开。

场景 3 — 游戏启动器太慢

你安装了十几个游戏，每个都有自己的启动器。你不想打开 Steam/Epic/B 站客户端，只想快速启动某个游戏。

启动Steam    ← 直接启动
启动英雄联盟 ← 直接启动

不需要打开任何游戏客户端。

场景 4 — 英文文件夹名

Skill 同时支持中英文触发词：

open folder myproject

效果等同于 打开文件夹 myproject。

八、技术细节

搜索逻辑

• 当用户只提供文件夹名时，Skill 在桌面、文档、下载、D/E 盘根目录下递归搜索

• 搜索限制深度为 5 层，避免全盘扫描导致卡顿

• 返回最多 10 个匹配项

路径处理

• Windows 路径格式 C:\...、D:\... 直接识别

• URL 风格路径 C:/... 自动兼容

• 含空格的路径用双引号包裹

• explorer 命令用于打开文件夹，start "" 命令用于启动 .exe

游戏名匹配

• 不区分大小写

• 读取 games.json 的所有键做 toLowerCase() 比较

安全设计

• 不覆盖已有应用条目，追加新条目

• 应用路径变更时重新注册即可，无需手动编辑 JSON

• 路径验证确保 .exe 文件实际存在

九、注意事项

1. 触发必须精确 — 必须同时包含"打开文件夹"或"启动" + 目标名。只说"打开"或只说文件夹名都不会触发。

2. 游戏路径使用反斜杠 — games.json 中的路径使用 \\ 转义（JSON 标准格式）。

3. 搜索深度限制 — 搜索最多 5 层深，如果目标文件夹嵌套很深且不在常见目录中，建议直接给完整路径。

4. 路径变更需重新注册 — 游戏重装到不同位置后，重新走首次注册流程即可。

十、完整使用流程示例

用户：打开文件夹 我的项目
​
→ 搜索桌面、文档、D盘...
→ 找到 2 个匹配：
  1. C:\Users\XXX\Desktop\我的项目
  2. D:\数据\我的项目
→ 请输入编号选择要打开的文件夹：
→ （用户输入 1）
→ explorer "C:\Users\XXX\Desktop\我的项目"
→ 已为你打开文件夹，确认是否正确？
​
​
用户：启动XX
​
→ 读取 games.json，找到 "XX" 对应路径
→ start "" "D:XXXX"
→ 已为你启动应用 "XX"。

---