skill未被正确加载需逐层排查：确认是否落盘至对应系统技能根目录、子目录命名合规且含manifest.yaml；检查manifest.yaml中name、version、builtin字段格式正确；强制重载索引并重启；在skills catalog中启用该skill；最后绑定到当前数字员工实例。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
QoderWake安装Skill后在聊天窗口输入指令无响应、/Skills Catalog面板中不显示、CLI执行qoder skill list也查不到对应条目，说明Skill未被正确加载或注册到当前数字员工上下文中，必须按路径逐层排查。
确认Skill文件是否真正落盘到正确位置
QoderWake只扫描特定目录下的合法Skill结构，放错路径等于没装。打开终端，执行以下命令定位当前生效的Skill根目录：
Windows用户：cd %APPDATA%\QoderWake\skills
macOS用户：cd ~/Library/Application Support/QoderWake/skills
Linux用户：cd ~/.config/QoderWake/skills
进入该目录后，用ls（macOS/Linux）或 dir（Windows）列出内容。你安装的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: false（自定义Skill此项必须为false，若误写为true将被跳过加载）
常见错误：复制模板时漏掉冒号、缩进用中文空格、version字段多加引号。只要任一字段校验失败，QoderWake就会静默忽略整个Skill目录，不报错也不提示。
强制重载Skill索引并验证状态
即使文件和配置都正确，QoderWake也不会自动监听文件系统变化。必须手动触发重载：
Qoder Linux版是由阿里推出的智能体自主开发工作台，支持开发者通过定义需求即可让Agent团队“自动驾驶”，自主完成代码执行、验证与交付的全流程。其全新的Quest独立视窗集成了任务管理与状态追踪能力，并支持跨项目多任务并行处理，显著提升开发效率。此外，Qoder还提供专家团模式与团队级知识引擎，适配复杂开发场景。
第一步：完全退出QoderWake进程（包括任务栏后台图标，macOS需在活动监视器中确认无QoderWake相关进程）
第二步：在终端中执行 qoder skill reload --force
第三步：重启QoderWake，等待约8秒，待左下角状态栏显示“Skills indexed: X”（X为实际数量）
此时再运行 qoder skill list --all，应能列出你安装的Skill，并标注status: loaded。若仍为空，请检查上一步终端输出是否有“invalid manifest in …”字样——这表示manifest.yaml解析失败，需返回第二步修正。
在Skills Catalog面板中启用开关
方法一：通过斜杠命令激活面板
在QoderWake任意聊天输入框中输入 / → 按Enter → 右侧展开Skills Catalog → 找到你的Skill卡片 → 点击右上角开关按钮将其设为开启状态
方法二：用CLI直接启用
执行 qoder skill enable your-skill-name（your-skill-name必须与manifest.yaml中name字段完全一致）
【注意：禁用状态的Skill不会出现在自然语言探查结果中，也不会响应斜杠调用】
验证是否绑定到当前数字员工实例
QoderWake支持多数字员工并存，每个实例有独立Skill上下文。如果你在IDE中切换了左上角的员工头像（如从“数字程序员”切到“数字流程专员”），Skill需重新绑定：
进入Settings → Agent Settings → Skill Binding → 在“当前员工可用Skill”列表中勾选你的Skill → 点击Save Binding
这一步做完后，在该员工的聊天窗口中输入“调用xxx技能”，即可触发执行。若此前一直用错员工身份，就始终看不到Skill生效。
