用途
该技能指导开发者在 evlog 中增加内置输出适配器,将宽事件发送到外部可观测性平台。它面向适配器开发与仓库集成,既说明实现结构,也列出需要同步更新的配套文件。
主要能力
适配器复用 evlog/toolkit 的公共原语,与社区适配器保持相同结构。HTTP 输出以 defineHttpDrain 为基础,开发者主要负责解析最终配置以及根据一批事件构造发送请求;传输、身份请求头、重试、超时和错误记录由公共工具处理,避免重复实现。
工作流程
原文列出十二项检查点,覆盖适配器源码、构建入口、包导出、单元测试、端到端测试、生成资料、适配器文档、概览页面、公开 Skill、changeset、PR scope 及服务端接收接口与官方客户端的参考信息。新增内容应沿用现有命名和配置选项约定;历史配置名需要作为弃用别名处理时,参考已有实现。
端到端测试由环境变量控制;目标服务可自行部署时,还应补充相应沙箱。最终需执行文档中列出的构建与测试验证,不能只完成适配器源码就认定任务结束。
注意事项
语义化 PR 标题检查读取的是目标分支的 scope 列表。刚新增的 scope 无法直接用于验证引入它的同一条 PR,因此应先单独注册,或在引入时使用不带 scope 的标题。该技能提供实现与验收规范,不代表适配器已经开发或接入真实服务。