seaworld008/lark-approval

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 search | lark-approval-approvals-search.md | | 看审批定义详情/提单前确认表单与流程 | approvals get | lark-approval-approvals-get.md | | 发起原生审批实例/提交请假审批/提交报销审批/创建审批实例 | instances create | lark-approval-initiate.md | | 查待办/已办 | tasks query（topic：1待办 2已办 17未读 18已读） | lark-approval-tasks-query.md | | 看表单/进度/当前节点 | instances get | lark-approval-instances-get.md | | 同意审批 | tasks approve | lark-approval-tasks-approve.md | | 拒绝审批 | tasks reject | lark-approval-tasks-reject.md | | 转交审批 | tasks transfer | lark-approval-tasks-transfer.md | | 加签审批 | tasks add_sign | lark-approval-tasks-add-sign.md | | 退回审批 | tasks rollback | lark-approval-tasks-rollback.md | | 催办审批 | tasks remind | lark-approval-tasks-remind.md | | 撤回已发起审批 | instances cancel | lark-approval-instances-cancel.md | | 给审批实例追加抄送 | instances cc | lark-approval-instances-cc.md | | 按定义查已发起审批 | instances initiated | lark-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

<!-- LOCAL-QUALITY-SUPPLEMENT:START -->

Usage Notes

This supplement is maintained by the repository sync pipeline. It keeps the imported upstream skill usable inside this curated collection when the upstream source is intentionally concise.

Common Patterns

1. Confirm that the user's task matches the skill trigger.
2. Read the relevant project files or user-provided context before acting.
3. Choose the smallest reversible action that advances the task.
4. Run the verification command or manual check that proves the result.
5. Report the outcome, evidence, and any remaining risk.

Boundaries

• Prefer the upstream workflow for Lark Approval; this section only adds local quality guardrails.
• Do not invent project facts when required files, vaults, services, or tools are unavailable.
• Stop and ask for clarification when the next action could overwrite user work, expose private data, or change production state.

<!-- LOCAL-QUALITY-SUPPLEMENT:END -->