open.feishu.cn / lark-approval
lark-approval
- Установки
- 635,621
- Автор
- open.feishu.cn
- Источник
- github.com/open.feishu.cn
Скилл для работы с одобрениями в Feishu: поиск и просмотр определений, запуск нативных экземпляров, обработка задач (согласование, отклонение, передача, отзыв, напоминание) и просмотр деталей. Чётко разграничивает одобрения от обычных задач, оптимизирует шаги и корректно обрабатывает ошибки статуса.
Установить скилл
npx skills add https://github.com/open.feishu.cn --skill 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次
- 优先从以下角度解释：
- 任务可能已被他人处理
- 单据状态已变化，当前动作已不再允许
- 当前用户已不具备该任务的操作资格
- 当前节点或单据状态不支持该操作
- 如需确认，只补 一次 状态查询（
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-doc
636,035 установокopen.feishu.cn
Скилл для работы с облачными документами Feishu (Lark): чтение, создание и редактирование Docx и Wiki, вставка и скачивание изображений и вложений, управление историей версий и ментальными заметками. Запросы маршрутизируются по URL или токену документа, а нужный сценарий подбирается автоматически — от краткого пересказа до создания документа с нуля.
lark-drive
635,744 установокopen.feishu.cn
Скилл для работы с облачным хранилищем (Drive) в Lark/Feishu: управление файлами и папками, загрузка и скачивание, импорт локальных документов, поиск, к
lark-calendar
635,295 установокopen.feishu.cn
Скилл для управления календарём и встречами в Feishu (Lark): просмотр и поиск событий, создание и изменение встреч, управление участниками, проверка занятости и подбор подходящего времени, бронирование переговорных комнат. Полезен для планирования расписания, организации встреч и совместной работы с календарём.
lark-minutes
634,890 установокopen.feishu.cn
Служит точкой входа для устаревшего названия lark-minutes, делегируя все задачи навыку lark-meeting. Не содержит собственной логики, предназначен для бесшовной миграции.
lark-event
634,650 установокopen.feishu.cn
Скилл для подписки на события Lark/Feishu в реальном времени: сообщения, реакции, изменения чатов, статусы одобрений, задачи, встречи, минутки и доски. Позволяет через lark-cli event consume получать события потоком в формате NDJSON, фильтровать их через jq и ограничивать по времени или количеству. Подходит для создания ботов, обработки сообщений и долго работающих интеграций.
lark-attendance
634,571 установокopen.feishu.cn
Навык для запроса данных о посещаемости сотрудников через API Lark. Автоматически подставляет обязательные параметры employee_type и user_ids, а также требует предварительного просмотра схемы API перед вызовом. Позволяет получать записи о времени прихода и ухода.
lark-task
634,560 установокopen.feishu.cn
Скилл для управления задачами в Feishu: создание и редактирование задач, подзадач и списков, назначение исполнителей, отслеживание статусов, напоминания, комментарии и вложения. Также поддерживает работу с задачами-агентами: регистрацию, обновление данных и запись шагов выполнения.
lark-openapi-explorer
634,487 установокopen.feishu.cn
Скилл помогает находить и вызывать нативные OpenAPI-интерфейсы Feishu/Lark, когда стандартные команды не покрывают задачу. Он последовательно ищет нужный API в официальной документации, извлекает его спецификацию и выполняет запрос через lark-cli, позволяя агенту работать с любыми возможностями платформы.
lark-vc
634,292 установокopen.feishu.cn
Совместимый навык-посредник для обработки запросов, адресованных устаревшему имени lark-vc. Перенаправляет все обращения к актуальному навыку lark-meeting, который выполняет необходимые действия. Используется только при явном указании lark-vc в конфигурации или запросе.
lark-skill-maker
634,215 установокopen.feishu.cn
Помогает создавать собственные навыки для lark-cli: упаковывать операции с API Feishu в переиспользуемые скиллы, исследовать доступные методы и параметры, а затем генерировать SKILL.md по готовому шаблону с описанием команд, прав и сценариев запуска. Ускоряет автоматизацию рутинных действий с документами, календарём, мессенджером и другими сервисами Feishu.
lark-workflow-standup-report
633,966 установокopen.feishu.cn
Собирает расписание из календаря и список незавершённых задач в единую сводку на выбранную дату или период. Помогает быстро подготовиться к стендапу, утреннему обзору или спланировать день: показывает встречи, дедлайны, конфликты времени и свободные окна.
lark-okr
615,103 установокopen.feishu.cn
Скилл для управления OKR в Feishu (Lark): просмотр и редактирование циклов, целей, ключевых результатов, выравнивания, показателей и записей прогресса. Помогает создавать OKR, обновлять прогресс, изменять порядок и вес, а также выравнивать цели.
lark-markdown
600,450 установокopen.feishu.cn
Скилл для работы с Markdown-файлами в облаке Lark (Feishu): создание, загрузка, чтение, локальное редактирование с регулярными заменами и сравнение версий. Пригодится, когда нужно управлять markdown-документами как файлами в Drive, синхронизировать локальные черновики с удалёнными и отслеживать изменения. Не занимается импортом в онлайн-документы, поиском и управлением правами.
lark-apps
544,636 установокopen.feishu.cn
Управление приложениями платформы 妙搭 (Miaoda/Spark): создание и публикация приложений, локальная и облачная разработка, деплой, мониторинг метрик, работа с базой данных, переменными окружения, ролями, коллабораторами и автоматизацией.
lark-note
418,726 установокopen.feishu.cn
Скилл обеспечивает обратную совместимость со старым названием lark-note, перенаправляя все запросы на основной навык lark-meeting. Он не выполняет собственную логику, а лишь маршрутизирует вызовы, гарантируя корректную обработку задач при использовании устаревшего имени. Полезен для плавного перехода и сохранения работоспособности существующих конфигураций.