qoderwake技能不生效主因是路径层级错位、命名不合规或配置未重载，需校验skill.yaml命名与内容、文件夹小写短横线命名、强制重载并查调试日志。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
QoderWake安装Skill后不生效、Quest模式中技能完全不识别，通常不是网络或权限问题，而是文件路径层级错位、命名不合规或配置未触发重载所致，必须逐层校验结构而非重装。
检查Skill文件夹结构与命名规范
QoderWake的Skill加载器仅识别严格符合约定的目录树，任意一级名称错误或缺失都会静默跳过整个Skill，且不报错提示。
打开你的Skill存放目录（默认为~/.qoder/skills/或%USERPROFILE%\.qoder\skills\），确认该路径下直接包含的是以小写字母+短横线命名的文件夹，例如web-scraper、git-helper，而不是WebScraper或web_scraper。
进入任一Skill文件夹，必须存在且仅存在以下三个文件：【skill.yaml】（必需，不可用.yml或.YAML替代）、main.py（或index.js，取决于运行时）、README.md（可选但建议保留）。
若发现skill.yml或Skill.yaml，立即重命名为skill.yaml——大小写和扩展名错误会导致整个Skill被忽略。
验证skill.yaml内容合法性
打开skill.yaml，第一行必须是version: "1.0"，第二行必须是name: "your-skill-name"，且name值必须与父文件夹名完全一致（包括大小写和短横线）。
Qoder Linux版是由阿里推出的智能体自主开发工作台，支持开发者通过定义需求即可让Agent团队“自动驾驶”，自主完成代码执行、验证与交付的全流程。其全新的Quest独立视窗集成了任务管理与状态追踪能力，并支持跨项目多任务并行处理，显著提升开发效率。此外，Qoder还提供专家团模式与团队级知识引擎，适配复杂开发场景。
方法一：使用在线YAML校验器粘贴内容，确认无缩进错误、冒号后空格缺失或中文标点残留；
方法二：在终端执行qoderwake skill validate --path /full/path/to/your-skill-folder，返回✓ Valid才表示通过基础语法与结构校验。
【若validate命令报command not found，请先执行qoderwake install-cli】
强制重载Skill并观察日志
第一步：关闭所有QoderWake进程。Windows在任务管理器结束qoderwake.exe，macOS在活动监视器强制退出QoderWake，Linux执行pkill -f qoderwake。
第二步：清空缓存目录。rm -rf ~/.qoder/cache/skills/（macOS/Linux）或del /q "%USERPROFILE%\.qoder\cache\skills\*"（Windows）。
第三步：以调试模式启动QoderWake：qoderwake serve --debug，观察控制台输出中是否出现Loaded skill: your-skill-name字样。若无此行，说明前两步仍有结构或配置问题未解决。
