用途:面向飞书审批场景的催办工作流,自动查询待审批实例、定位当前审批人并发送催办提醒,支持逐级升级催办策略。触发场景包括“催审批”“催办”“审批提醒”“提醒审批人”“跟进审批流程”“审批到谁了”。
主要能力:按实例 ID 或审批定义 code 查询审批实例状态;从返回结果中提取当前审批节点与审批人(个人 open_id 或群组);查询审批人信息;发送催办消息;超过 24 小时未处理时升级为群内 @催办,超过 48 小时通知上级或发起人。
使用方式:开始前必须先用 Read 工具读取 ../lark-shared/SKILL.md(含认证与权限处理)。需 user 身份查询审批、bot 身份发消息,登录命令为 lark-cli auth login --domain im,contact --scope "approval:instance:readonly"。审批 API 未被 lark-cli 直接封装,需用 lark-cli api 调用,首次使用前参考 ../lark-openapi-explorer/SKILL.md 确认 API 路径。查询实例示例:MSYS_NO_PATHCONV=1 lark-cli api GET "/open-apis/approval/v4/instances/<instance_id>" --as user;按 code 查询待审批列表时 status 为 1(审批中)、2(已通过)、3(已拒绝)、4(已撤销)、6(已转交)。查找审批人:lark-cli contact +search-user --query "<审批人姓名>" --as user。发送催办:lark-cli im +messages-send --user-id "<approver_open_id>" --markdown "..." --as bot。
权限:approval/v4/instances (GET) 需 approval:instance:readonly;contact +search-user 需 contact:user.base:readonly;im +messages-send 需 im:message。
限制与降级:审批 API 不可用时提示检查 approval 权限;查不到实例时提示确认实例 ID 或审批名称;审批人查不到时用返回的 open_id 直接发送;消息发送失败时输出催办信息供手动通知;无群聊可 @ 时跳过群内催办直接通知个人;审批已完成则告知无需催办。具体 API 参数与响应格式以官方文档为准。