larksuite/cli / lark-approval
lark-approval
- Установки
- 395,582
- Автор
- larksuite/cli
- Источник
- github.com/larksuite/cli
Управление заявками на утверждение в Lark: поиск и просмотр ожидающих и завершённых задач, инициирование новых заявок, а также выполнение действий — одобрение, отклонение, перенаправление, отзыв, напоминание и добавление подписей.
Установить скилл
npx skills add https://github.com/larksuite/cli --skill lark-approval
Аудит безопасности
Gen Agent Trust Hub
passThis skill provides documentation and instructions for managing Lark (Feishu) approvals through a CLI tool. No security issues or malicious patterns were detected.
Audited: 5/14/2026, 11:18:32 AM
Socket
passNo alerts
Audited: 5/14/2026, 11:18:56 AM
Snyk
passRisk: LOW · No issues
Audited: 5/14/2026, 11:18:27 AM
ZeroLeaks
passScore: 93/100 · 2 sections analyzed
Audited: 4/16/2026, 11:03:21 AM
Промпт скилла
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次
- 优先从以下角度解释:
- 任务可能已被他人处理
- 单据状态已变化,当前动作已不再允许
- 当前用户已不具备该任务的操作资格
- 当前节点或单据状态不支持该操作
- 如需确认,只补 一次 状态查询(
tasks query或instances get),不要陷入 query/write 循环 - 最终给用户明确结论和下一步建议,而不是继续无意义重试
特别注意: 对拒绝 / 转交 / 撤回场景更要严格执行上述规则;这些场景最容易因状态切换而失败。
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
Все файлы скилла
- references/lark-approval-approvals-get.md
- references/lark-approval-approvals-search.md
- references/lark-approval-initiate.md
- references/lark-approval-instance-form-control-parameters.md
- references/lark-approval-instance-value-sourcing.md
- references/lark-approval-instances-cancel.md
- references/lark-approval-instances-cc.md
- references/lark-approval-instances-get.md
- references/lark-approval-instances-initiated.md
- references/lark-approval-tasks-add-sign.md
- references/lark-approval-tasks-approve.md
- references/lark-approval-tasks-query.md
- references/lark-approval-tasks-reject.md
- references/lark-approval-tasks-remind.md
- references/lark-approval-tasks-rollback.md
- references/lark-approval-tasks-transfer.md
- SKILL.md
Другие скиллы автора
lark-shared
428,016 установокlarksuite/cli
Базовый скилл для работы с lark-cli: управление аутентификацией, выбором идентичности пользователя или бота, настройкой доменов и прав доступа. Обеспечивает корректную обработку ответов, безопасность операций и генерацию QR-кодов для авторизации.
lark-im
427,083 установокlarksuite/cli
Навык для работы с корпоративным мессенджером Lark: отправка и поиск сообщений, управление чатами и группами, работа с вложениями, реакциями, закладками и интерактивными карточками. Поддерживает операции от имени пользователя или бота, включая массовые операции и пагинацию.
lark-wiki
426,048 установокlarksuite/cli
Скилл для работы с корпоративной базой знаний: создаёт и удаляет пространства, управляет их структурой и участниками, перемещает и копирует документы. Помогает быстро находить нужные материалы по ссылке или названию и грамотно организовывать знания.
lark-whiteboard
425,116 установокlarksuite/cli
Скилл для работы с досками в Lark (Feishu): просмотр и экспорт содержимого в изображение, SVG или исходный код, а также создание и редактирование досок по описанию или готовым диаграммам Mermaid, PlantUML и SVG. Упрощает визуализацию и обновление досок прямо из агента.
lark-calendar
423,989 установокlarksuite/cli
Скилл для работы с календарём Lark: просмотр и поиск событий, создание и изменение встреч, управление участниками и переговорными комнатами. Помогает проверять занятость, подбирать удобное время для встречи и бронировать переговорки. Пригодится для планирования расписания и организации совещаний.
lark-mail
422,688 установокlarksuite/cli
Скилл для работы с почтой Lark (飞书): позволяет просматривать, искать и читать письма, создавать черновики, отправлять, отвечать и пересылать сообщения, управлять папками, метками и правилами приёма почты. Включает строгие меры безопасности: содержимое писем считается недоверенным, а отправка и необратимые операции выполняются только после явного подтверждения пользователя.
lark-minutes
422,579 установокlarksuite/cli
Этот навык служит совместимым переходником для старых названий: он перенаправляет все запросы на навык lark-meeting, который выполняет основную работу. Сам по себе он не обрабатывает задачи, а только обеспечивает корректную маршрутизацию.
lark-vc
422,474 установокlarksuite/cli
Скилл lark-vc обеспечивает совместимость со старым названием и перенаправляет все запросы на навык lark-meeting. Он не обрабатывает задачи напрямую, а служит переходным мостом для корректной маршрутизации. Полезен для поддержки старых конфигураций и бе
lark-event
422,235 установокlarksuite/cli
Скилл для подписки на события Lark/Feishu в реальном времени: сообщения, реакции, изменения в чатах, статусы согласований, задачи, встречи, заметки и другие события. Позволяет запускать длительные подписчики с потоковой выдачей NDJSON, фильтрацией через jq и контролем времени или количества событий. Удобен для создания ботов и обработки вебхуков.
lark-workflow-meeting-summary
421,487 установокlarksuite/cli
Этот навык собирает заметки с совещаний за заданный период и формирует структурированный отчёт. Он автоматически запрашивает список встреч, получает тексты заметок и стенограмм, обрабатывает случаи отсутствия доступа, а затем выдаёт итог за день или неделю. При необходимости готовый отчёт можно сохранить прямо в облачный документ.
lark-workflow-standup-report
420,796 установокlarksuite/cli
Формирует сводку по расписанию и незавершённым задачам на указанную дату: подтягивает события календаря и список дел, проверяет пересечения и выдаёт итоговый отчёт. Помогает быстро узнать планы на день, неделю или подготовить утреннюю сводку.
lark-openapi-explorer
420,575 установокlarksuite/cli
Этот скилл помогает находить и вызывать原生 API-интерфейсы Lark/Feishu, когда стандартные команды CLI не подходят. Он автоматически просматривает официальную документацию, извлекает спецификации нужных методов и формирует готовые запросы через `lark-cli`. Полезен для доступа к недокументированным или редко используемым функциям платформы.
lark-skill-maker
420,341 установокlarksuite/cli
Этот навык помогает создавать собственные скиллы для lark-cli, превращая операции с API Lark в переиспользуемые команды. Он позволяет исследовать доступные API, проверять параметры и генерировать шаблоны SKILL.md с описанием команд, разрешений и логики их выполнения. Упрощает автоматизацию рутинных задач с Lark, упаковывая их в понятные для ИИ инструкции.
lark-attendance
373,448 установокlarksuite/cli
Помогает запрашивать свои отметки о посещаемости в Lark (Feishu) через командную строку. Автоматически подставляет обязательные параметры, поэтому достаточно указать только нужные данные. Требует предварительной настройки доступа.
lark-okr
359,391 установокlarksuite/cli
Скилл для управления OKR в Lark: просмотр и редактирование циклов, целей, ключевых результатов, связей выравнивания, количественных показателей и записей о прогрессе. Поддерживает массовое создание, изменение весов и порядка, а также корректно различает оценку (score) и фактический прогресс.
lark-vc-agent
310,424 установокlarksuite/cli
Совместимый навык для работы с видео-конференциями Lark. Не обрабатывает запросы сам, а перенаправляет их на основной навык lark-meeting. Нужен, чтобы старые вызовы по имени lark-vc-agent продолжали работать.