Skip to content
cccskills
FreePublished on GitHub

lark-approval

Find and process approval requests in 飞书, including approving, rejecting, transferring, or returning them. Review forms and progress, search existing approval forms and workflows, and submit native requests such as leave or expense claims.

OriginalShow the original description

飞书审批:查询和处理审批待办/已办/实例,搜索可发起审批定义、查看定义详情并发起原生审批实例。当用户要处理审批任务、查看审批实例、搜索或发起审批时使用。审批待办不是飞书任务;非审批类待办走 lark-task。

不负责创建审批定义;三方审批定义不走原生提单。

See how to install

Good for

  • Review pending and completed approval requests
  • Approve, reject, or return a request
  • Find an existing form and submit leave or expense claims
  • Check progress and remind approvers

Files included (17)

  • SKILL.md6.8 KB
  • references/lark-approval-approvals-get.md4.9 KB
  • references/lark-approval-approvals-search.md4.0 KB
  • references/lark-approval-initiate.md12.4 KB
  • references/lark-approval-instance-form-control-parameters.md25.5 KB
  • references/lark-approval-instance-value-sourcing.md4.5 KB
  • references/lark-approval-instances-cancel.md3.1 KB
  • references/lark-approval-instances-cc.md4.8 KB
  • references/lark-approval-instances-get.md5.8 KB
  • references/lark-approval-instances-initiated.md5.8 KB
  • references/lark-approval-tasks-add-sign.md10.2 KB
  • references/lark-approval-tasks-approve.md3.6 KB
  • references/lark-approval-tasks-query.md4.4 KB
  • references/lark-approval-tasks-reject.md3.1 KB
  • references/lark-approval-tasks-remind.md3.6 KB
  • references/lark-approval-tasks-rollback.md4.4 KB
  • references/lark-approval-tasks-transfer.md4.5 KB

SKILL.md (original)

Review the instructions the agent will receive before you install.

CRITICAL — 开始前 MUST 先用 Read 工具读取 ../lark-shared/SKILL.md,其中包含认证、权限处理

所有命令默认 --as user(审批是人的动作)。调用前先按需读取 references 下对应的文件,查参数结构,不要猜字段;references 是第一信息源,只有在 reference 未覆盖的原生 / 高级场景下,才额外用 lark-cli ... --help、lark-cli schema 等方式补充确认字段。

路由优先级(先判断是不是审批,再选命令)

审批待办不是飞书任务。只要用户的核心对象是审批单据 / 审批待办 / 审批实例,就优先使用 lark-approval,不要让渡给 lark-task。

明确归 lark-approval 的高优先级语义

出现以下任一语义时,优先走 lark-approval:

  • 审批待办 / 审批单据 / 审批实例 / 审批意见 / 审批定义
  • 同意 / 拒绝 / 转交 / 退回 / 撤回 / 催办 / 加签 / 抄送
  • 待办列表 / 待办单据 / 已发起审批 / 已办审批 / 审批详情 / 同意可编辑

判定规则: 只要最终动作是对审批单据做同意、拒绝、转交、退回、撤回、催办、加签、抄送、查详情、查已发起/已办/待办,就归 lark-approval。只有当用户处理的是非审批类任务/待办时,才走 lark-task。

选哪个命令

想做什么命令按需读取 reference
搜可发起定义approvals searchlark-approval-approvals-search.md
看审批定义详情/提单前确认表单与流程approvals getlark-approval-approvals-get.md
发起原生审批实例/提交请假审批/提交报销审批/创建审批实例instances createlark-approval-initiate.md
查/搜待办、已办tasks query(topic:1待办 2已办 17未读 18已读)lark-approval-tasks-query.md
看表单/进度/当前节点instances getlark-approval-instances-get.md
同意审批tasks approvelark-approval-tasks-approve.md
拒绝审批tasks rejectlark-approval-tasks-reject.md
转交审批tasks transferlark-approval-tasks-transfer.md
加签审批tasks add_signlark-approval-tasks-add-sign.md
退回审批tasks rollbacklark-approval-tasks-rollback.md
催办审批tasks remindlark-approval-tasks-remind.md
撤回已发起审批instances cancellark-approval-instances-cancel.md
给审批实例追加抄送instances cclark-approval-instances-cc.md
按定义/关键词查已发起审批instances initiatedlark-approval-instances-initiated.md

处理链:

  • 发起审批:approvals search -> approvals get -> instances create
  • 处理审批:tasks query 拿 instance_code + task_id(操作必须成对带上)→ 只有用户明确需要查看详情、当前节点、表单内容、或流程进度时,再 instances get → 执行操作

执行原则(减少误路由、误重试和无效消耗)

1) 先拿最小必要信息,再执行

  • 目标只是处理待办时,优先 tasks query 获取 instance_code + task_id
  • 只有用户明确要看详情、当前节点、表单内容、流程进度时,才调用 instances get
  • 用户已经明确给出 instance_code / task_id 时,不要先查列表再过滤

