在QoderWake中为Waker添加Skill需先确认其部署模式：沙盒独占型仅支持项目级Skill，全局共享型才支持用户级Skill；可通过IDE界面绑定（实时生效）、CLI命令重载（热更新＜1.2秒）或Webhook自动触发（需启用监听开关）三种方式实现。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
你想在QoderWake中为某个Waker（数字员工实例）添加专属Skill，但不确定该从哪里配置、是否需要重启、或添加后能否立即生效——这取决于Waker的部署方式与Skill的注册路径，不同场景下操作逻辑完全不同。
确认Waker类型与Skill作用域匹配
先打开QoderWake管理控制台 → 进入「角色部署」页面 → 找到目标Waker名称，查看其「部署模式」字段：【若显示“沙盒独占”】，则只能使用项目级Skill（即放在{projectPath}/.qoder/skills/下的SKILL.md）；【若显示“全局共享”】，才支持用户级Skill（~/.qoder/skills/路径）。
项目级Skill会覆盖同名用户级Skill，且仅对该Waker绑定的代码仓库生效；用户级Skill需确保Waker初始化时已加载该沙盒上下文。
方法一：通过IDE界面为Waker绑定Skill
此方法适用于已在线的Waker，无需重启，变更实时生效。
第一步：在QoderWake IDE中，点击右上角「Waker管理」→ 选择目标Waker → 点击「扩展技能」按钮。
第二步：在弹出面板中，点击「本地导入」→ 浏览并选中你已写好的SKILL.md文件（注意：必须是完整目录结构，不能只选单个MD文件）→ 点击「确认绑定」。
第三步：系统自动校验YAML契约与输入Schema，若无报错，状态栏显示「Skill已注入Waker运行时」；此时可在该Waker的对话窗口中直接输入/调出菜单验证。
⚠️ 若SKILL.md中name字段含大写字母或超长（＞64字符），绑定会静默失败，不提示错误——请提前用qoder skill validate --file SKILL.md检查。
代码编辑 CLI 工具集合：Cursor CLI（agent）和 Qoder CLI（qodercli），用于代码修改、重构、Code Review 及自动化代码任务。
方法二：用CLI命令强制重载Skill到指定Waker
当你修改了已注册Skill的逻辑，又不想重新部署整个Waker时，用这条命令最直接。
执行qoder skill reload --waker-id=WKR-8X2F-Z9T3 --path=~/.qoder/skills/save-user/，其中WKR-8X2F-Z9T3需替换为你的Waker真实ID（可在「角色部署」页URL末尾或qoder waker list输出中找到）。
这条命令会触发Waker沙盒内Skill注册中心热更新，跳过全量重启流程，耗时通常＜1.2秒。
成功后终端返回reload completed，且该Waker后续所有会话将立即使用新版本Skill逻辑。
方法三：通过Webhook事件自动触发Skill加载
适合CI/CD流水线中动态注入Skill的场景，例如每次git push后自动为测试Waker加载最新版日志分析Skill。
方法一：在第三方平台（如GitLab CI）的pipeline脚本末尾添加curl -X POST https://qoderwake.alipay.com/webhook/{tenant_id}/{secret_key} \ -H "Content-Type: application/json" \ -d '{"event":"skill_update","skill_path":"/home/ci/.qoder/skills/log-analyzer/"}'。
方法二：QoderWake收到该Webhook后，自动解析skill_path，校验SKILL.md合法性，并向目标Waker广播加载指令——前提是该Waker已启用「Webhook监听」开关且具备对应权限。
注意：Webhook触发的Skill加载默认只作用于标记为「auto-load-enabled」的Waker，其他Waker需手动开启该开关。
