第十九节：SaaS生态接入——打通GitHub与Notion

引言

上一章，我们通过状态机将复杂的多步骤任务编排得井井有条，实现了技能的“自动化闭环”。但真正的生产力革命，往往发生在不同系统之间。本章，我们将跳出单一技能，直面一个更普遍的痛点：如何在GitHub、Notion这类SaaS巨头构建的生态壁垒间架起桥梁，让数据与流程自由流动，构建属于你自己的自动化中枢。

核心理论

接入SaaS生态，本质是与成熟的Web API进行对话。这要求我们掌握两大核心武器：OpenAPI规范与Webhook回调机制。

1. OpenAPI规范：这是第三方服务（如GitHub、Notion）提供的“产品说明书”。它严格定义了你能做什么（端点/Endpoint）、需要说什么（请求体/Request Body）、以及对方会回答什么（响应体/Response Body）。遵循它，是成功调用的前提。其核心要素包括：认证方式（通常是Bearer Token）、资源路径、HTTP方法（GET/POST等）和数据结构（JSON Schema）。
2. Webhook与异步任务：对于“监听事件并触发动作”的场景（如Issue创建时通知我），轮询（Polling）是低效的。Webhook是“反向API”，由服务商在事件发生时主动向你的服务器发送一个HTTP POST请求（携带事件数据）。你的Skill需要提供一个公网可访问的端点来接收它，并快速返回200状态码确认接收，后续处理则应放入异步任务队列，避免超时。这是构建实时、响应式自动化流程的基石。