必须完成技能注册与上下文绑定，否则waker无法执行自定义业务逻辑；需先确认主服务运行状态及权限，再通过skill.md或yaml两种方式注册skill，并验证其激活状态与调用能力。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
你想让QoderWake的Waker具备新能力，比如自动写周报、校验订单字段或生成面试题，但不知道如何把Skill装进Waker里——这一步必须完成技能注册与上下文绑定，否则Waker只会响应内置指令，无法执行你定义的业务逻辑。
确认Waker运行状态与权限基线
Waker不是独立进程，它依附于QoderWake主服务运行。若主服务未就绪，任何Skill注册都会失败，且不会给出明确错误提示。
执行qoderwake status，检查输出中service_state是否为running，worker_count是否≥1。
若显示offline或0 workers，先运行qoderwake start；若提示permission denied，说明当前用户未加入qoder用户组，需用sudo usermod -aG qoder $USER并重启终端。
方法一：通过SKILL.md快速加载轻量级Skill
适合通用型辅助任务，如文档摘要、日志归类、代码风格检查等，无需外部依赖或API调用。
第一步：在项目根目录下创建.qoder/skills/weekly-report/SKILL.md
第二步：写入以下内容（name字段必须全小写、无空格、唯一）：
name: weekly-report<br>description: 根据本周Git提交记录生成技术周报<br>input_schema:<br> type: object<br> properties:<br> branch:<br> type: string<br> default: "main"<br>output_schema:<br> type: object<br> properties:<br> report:<br> type: string<br>examples:<br>- input: {branch: "dev"}<br> output: {report: "【周报】共提交12次..."}<br>
第三步：保存文件后，在Qoder IDE中输入/→回车→打开Skills Catalog，搜索weekly-report，确认卡片右上角显示“已启用”。【若未出现，请检查文件路径是否严格为.project-root/.qoder/skills/weekly-report/SKILL.md，多一级或少一级都会导致扫描失败】
方法二：用YAML注册需对接外部服务的Skill
当你需要调用内部ERP接口、发钉钉审批、或执行Shell命令时，必须用YAML定义完整执行链路与容错策略。
创建order-validate.yaml文件，填入以下结构：
name: order-validate<br>version: 1.0.0<br>description: 校验订单履约字段完整性<br>input_schema:<br> type: object<br> required: [order_id]<br> properties:<br> order_id:<br> type: string<br>output_schema:<br> type: object<br> properties:<br> valid:<br> type: boolean<br>steps:<br>- action: http.get<br> params:<br> url: "https://erp.internal/api/order/{input.order_id}"<br> timeout: 5000<br> on_failure: return_fallback<br>- action: python.run<br> params:<br> code: |<br> if response.status_code == 200:<br> return {"valid": "delivery_date" in response.json()}<br> else:<br> return {"valid": false}<br>
执行注册命令：qoder skill register --file order-validate.yaml
成功后返回类似skill_id: qw-skill-7f3a9d2e的字符串，该ID即为Waker调用此Skill的唯一凭证。
验证Skill是否被Waker识别并可调用
在任意QoderWake聊天窗口中输入自然语言指令：“我已经装了哪些 Skill?”
等待3～5秒，查看返回清单中是否包含你刚注册的Skill名称及版本号。
若返回为空或未列出新Skill，执行qoder skill list --format=table，检查status列是否为active；若为pending，说明YAML校验未通过，需检查steps中action值是否拼写正确（如http.get不能写成http_get）。
确认可见后，直接输入：“用order-validate校验order_id=ORD-20260730-001”，Waker将立即触发该Skill执行。
