lark-event

用途：监听、订阅并消费 Lark/飞书实时事件。核心命令：lark-cli event list 列出可订阅的 EventKey（--domain 支持 application、approval、board、card、im、minutes、task、vc）；schema 查看参数与输出结构；consume 阻塞消费并输出 NDJSON；status 检查本地总线；stop 停止总线。常用参数：--param/-p 业务参数，--jq 过滤转换，--max-events N 与 --timeout D 限定运行，--output-dir 落盘，--as 指定身份。用法流程：先 list 选键，再 schema 读取 jq_root_path 与字段说明，最后 consume。每个进程只处理一个 EventKey，多键即多进程；消费前需先阅读 ../lark-shared/SKILL.md 处理认证与权限。子进程契约：stderr 出现 [event] ready 后再读 stdout；stdin EOF 对无界运行是优雅退出信号，可用 < <(tail -f /dev/null) 或设置边界参数保活；退出码 0 表示 limit/timeout/signal 正常完成，非 0 为失败，错误为结构化 JSON 信封，应解析 error.type/subtype/param/hint，不要匹配文本。勿对注册服务端订阅的键使用 kill -9，以免残留订阅。限制：不支持多键或通配符；--quiet 会隐藏事件丢失告警，不建议 AI 使用；jq 写作需以 schema 为准，字段可能已被预先解码；--param 缺省表示该键不接受参数。