QoderWake_Skill安装后怎么启用？

你在QoderWake中成功安装了一个Skill，结果发现它在聊天窗口里根本无法响应指令，斜杠面板里显示的是灰色禁用状态——别着急，这其实不是Bug，而是QoderWake的一项默认设计：新装上的Skill不会自动激活，必须手动去捅破那层窗户纸，它才能进入可用上下文。

下面是三种常见的启用方法，按场景选最顺手的那种就行。

通过Skills Catalog面板一键启用

如果你刚从Marketplace下载了一个Skill，或者刚刚通过本地配置文件注册了一个新功能，想立刻试用，那最直观的方式就是通过面板操作。日常使用场景下，这招足够快。

操作很简单：在QoderWake IDE的任意聊天输入框里，敲个

，然后按Enter键。右侧会展开Skills Catalog面板，找到你想要激活的那个Skill卡片，点击卡片右上角的开关按钮——灰色变成蓝色，就算激活成功了。如果按钮点不动，别急着怀疑人生，先确认一下这个Skill有没有完成依赖校验，比如缺了Python包，开关就会被锁定，压根儿不给点。

启用之后不需要重启，Skill会立刻出现在自然语言识别词表里。比如你刚装了一个“生成本周技术周报”的Skill，这时候再发类似的指令，它就能正常响应了。

用CLI命令批量启用并验证状态

如果涉及团队统一配置、CI/CD流水线集成，或者需要做审计合规，那面板操作就显得有点简陋了。这时候必须上CLI，因为状态可追溯、可回滚，出了事也方便复盘。

命令长这样：qoder skill enable interview-question-generator local-log-analyzer

注意几个细节：多个Skill名之间用空格隔开，不要加引号；如果名称里带了连字符（比如code-review-assistant），必须完整拼写，大小写还很敏感，写错了它就不认识你。

启用之后怎么确认它真的活了？跑一句：qoder skill status interview-question-generator。如果输出里出现active: true且offline_capable: true，说明已经就绪。如果返回的是not found，那就说明这个Skill还没注册进去，需要先执行qoder skill register --file ./skill.yaml这一步。

启用失败的三个关键排查点

有些时候，操作没毛病，但Skill就是死活启不起来。别慌，优先排查这三个地方。

方法一：检查Connector依赖是否就绪
有些Skill，比如notion-page-sync，在启用之前强制要求对应的Connector已经授权并且处于启用状态。进入「设置→Connectors」，确认Notion连接状态是绿色在线。如果那边是灰色或者断开，这边启用操作会被静默拦截，连个错误提示都不给你，所以先查Connector。

方法二：确认权限红线未阻断
有的Skill会涉及文件写入或者分支修改，这种情况下，如果权限红线策略集没有初始化，系统会直接拒绝启用。执行qoder config set security.permission_redline_enabled true，让策略生效之后再重试，一般就能解决。

方法三：查看Harness引擎是否运行
这里需要特别提醒：Harness引擎如果没启动，会导致所有Skill都在pending状态，救都救不了。在终端里跑一句qoderwakectl status，如果显示harness: offline或者not running，那就先运行qoderwakectl start再说。引擎起来了，Skill才能干活。