lark-apps

Agent skill from larksuite/cli.

larksuite ↓ 227k

Claude Code

View source ↗

What it does

PV/UV/访问量/活跃用户：先解析 appid，再用 +analytics-list，不要误用 +metric-list。
删除环境变量：+env-delete 是破坏性操作。除非用户在同一轮已经明确确认删除这个 app/env/key，否则先向用户确认应用、环境、key 和删除后果；确认后再加 --yes。不要因为认证失败/重登完成就自动继续删除，必须保留确认门槛。
发布意图判定：用户要"可访问 / 线上 / 分享 / 新链接 / 上线" = 发布意图，先走发布链路、确认完成再给链接。
完成 ≠ 发布：云端会话完成 / +list ispublished=true 都不代表最新内容已部署。
开发态链接 https://miaoda.feishu.cn/app/{appid}（仅 fullstack 应用）：进应用编辑/开发态、管理与继续开发应用的入口。创意模式（html）应用开发态和发布态是同一个链接，无需额外提供开发态链接。
发布态链接来源：+release-get 轮询 finished 给 onlineurl / failed 给 errorlogs（html 和 fullstack 统一走 +release-get）。
apps 命令的 --path、--file、--output 等路径参数只接受当前工作目录（cwd）下的相对路径，传绝对路径会报错。如果目标文件不在 cwd 下，先 cd 到目标目录再执行命令。

Requirements & configuration

| 管理妙搭应用开放 API Key（创建/查看/启停/重置/删除凭证；密钥仅 create/reset 一次性返回） | +openapi-key-list/get/create/update/enable/disable/delete/reset | lark-apps-openapi-key.md |
| 管理妙搭应用自动化触发器（定时/记录变更/Webhook/飞书审批四类触发器的查询/创建/更新/启停；Webhook URL·Token 一次性回显、不落盘） | +automation-list/get/create/update/enable/disable | lark-apps-automation.md |
如果你拿到的是 https://{租户域名}/page/<metatoken> 这类链接里的 metatoken — 这是创意模式应用的 metatoken（链接形似飞书文档），先用 +get 解析出 appid。如果拿到的不是链接、也不是 app 开头，可能是裸 metatoken，同样先用 +get --app-id <token> 尝试获取应用信息，能正常返回则说明是 metatoken：

Derived from the skill's own SKILL.md documentation · extracted 2026-07-23

Source

Repository: https://github.com/larksuite/cli

lark-apps FAQ

What does the lark-apps skill do?

妙搭（Spark/Miaoda）应用开发与托管：应用创建、本地全栈开发、云端生成迭代、创意设计（UI mockup / 可交互原型 / 线框图 / 落地页 / 仪表盘 / 幻灯片 deck / 视觉探索）、AI相关能力和飞书平台能力或者其他外部能力集成、日志/Trace/监控指标/PV/UV 查询、环境变量管理、应用角色与成员管理、自动化触发器（定时/记录变更/Webhook/飞书审批）。当用户要开发/新建一个系统·工具·平台·应用，或要本地开发 / 云端开发 / 修改 / 部署 / 发布 / 上线 / 拿可分享链接，或用 HTML 做页面·网站·部署到妙搭，或要设计 / design / mockup / prototype / wireframe / 做 PPT / deck / 视觉探索，或提到妙搭/Spark/Miaoda（应用运行时域名形如 *.aiforce.cloud）、应用数据库、应用文件存储、开放 API Key、可见范围、应用角色/角色成员、线上日志、接口请求量、错误量、延迟、访问量、环境变量、给妙搭应用配自动化任务/定时触发/审批通过后自动触发时使用。不负责普通云盘文件上传（lark-drive）、飞书文档编辑（lark-doc）、原生幻灯片创建（lark-slides）。 PV/UV/访问量/活跃用户：先解析 appid，再用 +analytics-list，不要误用 +metric-list。删除环境变量：+env-delete 是破坏性操作。除非用户在同一轮已经明确确认删除这个 app/env/key，否则先向用户确认应用、环境、key 和删除后果；确认后再加 --yes。不要因为认证失败/重登完成就自动继续删除，必须保留确认门槛。

What does lark-apps require?

| 管理妙搭应用开放 API Key（创建/查看/启停/重置/删除凭证；密钥仅 create/reset 一次性返回） | +openapi-key-list/get/create/update/enable/disable/delete/reset | lark-apps-openapi-key.md | | 管理妙搭应用自动化触发器（定时/记录变更/Webhook/飞书审批四类触发器的查询/创建/更新/启停；Webhook URL·Token 一次性回显、不落盘） | +automation-list/get/create/update/enable/disable | lark-apps-automation.md | 如果你拿到的是 https://{租户域名}/page/<metatoken> 这类链接里的 metatoken — 这是创意模式应用的 metatoken（链接形似飞书文档），先用 +get 解析出 appid。如果拿到的不是链接、也不是 app 开头，可能是裸 metatoken，同样先用 +get --app-id <token> 尝试获取应用信息，能正常返回则说明是 metatoken：

How do I install lark-apps?

Run: npx -y skills add https://github.com/larksuite/cli --skill lark-apps --agent claude-code — the source lives at github.com/larksuite/cli.

Maintain lark-apps?

Let people know it's listed here — add the badge (live metrics, light/dark aware) or a plain link to your README or docs.

[![lark-apps on getagentictools](https://getagentictools.com/badge/skills/larksuite-cli-lark-apps.svg)](https://getagentictools.com/skills/larksuite-cli-lark-apps?ref=badge)

npx agentictools info skills/larksuite-cli-lark-apps

The second line is the CLI lookup for this page — handy in READMEs and docs.