2) 已知对象时直达动作

  • 已拿到 instance_code + task_id 后,优先直接执行 tasks approve/reject/transfer/add_sign/rollback/remind
  • 同一轮里如果已有足够的新鲜查询结果,不要重复 tasks query
  • 不要默认走 list -> filter -> detail -> write 全链路;对象已明确时应压缩步骤

3) 错误码驱动,而不是盲目重试

  • 写操作失败后,先看错误码和报错语义,再决定是否补查或结束
  • 除非错误明确提示可恢复或需要补充参数,否则不要重复刷同一个写操作
  • 同一个失败原因不要连续多次重试,避免 token 和耗时失控,最多重试1次

写操作失败处理:1395001 决策树

当拒绝 / 转交 / 退回 / 撤回 / 同意等写操作返回 1395001(任务状态异常 / 写前置校验失败)时,按下面规则处理:

  1. 先停止盲目重试,不要连续重复提交相同写操作,最多重试1次
  2. 优先从以下角度解释:
    • 任务可能已被他人处理
    • 单据状态已变化,当前动作已不再允许
    • 当前用户已不具备该任务的操作资格
    • 当前节点或单据状态不支持该操作
  3. 如需确认,只补 一次 状态查询(tasks query 或 instances get),不要陷入 query/write 循环
  4. 最终给用户明确结论和下一步建议,而不是继续无意义重试

特别注意: 对拒绝 / 转交 / 撤回场景更要严格执行上述规则;这些场景最容易因状态切换而失败。

lark-cli approval approvals search --data '{"keyword":"请假"}' --as user
lark-cli approval approvals get --params '{"approval_code":"<code>"}' --as user
lark-cli approval instances create --data '{"approval_code":"<code>","form":"[...]"}' --yes --as user
lark-cli approval tasks query --params '{"topic":"1"}' --as user
lark-cli approval tasks approve --data '{"instance_code":"<ic>","task_id":"<tid>","comment":"同意"}' --as user

不在本 skill 范围

创建审批定义(走飞书客户端或审批管理后台);三方定义发起(返回 create_link,引导用户通过链接发起);非审批类待办 → lark-task

Reviews

No reviews yet. Tell others what you thought.

Comments

No login needed. Share how it worked for you, ask a question, or note where it did not run.

No comments yet. Be the first to write one.

Comments are published right away. Do not include personal information such as email addresses or phone numbers. Up to 2 URLs.

0 / 1,000 characters

This form is protected by reCAPTCHA, and the Google Privacy Policy and Terms of Service apply.

More skills from this repository

lark-apps

FreeSummary

Build, publish, and manage apps on 妙搭(Spark/Miaoda) through local development or cloud AI sessions. Create page designs, manage data and permissions, inspect logs and usage, and configure automated triggers.

  • Build and publish a business app
  • Create landing pages and interactive prototypes
  • Inspect production logs and usage
larksuite/cli17.7KUpdated Oct 16, 2026

lark-attendance

FreeSummary

Retrieve your own attendance clock records from 飞书 through lark-cli. The skill fills in fixed query parameters and uses read-only attendance access to look up the records you want to check.

  • Checking your own attendance clock records
  • Reviewing recorded clock-ins and clock-outs
  • Asking an agent to retrieve attendance records
larksuite/cli17.7KUpdated Oct 16, 2026

lark-base

FreeSummary

Build and manage business tables in Feishu Base, including fields, records, views, and data queries. Create forms and dashboards, configure automated workflows, organize BaseApp pages and components, and manage role-based access permissions.

  • Create business tables and update records
  • Filter and summarize table data
  • Create information collection forms
larksuite/cli17.7KUpdated Oct 16, 2026

lark-calendar

FreeSummary

Manage events, attendees, and meeting rooms in 飞书. Check shared availability, get meeting time suggestions that account for working hours and breaks, and create or update events with room reservations.

  • Review today's events or search upcoming meetings
  • Find suitable meeting times for several people
  • Book a room with a calendar event
larksuite/cli17.7KUpdated Oct 16, 2026

lark-contact

FreeSummary

Finds Lark contacts by name or email and retrieves open_id, an identifier used in later actions. It also looks up profile details, personal status, and signatures, and searches for bots or agents visible to the current user.

  • Identifying a colleague before messaging or scheduling
  • Looking up a profile from a known open_id
  • Checking colleagues’ personal status and signatures
larksuite/cli17.7KUpdated Oct 16, 2026

lark-doc

FreeSummary

Read, summarize, create, and edit 飞书 Docx and Wiki document content. Revise wording, reorganize sections, insert local images or attachments, and retrieve document media, with additional support for document history and mind notes.

  • Reading and summarizing online documents
  • Revising wording and reorganizing sections
  • Inserting images and attachments
larksuite/cli17.7KUpdated Oct 16, 2026

See all skills by larksuite

Report a problem with this skill