在QoderWake中安装Skill后却发现无法找到，这种情况其实并不少见。许多用户在聊天窗口中输入指令却毫无反应，前往Skills Catalog面板查看也找不到刚安装的Skill，甚至运行qoder skill list命令后依然显示为空——这通常意味着Skill并未正确加载到当前数字员工的上下文中。遇到此类问题，不必急于怀疑操作失误，只要按照系统化的排查路径逐步检查，就能定位并解决故障。

首先需要确认文件是否放置到了正确的目录。QoderWake只认可特定目录下符合规范的Skill结构，路径错误等于未安装。打开终端，根据你的操作系统定位到对应的skills根目录：

Windows用户：cd %APPDATA%\QoderWake\skills
macOS用户：cd ~/Library/Application Support/QoderWake/skills
Linux用户：cd ~/.config/QoderWake/skills

进入后使用ls或dir命令列出内容。你安装的Skill必须是一个独立的子目录，且目录名不能包含空格、中文或特殊字符，例如interview-question-generator、log-analyzer-v2这样的命名才合规。如果看到的是.zip或.tar.gz压缩文件，或者目录名是“面试题生成器_v1.0”这类中文名称，则无需继续排查——必须解压为纯英文目录，且目录内必须包含manifest.yaml和src/子目录，二者缺一不可。

检查manifest.yaml是否合规且未被篡改

每个Skill目录下都必须有manifest.yaml文件，这是QoderWake识别该Skill的唯一凭证。使用文本编辑器打开它，重点核对以下三个字段：

• name：必须为全小写英文加短横线，例如digital-hr-onboard
• version：必须为语义化版本号，例如0.3.1，不能写成v0.3.1或0.3.1-beta
• builtin：自定义Skill此项必须为false，若误写为true则会被跳过加载

常见的踩坑点包括：复制模板时遗漏冒号、缩进使用了中文空格、version字段被多余引号包裹。只要任一字段校验失败，QoderWake就会静默忽略整个Skill目录，既不报错也不提示，非常容易让人困惑。

强制重载Skill索引并验证状态

即使文件和配置都正确，QoderWake也不会自动监听文件系统变化——必须手动触发重载。具体操作步骤如下：

1. 完全退出QoderWake进程，包括任务栏后台图标也要关闭，macOS用户需在活动监视器中确认无相关进程残留。
2. 在终端中执行qoder skill reload --force命令。
3. 重新启动QoderWake，等待大约8秒，观察左下角状态栏是否显示“Skills indexed: X”（X为实际数量）。

此时再运行qoder skill list --all，应该能看到你安装的Skill，并且状态标注为status: loaded。如果列表仍然为空，请返回检查上一步终端输出中是否有“invalid manifest in …”字样——若有，说明manifest.yaml解析失败，需要回到第二步继续修改。

在Skills Catalog面板中启用开关

有两种方式可以激活Skill：

方法一：斜杠命令调出面板
在QoderWake任意聊天输入框中输入/，按Enter键，右侧会展开Skills Catalog，找到你的Skill卡片，点击右上角开关按钮将其设为开启状态。

方法二：通过CLI直接启用
执行qoder skill enable your-skill-name命令，注意这里的Skill名必须与manifest.yaml中name字段完全一致。

【请切记：禁用状态的Skill既不会出现在自然语言探查结果中，也不会响应斜杠调用】

验证是否绑定到当前数字员工实例

QoderWake支持同时运行多个数字员工，每个实例拥有独立的Skill上下文。如果你在IDE中切换了左上角的员工头像（例如从“数字程序员”切换到“数字流程专员”），那么Skill需要重新绑定：

进入Settings → Agent Settings → Skill Binding → 在“当前员工可用Skill”列表中勾选你的Skill → 点击Save Binding。

完成上述操作后，在该员工的聊天窗口输入“调用xxx技能”即可触发。如果之前一直使用错误的员工身份，Skill不生效就完全在情理之中了。