qoderwake skill是任务编排层，以skill.md封装ai“怎么做”；mcp服务是执行层，作为标准化接口让ai“能做什么”，二者分工明确、必须协同工作。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
QoderWake Skill和MCP服务不是同一层级的技术组件，不能直接比较“哪个更好”，而是分工明确、各司其职：前者定义AI该怎么做任务，后者让AI能连上外部系统执行动作。
QoderWake Skill 是什么
QoderWake Skill 是一个以 【SKILL.md 文件】 为核心的可复用工作流封装，专为 QoderWake 场景设计。它不处理连接，只负责编排逻辑。
第一步：打开任意支持 Skill 的 Qoder 环境（如 QoderWork 或 QoderWake CLI）→ 进入 Skills 目录 → 新建或复制一个 SKILL.md 文件。
第二步：在文件开头用 YAML frontmatter 定义元信息，例如 name: “紧急通知唤醒流程”，trigger: “当收到钉钉告警时自动触发”，requires: [“qoderwake-mcp”] —— 这里 【requires 字段必须显式声明依赖的 MCP Server 名称】，否则 Skill 运行时会因找不到底层能力而中断。
第三步：正文中用 Markdown 描述完整步骤：先调用 MCP 获取当前告警详情 → 解析优先级字段 → 若为 P0 级则触发电话唤醒 → 同步发送企业微信消息 → 最后记录日志到本地 SQLite。每一步都需标注 input/output 格式与错误重试策略。
这一步操作起来很简单，直接把 SKILL.md 文件拖进 QoderWake 的 skills/ 目录即可生效，无需重启进程。
MCP 服务是做什么的
MCP 服务是运行在本地或远程的独立进程，它不理解业务逻辑，只做三件事：认证、翻译、转发。
方法一：使用 Qoder 官方提供的 qoderwake-mcp-server 工具包
Qoder Linux版是由阿里推出的智能体自主开发工作台，支持开发者通过定义需求即可让Agent团队“自动驾驶”，自主完成代码执行、验证与交付的全流程。其全新的Quest独立视窗集成了任务管理与状态追踪能力，并支持跨项目多任务并行处理，显著提升开发效率。此外，Qoder还提供专家团模式与团队级知识引擎，适配复杂开发场景。
下载对应平台二进制 → 设置环境变量 QODER_WAKE_API_KEY 和 QODER_WAKE_BASE_URL → 执行 ./qoderwake-mcp-server start。服务启动后会在 localhost:3001 提供标准 MCP HTTP 接口。
方法二：自行实现 MCP Server
必须严格遵循 JSON-RPC 2.0 协议响应格式；每个 method 必须返回 tools 列表（含 description、parameters schema）；所有敏感凭证（如呼叫中心 Token）严禁硬编码进提示词或暴露给模型——【这是不可逆的安全风险】，必须保留在 Server 进程内存中。
方法三：对接已有企业通信网关
只要网关支持 webhook + OAuth2.0 认证，就能包装成 MCP Server。QoderWake 不关心你背后是 Twilio 还是阿里云语音，只认 MCP 协议层定义的 call_phone、send_wecom_msg 两个 method。
它们怎么配合工作
当用户在 QoderWake 中输入“帮我唤醒值班工程师”，整个链路如下：
QoderWake Host 接收指令 → Client 检查已加载 Skill → 匹配到 “紧急通知唤醒流程” Skill → Skill 解析出需调用 call_phone 工具 → Client 向本地 MCP Server 发起 tools/call 请求 → MCP Server 验证权限、组装 Twilio API 请求、获取响应 → 将结构化结果（如 {“call_id”: “CAxxx”, “status”: “queued”}）返回给 Client → Client 注入上下文 → Skill 继续执行下一步。
注意：如果 MCP Server 未运行或返回 401，Skill 不会自动降级，而是直接报错并终止流程——【Skill 本身不具备容错重试能力，它只信任 MCP 层交付的结果】。
