ASD

Lark Approval

Aprobaciones de Feishu/Lark: consulta y procesa pendientes/completadas/instancias, busca definiciones que se pueden iniciar, ve detalles y crea instancias nativas de aprobación.

Reemplaza a: lark-task (para tareas no relacionadas con aprobaciones), Cliente Lark o panel de administración (para crear definiciones de aprobación)

Estrellas
16.4k

en todo el repo

Actividad
60

0–100, la ruta de este skill

Actualizado
hace 28 días

último commit aquí

Commits
4

últimos 90 días

Contexto
1.7k tok

90 tok en reposo

Paquete
17 archivos

106 KB

Instalar

Funciona con cualquier agente que lea SKILL.md

npx -y skills add larksuite/cli --skill lark-approval --agent claude-code

Se instala solo en este repositorio.

Qué hace

  • Consulta y procesa tareas pendientes/completadas de aprobación en Lark/飞书
  • Busca definiciones de aprobación que se pueden iniciar y ve sus detalles
  • Inicia instancias de aprobación nativas con `instances create`
  • Ejecuta acciones sobre tareas: aprobar, rechazar, transferir, retroceder, recordar, agregar firmante
  • Cancela instancias iniciadas y añade copia (cc) a instancias existentes

Úsalo cuando

  • El usuario quiere ver, aprobar, rechazar, transferir, retroceder, recordar o cancelar una aprobación
  • El usuario quiere buscar una definición de aprobación o iniciar una nueva instancia
  • El usuario pide ver pendientes/completadas de aprobación, detalles de instancia o formulario

No lo uses cuando

  • El objeto tratado es una tarea no relacionada con aprobaciones (usar lark-task en su lugar)
  • El usuario quiere crear una definición de aprobación (se hace desde el cliente Lark o el panel de administración)
  • Se trata de una definición de aprobación de terceros, que no se envía mediante ticket nativo (usar el `create_link` devuelto)

Qué lo activa

Di cualquiera de estas frases y el agente debería cargar este skill.

  • Muéstrame mis aprobaciones pendientes
  • Aprueba la solicitud de vacaciones con instance_code XXX
  • Busca la definición de aprobación de reembolso y crea una instancia
  • Rechaza esta aprobación con el comentario 'falta información'
  • Retira la aprobación que envié ayer

SKILL.md

En inglés

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

所有命令默认 --as user(审批是人的动作)。调用前先按需读取 references 下对应的文件,查参数结构,不要猜字段;references 是第一信息源,只有在 reference 未覆盖的原生 / 高级场景下,才额外用 lark-cli ... --helplark-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 querytopic: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 queryinstance_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 queryinstances 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

Reproducido de larksuite/cli bajo licencia MIT. Leer esta página en markdown.

Archivos

17 archivos en el paquete. Solo se lee SKILL.md al activarse — las referencias se cargan si el skill decide que las necesita.

Antes de instalar

Requiere el binario lark-cli y haber leído primero ../lark-shared/SKILL.md para autenticación y permisos.

Detalles

Creador
larksuite
Categoría
Automatización
Licencia
MIT
Recursos incluidos
referencias
Repositorio
larksuite/cli
Código fuente
Ver SKILL.md

Más de larksuite/cli

Este repo incluye 28 skills. Si instalas uno, normalmente ya tienes los demás.

飞书幻灯片: crea y edita presentaciones, lee contenido de slides, gestiona páginas (crear, eliminar, leer, reemplazo parcial). No cubre documentos, pizarras ni archivos generales.

Costo de contexto al activarse
7k tok
Tamaño del paquete
50 archivos
Última actualización
hace 3 días
documentos

Drive de Feishu/Lark: gestiona archivos y carpetas (subir/descargar, copiar/mover/eliminar, metadatos, permisos, comentarios, versiones, etiquetas de confidencialidad) e importa archivos locales como docx/sheet/bitable/slides.

Costo de contexto al activarse
6.3k tok
Tamaño del paquete
61 archivos
Última actualización
hace 3 días
documentos

Operaciones sobre documentos en la nube de Lark (Docx/Wiki): leer, crear y editar documentos, insertar o descargar imágenes/adjuntos, y gestionar notas mentales.

Costo de contexto al activarse
1k tok
Tamaño del paquete
44 archivos
Última actualización
hace 3 días
documentos

Operaciones en Lark Base (multitabla): tablas, campos, registros, vistas, fórmulas/lookup, formularios, dashboards, workflows y roles; se usa ante Base/多维表格/bitable o enlaces /base/.

Costo de contexto al activarse
6.2k tok
Tamaño del paquete
30 archivos
Última actualización
anteayer
bases de datos

Lark Im

16.4k

Mensajería instantánea de Feishu/Lark: enviar y responder mensajes, buscar historial, gestionar miembros de grupo, subir/descargar archivos, reacciones, avisos urgentes y tarjetas interactivas con sus callbacks.

Costo de contexto al activarse
5.3k tok
Tamaño del paquete
59 archivos
Última actualización
hace 7 días
automatizacion

Desarrollo y hosting de apps Miaoda/Spark: creación, desarrollo local o en la nube, diseño creativo, integraciones de IA/Feishu, logs, métricas, variables de entorno, colaboradores, roles y triggers.

Costo de contexto al activarse
6.2k tok
Tamaño del paquete
55 archivos
Última actualización
hace 3 días
herramientas desarrollo

Skills relacionados

Úsalo cuando enfrentes 2 o más tareas independientes que puedan trabajarse sin estado compartido ni dependencias secuenciales.

Costo de contexto al activarse
1.5k tok
Tamaño del paquete
1 archivo
Última actualización
el mes pasado
automatizacion

Úsalo al ejecutar planes de implementación con tareas independientes dentro de la sesión actual.

Costo de contexto al activarse
8.1k tok
Tamaño del paquete
7 archivos
Última actualización
anteayer
automatizacion

Interrógame sobre las specs de los workflows que quiero construir, dentro de este workspace.

Costo de contexto al activarse
640 tok
Tamaño del paquete
2 archivos
Última actualización
hace 16 días
automatizacion