用途:该技能面向 Flue 的渠道(channel)建设,目标是把某一个提供方渠道做到 release-ready,但不发布、不部署、不打 tag。它把每个提供方渠道视为对 Flue 渠道基础的检验:保留提供方原生语义,与现有渠道对比,只有出现具体跨提供方证据时才改进共享机制。
主要流程与要求:先阅读仓库说明和当前 provider 计划,设计前先读 references/audit-matrix.md。界定 Flue 与应用的边界:Flue 负责已认证校验的 HTTP 入口、channels/<name>.ts 下固定发现路由、提供方原生类型载荷与必需协议响应、投递与规范化会话身份、可预测的 Hono 兼容 handler 结果;应用负责出站 SDK/凭证、defineTool() 与授权策略、安装 OAuth 令牌存储刷新、webhook 注册续订、去重与业务持久化。不得添加通用事件模式、通用出站客户端、提供方工具集合、安装框架或长连接传输;会话键只是标识符,不是授权凭据。
类型与载荷:默认采用提供方原生载荷作为渠道契约,优先复用提供方维护的类型包、SDK 导出、生成 schema 或 DefinitelyTyped,不要另建平行模型。原样传递提供方解析后的 wire 对象,不改字段名、不移动属性、不过滤有效投递;回调属性按提供方语义命名,不强制叫 event。仅在 Flue 需要掌控入口边界时校验:认证与防重放、body 与传输编码、必需握手或响应、构造函数明确承诺的租户/应用身份、路由与调用所需最小结构。经认证的投递应转发给应用代码,除非是包自有协议消息;过滤机器人、消息子类型等属应用策略。
实施前资格判断:浏览一手官方协议、认证、重试、SDK、运行时与 API 文档,判断是否有用的入站 HTTP 面、确切认证与字节保留要求、事件族、批处理、重试、投递身份、稳定标识、是否为无状态 HTTP(而非轮询或持久 socket)、Node 与 Cloudflare Workers 可行路径、最佳类型来源与依赖成本、适合示例的出站客户端。若需要长驻进程、提供方托管服务、无法验证的入站请求,或仅 Node 无 Workers 替代,应记录证据与阻塞点并推迟。
实施与验证:一次交付包、测试、示例、channel 蓝图、设置指南、API 参考、导航、包准备映射与 changelog。保持运行时依赖最小,公共上下文与 handler 类型直接用 Hono。示例需展示 export channel、真实客户端、派发已验证事件给 agent、带注释的完整发现 URL、可选路由注释保留等。用协议规范生成原创合成载荷,测试公开行为:认证有效/无效、内容类型与 body 限制、握手与必需确认、响应序列化与错误、原生载荷透传、租户身份检查、投递与会话身份、可选路由发布,以及在 Node 和 workerd 中实际执行(不能只靠打包声称支持 Cloudflare)。最后做范围与简洁性审计、记录分类与理由,对比现有渠道记录基础改进,提交后停在发布之前。
限制:不得联系真实提供方 API;不得发布、部署、打 tag 或版本化;共享机制改动需失败场景或违反不变式作为依据;资料未说明价格、收费或平台细节。