qoderwake安装skill前需确保服务已启动、skills目录结构合规、node.js与npm版本达标，并正确编写skill.md文件。否则skill.md被静默忽略，技能列表为空，/命令无法调用能力且无错误提示。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
QoderWake安装Skill前必须确保本地环境已就绪，否则SKILL.md文件会被静默忽略、技能列表为空、/命令无法调用任何能力，且不会提示具体错误原因。
确认QoderWake服务已成功启动
打开终端，执行qoderwake status。若返回active (running)，说明服务正在后台运行；若显示inactive或报错command not found，请先完成QoderWake主程序安装与service install步骤，再继续后续操作。
这一步不可跳过——【未启动的服务不会扫描任何skills目录】。
检查Skills目录结构是否合规
QoderWake只识别两种路径下的SKILL.md文件：
用户级技能：必须放在~/.qoder/skills/{skillName}/SKILL.md（macOS/Linux）或%USERPROFILE%\.qoder\skills\{skillName}\SKILL.md（Windows）；
项目级技能：必须放在当前工作区根目录下的.qoder/skills/{skillName}/SKILL.md，且该目录需在git仓库根路径内。
注意：【{skillName}只能是小写字母、数字、短横线的组合，不能含空格或下划线】，例如code-review合法，code_review或My Skill将被跳过。
验证Node.js与npm版本是否达标
执行node -v，输出必须为v18.19.0或更高；执行npm -v，输出必须≥9.0.0。
低于此版本会导致YAML注册方式失败、依赖解析中断、甚至SKILL.md中input_schema字段校验不通过。
Qoder Linux版是由阿里推出的智能体自主开发工作台，支持开发者通过定义需求即可让Agent团队“自动驾驶”，自主完成代码执行、验证与交付的全流程。其全新的Quest独立视窗集成了任务管理与状态追踪能力，并支持跨项目多任务并行处理，显著提升开发效率。此外，Qoder还提供专家团模式与团队级知识引擎，适配复杂开发场景。
若版本不符，请访问https://nodejs.org下载LTS版本重新安装，旧版本不兼容QoderWake 0.3.5+的契约解析引擎。
准备第一个Skill文件内容
新建一个文本文件，命名为SKILL.md，内容至少包含以下四块：
name: 必须唯一，如hello-world；
description: 一句话说明用途，如返回固定欢迎语；
input_schema: 即使无输入也需写成{}；
output_schema: 同样不能为空，可写{"message": "string"}；
examples: 至少提供一个调用示例，格式为- input: {} → output: {"message": "Hello, Qoder!"}。
保存后，确保该文件位于前述任一合规路径中，且父目录名与name值完全一致。
