qoderwake需建立skill分层管理机制：用户级skill放~/.qoder/skills/，项目级放{projectpath}/.qoder/skills/；自定义skill须用yaml注册steps逻辑；通过qoder skill list/enabledisable管理状态。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
你需要在QoderWake中同时启用文档摘要、日志归类、API校验等多个Skill，但发现它们互相干扰或无法按需调用，说明当前未建立清晰的Skill分层管理机制。
区分用户级与项目级Skill作用域
用户级Skill适用于跨项目复用的通用能力，比如“写技术周报”；项目级Skill则绑定具体代码库上下文，如“校验订单履约字段”。路径错误会导致Skill加载失败或被忽略。
若为通用型技能，在~/.qoder/skills/report-weekly/SKILL.md
若为单项目专用，在{projectPath}/.qoder/skills/order-validate/SKILL.md创建SKILL.md文件。注意{projectPath}必须是当前Git仓库根目录，否则QoderWake扫描时会跳过该路径。
【路径必须存在且有读取权限】，否则QoderWake启动时不报错但静默忽略该Skill。
用YAML注册含执行逻辑的自定义Skill
当Skill需要调用外部API、执行Shell命令或运行Python脚本时，仅靠SKILL.md无法承载执行逻辑，必须通过YAML注册并注入steps序列。
方法一：注册带HTTP请求的Skill
1、新建skill.yaml，填写name、version、description、input_schema、output_schema五项必填元数据；
2、在steps字段中添加第一步：action: http.post，params: { url: "https://api.example.com/validate", body: "{{ input.payload }}" }；
3、执行qoder skill register --file skill.yaml，系统返回skill_id即表示注册成功。
方法二：注册带失败恢复策略的Skill
Qoder Linux版是由阿里推出的智能体自主开发工作台，支持开发者通过定义需求即可让Agent团队“自动驾驶”，自主完成代码执行、验证与交付的全流程。其全新的Quest独立视窗集成了任务管理与状态追踪能力，并支持跨项目多任务并行处理，显著提升开发效率。此外，Qoder还提供专家团模式与团队级知识引擎，适配复杂开发场景。
1、在同个steps中定义第二步：action: python.run，params: { script: "fallback_handler.py" }；
2、为第一步配置on_failure: jump_to: step_2；
3、确保fallback_handler.py已放入./scripts/目录并具有可执行权限。
查看、启用与禁用已注册Skill
第一步：列出全部Skill状态
执行qoder skill list，输出含status列，值为active、inactive或failed。
第二步：禁用某个高风险Skill
执行qoder skill disable --id sk-8a2f4c1e，该操作立即生效，无需重启服务。
第三步：启用被禁用的Skill
执行qoder skill enable --id sk-8a2f4c1e，系统自动校验其YAML契约完整性与依赖库就绪状态。
第四步：确认启用结果
再次运行qoder skill list --id sk-8a2f4c1e，检查status是否变为active且last_updated时间戳已刷新。
