qoderwake安装skill后任务不执行，需依次检查激活状态、路径与命名规范、触发条件匹配、权限策略拦截，并通过cli命令和日志验证；执行qoder skill status、enable、info、debug permission-check等命令定位问题根源。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
QoderWake安装Skill后任务不执行，说明技能虽已注册但未被调度器识别或未满足触发前提，常见于路径错误、状态未激活、依赖缺失或权限链断裂——此时界面无报错，日志中也查不到skill_invocation事件。
确认Skill是否真正启用
第一步：在终端执行qoder skill status <skill_name></skill_name>，例如qoder skill status local-log-analyzer。若输出中active为false或offline_capable为false，说明该Skill处于禁用或离线不可用状态。
第二步：执行qoder skill enable <skill_name></skill_name>强制启用。注意：部分Skill启用时会自动校验依赖项，若返回missing dependency: jq等提示，必须先安装对应系统工具。
第三步：重启QoderWake服务，否则新启用状态不会加载进运行时沙盒。执行qoderwakectl restart，等待约8秒后再验证状态。
检查Skill文件路径与命名规范
QoderWake的Skill加载器对路径和文件名极其敏感，任意层级偏差都会静默跳过加载，且不报错。
方法一：CLI命令定位实际加载路径
执行qoder skill info <skill_name></skill_name>，查看source_path字段。若显示/home/user/.qoderwake/skills/local-log-analyzer/skill.yaml，则必须确保该路径下存在skill.yaml且其name:字段值与命令中使用的<skill_name></skill_name>完全一致（含大小写）。
方法二：手动校验目录结构
进入~/.qoderwake/skills/目录，确认子目录名与Skill名完全相同；该子目录内必须包含skill.yaml（不可是SKILL.YAML或skill.yml），且文件首行必须为name: local-log-analyzer——【name字段值必须与CLI中调用的名称一字不差】。
Qoder Linux版是由阿里推出的智能体自主开发工作台，支持开发者通过定义需求即可让Agent团队“自动驾驶”，自主完成代码执行、验证与交付的全流程。其全新的Quest独立视窗集成了任务管理与状态追踪能力，并支持跨项目多任务并行处理，显著提升开发效率。此外，Qoder还提供专家团模式与团队级知识引擎，适配复杂开发场景。
验证触发条件是否匹配
即使Skill已启用且路径正确，若未配置任何触发方式，它永远不会被调用。
第一步：打开QoderWake管理控制台→「触发管理」页面。
第二步：检查是否存在针对该Skill的有效触发规则，例如关键词触发中是否设置了“分析日志”并关联了local-log-analyzer。
第三步：若使用API回调触发，需确认Webhook请求体中skill_ref字段值与Skill的name字段严格一致，并通过qoder debug trigger-match --payload '{"skill_ref":"local-log-analyzer"}'本地模拟验证匹配结果。
排查权限红线拦截
权限红线策略可能在未提示的情况下阻断Skill执行，尤其当Skill尝试访问被限制的资源时。
执行qoder debug permission-check --skill <skill_name></skill_name>，例如qoder debug permission-check --skill local-log-analyzer。若输出中出现blocked_by: write_to_prod_db或requires_human_approval，说明该Skill的某项操作已被激活的权限策略拦截——【必须前往「设置→权限红线」关闭对应策略或添加白名单路径】。
强制触发一次并捕获实时日志
方法一：CLI即时调用
执行qoder skill run <skill_name> --input '{"log_path":"/var/log/app.log"}'</skill_name>。若返回error: no executor found，说明Skill定义中缺失executor:字段或指向的二进制文件不存在。
方法二：绑定调试日志流
新开一个终端窗口，执行tail -f /var/log/qoderwake/agents/$(hostname)/runtime.log | grep -E "(skill_invocation|decision_boundary)"，再在另一窗口运行上述qoder skill run命令。若日志中完全无skill_invocation事件，证明调度器根本未将请求路由至该Skill——问题出在注册或激活环节。
