SuperAPI AI 工具集

lark-workflow-approval-accelerator

办公与效率

查看项目

更新于 10-16 10:16

技能介绍

审批加速器是一个面向飞书(Lark)审批场景的工作流技能,主要用于解决审批流程中卡住、催办不及时的问题。它打通了「审批查询 → 进度追踪 → 超时检测 → 催办通知」的完整链路。

【主要能力】 支持两个核心功能。其一为追踪模式,查看用户本人发起的审批进展,并识别超时未处理的实例;其二为待办模式,列出等待用户本人处理的审批。工作流会依据等待时长自动判断哪些审批属于超时,并可在用户确认后向审批人发送礼貌的催办消息。

【适用场景】 用户问「我的审批到哪了」「审批进度怎么样了」「帮我催一下审批」「XX 审批怎么还没通过」「有哪些审批等着我处理」「待我审批的有哪些」「催办超时的审批」「审批加速」(Approval tracking)等场景。

【使用方式】 使用前须先用 Read 工具读取 lark-shared/SKILL.md(其中包含认证、权限处理和安全规则),并且只支持 user 身份,需先执行授权命令:lark-cli auth login --domain approval,im,contact。

注意:approval 域没有 Shortcut(+verb)命令,必须使用原生 API 格式。使用前查看参数结构:lark-cli schema approval.<resource>.<method>,调用方式为 lark-cli approval <resource> <method> [flags]。

核心流程如下:

  1. 理解用户意图,分流为「我发起的审批」(追踪 + 催办)与「待我审批的」(待办提醒)。
  2. 首次使用时先查看参数结构:lark-cli schema approval.tasks.query,关键参数 topic 中,1 表示我发起的审批任务,2 表示待我处理的审批任务;user_id 可不传,默认查询当前登录用户。
  3. 查询我发起的审批:lark-cli approval tasks query --data '{"page_size":20,"topic":1}' --format json,并从结果中提取 task_id、instance_id、status、title、start_time(Unix 时间戳,秒)。
  4. 查询待我审批的:lark-cli approval tasks query --data '{"page_size":20,"topic":2}' --format json。
  5. 获取审批实例详情:先执行 lark-cli schema approval.instances.get,再执行 lark-cli approval instances get --params '{"instance_id":"<instance_id>"}' --format json,可提取 approval_name、status、start_time、timeline、task_list。
  6. 分析等待时间:用 date "+%s" 获取当前时间,等待时间 = 当前时间(秒) - start_time。超时阈值规则为:通用默认 24 小时;标题含「紧急」「加急」的紧急审批 4 小时;请假/报销类 48 小时。
  7. 展示审批状态:追踪模式输出超时审批、正常进行中、近期已完成三部分;待办模式输出紧急/等待较久与常规两部分。
  8. 发送催办消息(须用户确认后):先从 timeline 或 task_list 找到 PENDING 状态的审批人 user_id,如需按姓名搜索用户可执行 lark-cli contact +search --query "<审批人姓名>" --format json;再执行 lark-cli im +messages-send 发送催办消息(参考 lark-im/SKILL.md),语气应礼貌、专业,不建议对同一审批人连续重复催办,建议每 24 小时最多催办 1 次。
  9. 输出催办执行报告。

【权限】 查询审批任务 approval tasks query 需 approval:task:read(必选);审批实例详情 approval instances get 需 approval:instance:read(催办时必选);搜索用户 contact +search 需 contact:user.base:readonly(催办时推荐);发送催办 im +messages-send 需 im:message:send_as_bot 或 im:message(催办时推荐)。

【容错机制】 approval 域未授权时,提示用户授权并显示授权命令;无待处理审批时,告知当前没有进行中的审批;API 参数不确定时,先执行 lark-cli schema approval.<resource>.<method> 查看结构;审批人 user_id 无法获取时,展示审批信息但标注无法自动催办;消息发送失败时,记录失败并建议用户手动沟通;审批类型无法识别时,使用通用超时阈值(24 小时)。

【限制】 仅支持 user 身份;approval 域必须使用原生 API 格式而非快捷命令;发送催办消息必须经用户确认后才可执行。