需结合Skills机制与YAML契约规范完成结构化封装：一、用SKILL.md定义技能并自动加载；二、用YAML注册含执行逻辑的自定义Skill；三、调用100+内置Skill并注入上下文；四、配置Webhook接收异步事件；五、通过IDE调试、权限校验与trace_id验证全链路。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您希望在QoderWake中构建具备业务语义理解与执行能力的专属技能，但尚未理清其从定义、注册到调用的完整链路，则需结合Skills机制与YAML契约规范完成结构化封装。以下是实现该目标的具体路径：
一、使用SKILL.md创建用户级或项目级技能
该方法通过Markdown格式定义技能行为契约，适用于通用型辅助任务（如文档摘要、日志归类）或项目专属逻辑（如特定API请求模板、代码风格校验规则）。QoderWake自动扫描预设路径下的SKILL.md文件并加载为可调用能力。
1、确定技能作用域：若为跨项目复用技能（如“写技术周报”），创建路径为~/.qoder/skills/report-weekly/SKILL.md；若为单项目专用（如“校验订单履约字段”），则创建路径为{projectPath}/.qoder/skills/order-validate/SKILL.md。
2、在SKILL.md中声明核心字段：包含name（唯一标识）、description（用途说明）、input_schema（JSON Schema定义输入参数）、output_schema（定义返回结构）、examples（至少1个典型调用示例）。
3、保存后，在Qoder IDE中输入/或向AI提问“我已经装了哪些 Skill？”，确认该技能已出现在可用列表中。
二、通过YAML注册自定义Skill并注入执行逻辑
该方法面向需对接外部服务或执行复杂原子动作的技能，以YAML格式声明执行步骤、依赖库、权限约束及错误恢复策略，经QoderWake技能注册中心校验后纳入API网关路由体系。
1、在本地创建skill.yaml文件，填写name、version、description、input_schema、output_schema五项必填元数据。
2、在steps字段中逐条定义执行序列：每步指定action（如http.post、shell.exec、python.run）、params（参数映射）、timeout（毫秒级超时）及on_failure（失败后跳转至指定step或返回fallback）。
3、若涉及第三方库调用，在dependencies节声明包名与版本约束（如- requests>=2.31.0），并确保已通过qoder pip install完成沙盒安装。
4、执行qoder skill register --file skill.yaml提交注册；系统返回skill_id即表示注册成功，可在/v1/skill/execute端点中调用。
三、调用100+内置技能模块并配置上下文增强
QoderWake预置覆盖开发、运维、协作三大领域的100+标准化Skill，全部通过统一/v1/skill/execute接口触发，调用时需显式注入会话上下文以激活语义适配能力。
1、查看内置技能清单：执行qoder skill list --builtin，输出含id、category（如code、infra、comms）、support_context（支持的上下文类型）三列。
2、构造调用请求Body：包含skill_id（如git.pr-diff-analyze）、input_payload（按该Skill的input_schema填充）、context_id（当前会话ID）、target_workspace（目标Git仓库路径或Slack频道ID）。
代码编辑 CLI 工具集合：Cursor CLI（agent）和 Qoder CLI（qodercli），用于代码修改、重构、Code Review 及自动化代码任务。
3、为提升响应准确性，在调用前通过/v1/memory/retrieve拉取最近3次同类任务的记忆快照，并将memory_id注入input_payload.context_memory_ids字段。
4、发送POST请求至/v1/skill/execute，响应体中execution_id可用于后续状态轮询或trace_id调试追踪。
四、扩展技能能力：绑定Webhook接收异步事件反馈
当技能需响应外部系统主动推送（如CI流水线完成、监控告警触发、直播弹幕峰值），应配置Webhook端点接收原始事件，并由QoderWake Adapter服务完成协议转换与上下文注入。
1、在QoderWake控制台进入「技能配置 → Webhook」页面，点击“新建端点”，填写回调URL（需HTTPS且支持POST）、验证Token及重试策略（最大3次，间隔1s/5s/15s）。
2、为该Webhook分配唯一webhook_id，并在对应Skill的YAML中引用：trigger: webhook:<strong><font color="green">webhook_id_abc123</font></strong>。
3、部署Adapter服务，接收原始事件后解析出event_type（如ci.pipeline.success）、source_id（如github:org/repo:workflow-id=12345）、payload（原始JSON载荷），并转换为Harness-First标准格式。
4、Adapter向/v1/skill/execute发起带webhook_id与raw_event的POST请求，QoderWake自动匹配已注册Skill并注入context_id与urgency_level元数据。
五、调试与验证专属技能执行链路
专属技能上线前必须完成端到端验证，重点检查输入解析正确性、权限红线拦截有效性、执行结果结构合规性及trace_id全链路可追溯性。
1、在Qoder IDE中打开调试面板（Ctrl + Alt + D），输入测试用例触发Skill，观察左侧Agent决策链是否准确识别skill_id与input_schema匹配。
2、在执行步骤中任意节点插入debug: true字段，使该step输出完整输入/输出快照至调试面板，用于比对预期与实际值。
3、在/v1/permission/check端点手动提交拟执行操作的action_type（如http.post）、resource_path（如https://api.internal/order/v1/validate）、impact_level（如high），确认返回allowed: true。
4、调用完成后，从响应头提取X-Trace-ID，在QoderWake审计日志中心搜索该ID，验证是否完整记录技能注册信息、内存注入过程、工具调用参数及权限校验结果。
