QoderWake Skill安装后怎么测试是否生效？

安装完一个QoderWake Skill后，你无法仅靠界面图标或开关状态判断它是否真正加载成功、能否被调用、是否具备预期功能。必须通过可验证的执行路径确认。以下三种验证方法覆盖了从轻量触达到底层引擎检查的全流程，确保技能处于可用状态。

用自然语言指令触发并观察响应

这一步最轻量，适合快速验证Skill基础连通性，无需记忆语法或切换视图。

• 在任意QoderWake聊天窗口中输入：

  “请运行【你的Skill名称】”
  ，例如“请运行代码审查助手”。
• 等待3～5秒，若Skill已生效，会立即返回结构化结果（如代码缺陷列表、评分摘要或操作建议）。
• 【若返回“未找到该技能”或长时间无响应，则说明未启用或名称不匹配】

部分Skill需前置参数才能触发，比如“请用GitHub PR分析器检查最近一次合并请求”，空泛指令可能被路由到默认助手。

通过CLI执行标准调用指令验证

这是最权威的验证方式，绕过UI层不确定性，直接命中Skill执行引擎。

1. 打开终端，进入项目根目录或任意路径均可。
2. 执行命令 qoder skill exec --use="skill-name"，其中 skill-name 替换为实际Skill标识符（不是中文名，而是如 code-reviewer-v2 这类小写短横线格式）。
3. 观察终端输出：
   • 成功时显示 ✅ Executed successfully 及JSON格式结果。
   • 失败时提示 error: skill not found 或 permission denied。

小提示：如果提示 permission denied，说明该Skill依赖本地工具链（如git、python3），需先运行 qoder skill grant --all 授予必要权限。

检查Skill状态与离线能力标识

有些Skill在无网络时不可用，但你可能需要确认它是否支持离线运行。

• 运行命令：qoder skill status skill-name（将 skill-name 替换为实际名称）。
• 查看输出字段：
  • active 应为 true。
  • offline_capable 若为 true 表示可在断网环境下执行核心逻辑。
• 若 active 为 false，需手动启用：qoder skill enable skill-name。

【关键提醒：enable操作不会自动授予文件系统权限，仍需单独执行 qoder skill grant】

常见问题

• 为什么自然语言指令说“未找到该技能”？
  — 检查技能名称是否准确，部分技能要求完整中文名或英文标识符；确认技能已通过 qoder skill install 安装成功。

• CLI执行时提示 permission denied 如何处理？
  — 依次运行 qoder skill grant --all 授予所有权限，或单独授予特定工具链权限（如 qoder skill grant git）。

• 状态检查中 offline_capable 为 false 是否影响使用？
  — 不影响在线使用，但断网后该技能将无法执行，需确保网络连接。

• 启用技能后为什么还是无法调用？
  — 确认 active 已变为 true，同时检查是否已授予所需权限（尤其是文件系统或网络权限）。

通过以上三步验证，你可以全面确认QoderWake Skill是否安装成功、能否正常调用、以及是否具备离线能力。建议在每次安装或更新技能后立即执行这套流程，避免后续使用中间出现意外问题。