larksuite/cli/lark-apps

Claude Code and agent skill by larksuite/cli

Trust tier 2
  • community
Source check pending

Checking that the SKILL.md file is still in the repository.

妙搭(Spark/Miaoda)应用开发与托管:应用创建、本地全栈开发、云端生成迭代、创意设计(UI mockup / 可交互原型 / 线框图 / 落地页 / 仪表盘 / 幻灯片 deck / 视觉探索)、AI相关能力和飞书平台能力或者其他外部能力集成、日志/Trace/监控指标/PV/UV 查询、环境变量管理、应用协作者与协作权限设置、应用角色与成员管理、自动化触发器(定时/记录变更/Webhook/飞书审批)。当用户要开发/新建一个系统·工具·平台·应用,或要本地开发 / 云端开发 / 修改 / 部署 / 发布 / 上线 / 拿可分享链接,或用 HTML 做页面·网站·部署到妙搭,或要设计 / design / mockup / prototype / wireframe / 做 PPT / deck / 视觉探索,或提到妙搭/Spark/Miaoda 应用(链接形如 `/app/app_xxx` 或 `/page/<token>`,运行时域名形如 *.feishuapp.com)、应用数据库、应用文件存储、开放 API Key、可见范围、应用协作者/开发权限、应用角色/角色成员、线上日志、接口请求量、错误量、延迟、访问量、环境变量、给妙搭应用配自动化任务/定时触发/审批通过后自动触发时使用。不负责普通云盘文件上传(lark-drive)、飞书文档编辑(lark-doc)、原生幻灯片创建(lark-slides)。

Install

npx vskill@latest install larksuite/cli/lark-apps

SKILL.md

The same SKILL.md was published earlier as larksuite/cli/lark-apps.

apps (v1)

妙搭应用属于用户资产。默认用 --as user;认证、scope、exit-10、高风险确认、_notice 等通用处理只读 `../lark-shared/SKILL.md`,不要在本 skill 里复制。妙搭应用有两条开发路径:本地开发(拉源码本地写)/ 云端会话(妙搭 AI 生成)。

身份与授权

妙搭应用是用户的个人资产,统一 --as user(见开头)。已有用户身份可用时直接执行业务命令,不要为了预防权限问题主动重新登录,否则可能中断原任务并触发不必要的设备授权。仅当 CLI 明确返回未登录或缺少本域 scope 时,一次性执行:

bash
lark-cli auth login --domain apps

因缺权限失败(error.subtype == "missing_scope")时的通用处理见 `../lark-shared/SKILL.md`,同样按 --domain apps 授权;授权成功后只恢复原业务操作,不扩展任务范围。

意图路由

按具体操作查命令(开发路径先用下方「选择开发路径」判定表定好再进来取命令):

创意模式(/page/<token>)专属能力的命令必须使用 page- 前缀,表明该命令只适用于创意模式应用;后续新增创意模式专属命令也遵循这个命名规则。

用户意图先用按需读取
创建新应用资产、拿 app_id+create`lark-apps-create.md`
找已有 app_id、按名字过滤应用+list --keyword <name>`lark-apps-list.md`
查单个应用详情(类型、名称、发布状态等)+get --app-id <app_id>`lark-apps-get.md`
改应用名、描述或图标(图标优先 --icon-file 传本地 png/jpeg;OpenClaw 类应用等类型不支持改图标)+update`lark-apps-update.md`
删除应用(是否可从 web 端「我的应用 → 回收站」恢复取决于结果里的 in_trash=true;CLI 无恢复命令)+delete --app-id <app_id> --confirm-name <name> --yes(先 +get 向用户展示名称与 app_id、说明删除后可能进入回收站,也可能永久删除;恢复只在返回 in_trash=true 时成立;再等用户明确确认该应用;确认规则见下方「禁止预授权判定底线」②)`lark-apps-delete.md`
HTML 应用 / 创意模式 — 写 HTML 页面/网站、静态页、PPT/deck、落地页、仪表盘、UI mockup、原型、线框图、视觉探索加载 `creative-design/creative-design.md`(含完整开发与发布流程)`creative-design/creative-design.md`
旧版存量 HTML 应用(无 Git 管理)继续上传已有静态产物+html-publish(仅兼容旧链路;新建 html / 创意模式 / creative-design 产物不得使用)`lark-apps-html-publish.md`
开发已有应用 / 初始化本地仓库(开发方式已定为本地后;先解析 app_id,勿 +create 新建)+init(或手动 +git-credential-init + 原生 git)。执行前必读 `lark-apps-local-dev.md`,含端到端流程和领域规则`lark-apps-init.md`, `lark-apps-git-credential.md`
阅读 / 分析 / 总结创意应用(/page/<token>)的内容;只想查看工程结构或某个文件写了什么;或只有查看权限(协作者、无下载权限)+page-source-list(列一个目录,不递归)、+page-source-get(读单个 UTF-8 文件,stdout 原样输出)。先 list 摸结构再 get 读文件;两者只需 view 权限,只覆盖 git 源码形态的创意应用`lark-apps-page-source-list.md`, `lark-apps-page-source-get.md`
用户明确要导出 / 下载 / 归档整份源码快照,或要离线分析、全文检索、把整包喂给别的工具;任意应用模式需要一份 zip+export(下载 zip 后解压读源码;不配 git 凭证、不建工作区)。创意模式应用的 /page/ 链接直接传 --meta-token <token>,不必先 +get 换 app_id。要继续开发用 +init 而非本命令。需要下载权限`lark-apps-export.md`
本地开发时 .env.local 损坏/丢失,重新拉取启动期环境变量+env-pull`lark-apps-env-pull.md`
管理应用环境变量(查看/设置/删除)+env-list, +env-set, +env-delete`lark-apps-env.md`
网页/另一台电脑开通数据库后同步本地环境变量+env-pull(之后重启本地开发进程)`lark-apps-env-pull.md`
查应用是否已开启数据库;给应用开启数据库+features --app-id <app_id>;确认需求后 +feature-enable --feature database --app-id <app_id>`lark-apps-features.md`
查线上日志、Trace、请求数、错误率、延迟、CPU、memory、PV/UV/访问量+log-list, +log-get, +trace-list, +trace-get, +metric-list, +analytics-list`lark-apps-observability.md`
看表 / 看结构 / 初始化多环境 / 导入导出数据 / 变更追溯 / 行级审计 / dev→online 发布 / 时间点恢复 / 查 DB 用量+db-table-list、+db-table-get、+db-env-create、+db-data-export/+db-data-import、+db-changelog-list、+db-audit-status/+db-audit-enable/+db-audit-disable/+db-audit-list、+db-env-diff/+db-env-migrate、+db-recovery-diff/+db-recovery-apply、+db-quota-get`lark-apps-db.md`
逐条执行 SQL(SELECT / DML / DDL);建表 / 改表 / 写 SQL 的平台规范+db-execute`lark-apps-db-execute.md`(含「平台 SQL 规范」:审计列 / RLS / user_profile / 禁用 SQL / PG 陷阱)
管理应用文件存储:上传/下载本地文件、列出/查看/删除已存文件、生成临时分享链接、查存储用量+file-upload/+file-download/+file-list/+file-get/+file-sign/+file-delete/+file-quota-get`lark-apps-file.md`
调试应用运行时缓存:查看/删除单个业务 key、清空指定环境缓存+cache-get/+cache-delete/+cache-clear`lark-apps-cache.md`
部署/上线应用("部署""上线""推上去并部署""发布到云端");查发布状态/历史本地开发链路先按 `lark-apps-local-dev.md` 确认本次改动已 git commit + git push,再用 +release-create / +release-get;查历史用 +release-list`lark-apps-local-dev.md`, `lark-apps-release-create.md`, `lark-apps-release-get.md`, `lark-apps-release-list.md`
设置或查看运行时可见范围+access-scope-set, +access-scope-get对应 access-scope reference
把妙搭应用所有者转交给另一个人apps +get 取 meta_token / meta_doc_type -> drive permission.members transfer_owner`lark-apps-owner-transfer.md`
管理应用协作者(列出/添加/改权限/移除)或协作权限设置+member-list, +member-add, +member-update, +member-remove, +member-settings-get, +member-settings-set本文「应用协作者与协作权限设置」
创意模式(html)应用的评论相关操作创意模式应用评论走 lark-drive 文档评论体系,读取 `../lark-drive/SKILL.md` 了解评论能力`../lark-drive/SKILL.md`
管理 app_... 应用内角色、角色成员,或查询用户匹配角色+role-list/get/create/update/delete, +role-member-list/add/remove, +role-match-list`lark-apps-role.md`
云端 Agent 生成/迭代应用(开发方式已定为云端后)+session-create -> +chat -> +session-get`lark-apps-cloud-dev.md`
管理妙搭应用开放 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`
查看某次会话某一轮(turn)的回复消息(含仍在生成中的本轮)/ 导出上一轮模型回复("这一轮回复了什么""上一轮的回复""导出某轮消息")先 +session-get(取 latest_turn.turn_id)-> +session-messages-list --turn-id <id>(仅 user 身份;分页用 --page-token)`lark-apps-session-messages-list.md`
外部能力(AI模型能力和飞书平台能力)集成/插件/Plugin/Capability+plugin-install, +plugin-list, +plugin-uninstall`lark-apps-plugin-install.md`, `lark-apps-plugin-uninstall.md`, `lark-apps-plugin-list.md`
把一批 ID 在妙搭 user_id ↔ 飞书 open_id / union_id / 飞书 user_id 之间互转(例如拿到 open_id 但下游要 user_id)+user-id-convert --convert-type <方向> --ids <id1,id2,...>`lark-apps-user-id-convert.md`

高频路径

  • Base 到应用数据库同步:用户说“Base 同步到数据库 / 整库同步 / 多张表同步 / 批量任务重新启用 / operation-not-allowed”时,先读 `lark-apps-db.md` 的 Base 数据同步段落,再查 app_id 或处理授权。先形成计划再动手:+db-sync-create 一次只处理一张 Base 表,整库/多表必须拆成多份单表配置和多次 preview/create;batch/import 任务是一次性任务,不能重新 enable,遇 operation-not-allowed 先解释生命周期边界,再用 +db-sync-get 查状态/结果,持续同步要新建 streaming 任务。
  • 性能/监控/观测指标:用户问“接口请求量、错误量、错误率、接口慢、延迟、CPU、内存、最近一小时/七天趋势”时,不要去当前工作区搜索监控文件,也不要询问“监控数据在哪”。先按「app_id 获取」解析应用:lark-cli apps +list --keyword "<应用名>" --as user;拿到 app_id 后读 `lark-apps-observability.md`,用 +metric-list。
  • 请求量 + 错误量 + 延迟:请求量/错误量用 lark-cli apps +metric-list --app-id <app_id> --metric requests --since <range> --as user(不传 --series 会同时返回 total/error);延迟用 --metric latency(不传 --series 会返回 p50/p99)。如果用户给了具体接口,再加 --api <path-or-name>;不要臆造 group-by 参数。
  • PV/UV/访问量/活跃用户:先解析 app_id,再用 +analytics-list,不要误用 +metric-list。
  • 设置环境变量:如果用户只给应用名,仍先 +list --keyword 解析 app_id;设置 online 环境且用户已经明确说“确认/直接执行”时,调用 +env-set --environment online ... --yes,不要再次要求确认。回复和日志摘要里只提 key / env / app,不回显真实 value;需要传复杂值时优先用 @file 或 stdin。
  • 删除环境变量:+env-delete 是破坏性操作。除非用户在同一轮已经明确确认删除这个 app/env/key,否则先向用户确认应用、环境、key 和删除后果;确认后再加 --yes。不要因为认证失败/重登完成就自动继续删除,必须保留确认门槛。

应用所有者转交

应用所有者转交是 Drive 资源操作,属于高风险写入,不等同于添加或修改开发协作者。按 `lark-apps-owner-transfer.md` 核对当前应用、新所有者、原所有者保留权限、通知和资源位置选项,建议先用 --dry-run 预览;只有用户明确确认这些影响后才可带 --yes 真正转交,不要在未获用户明确同意时静默追加 --yes。

应用协作者与协作权限设置

这组命令管理妙搭应用的开发协作者和协作策略,不等同于 +access-scope-* 的运行时访问范围,也不等同于 +role-* 的应用内业务角色。所有命令使用 app_... 应用 ID 和 --as user。不要读取或判断 app_type 来预判支持范围,直接调用对应的协作者命令。

  • +member-list、+member-settings-get 是只读命令,需要 spark:app:read。
  • +member-add、+member-update、+member-remove、+member-settings-set 是高风险写命令,需要 spark:app:write。先用 --dry-run 核对目标、URL 和请求体;dry-run 不需要 --yes。用户已确认具体应用、成员/设置及影响,或已按下方「高影响动作:确认与预授权」对整条流程明确预授权时,真实执行加 --yes;否则在 dry-run 后停下请求确认。批量移除成员仍执行「禁止预授权判定底线」,不能从泛化的“直接做”推导出 --yes。
  • 添加、更新、移除成员时必须显式提供匹配的外部 ID 类型,禁止传内部数字 ID、猜测类型或做隐式转换:用户 --member-type openid --member-id ou_...;群组 --member-type openchat --member-id oc_...;部门 --member-type opendepartmentid --member-id od-...。
  • +member-list --member-type 的筛选枚举是响应对象类型 user / department / chat,与写命令的 ID 类型枚举不同。可再用 --role view|edit|full_access 筛选。
  • +member-list 一次返回应用的全部直接协作者,不提供分页参数;可用 --member-type 和 --role 缩小结果范围。
  • 成员响应不包含应用详情。需要名称、类型或发布状态时单独调用 +get --app-id <app_id>,不要期待成员分页重复返回 app。
  • 收到 subtype feature_not_available(OpenAPI code 3340005;直连服务可能为 40005)时,立即停止 CLI 自动化,不切换 app_type,也不尝试用 access scope、应用角色或其它成员命令绕过。向用户说明该应用暂不支持通过 lark-cli 设置协作者,并引导其在妙搭后台的权限设置中操作。
  • external_invite 只在 +member-settings-get 的响应中读取,不能独立设置;它会跟随 external_access。CLI 不注册 --external-invite,需要改变外部协作能力时只设置 --external-access。
  • copy_download_by 也只在 +member-settings-get 的响应中读取。CCM 当前明确不支持为妙搭对象写入复制、打印和下载权限,因此 CLI 不注册 --copy-download-by。保留读取结果,不要尝试写入,也不要改用其它权限字段模拟。
bash
# 读取协作者和当前协作策略
lark-cli apps +member-list --app-id <app_id> --as user
lark-cli apps +member-settings-get --app-id <app_id> --as user
# 写操作先预览精确的 typed-ID 字段;确认后把 --dry-run 换成 --yes
lark-cli apps +member-add --app-id <app_id> --member-type openid --member-id ou_xxx --perm view --dry-run --as user
lark-cli apps +member-update --app-id <app_id> --member-type openchat --member-id oc_xxx --perm edit --dry-run --as user
lark-cli apps +member-remove --app-id <app_id> --member-type opendepartmentid --member-id od-xxx --dry-run --as user
lark-cli apps +member-settings-set --app-id <app_id> --external-access disabled --comment-by viewer --dry-run --as user

选择开发路径(进意图路由前先判这步)

新建必先定 app_type 和开发方式两件正交的事;修改已有先按「app_id 获取」指认到 app,指认不到就问用户,不擅自 +create。开发方式(本地 vs 云端)只看用户对"谁来写代码"的偏好,与应用复杂度、要不要数据库无关。

app_type 三类边界(先判"要不要把数据存到服务端",再判"纯展示还是有交互"):

This is the start of the file. Read the full SKILL.md on GitHub.

Security

  • Security scanPassed, 96 of 100Pattern checks on the skill's files.
  • Model reviewPassed

Quality evaluation

  • Task evaluationNot runNo evaluation yet. Run one in Skill Studio.

Source

Popularity

Repository stars
13,140
Repository forks
896
Repository npm downloads, 7 days
187,524
7-day trend score
73

Stars and forks are for the whole GitHub repository, not this skill alone. Downloads are for the repository's npm package. Refreshed 21 May 2026, 6 months ago.

Works with

Any agent vskill installs to: 56 targets in all. These 39 have a page on this site.

  • Claude Code
  • Cursor
  • GitHub Copilot
  • Windsurf
  • Codex
  • Gemini CLI
  • Cline
  • Amp
  • Roo Code
  • Goose
  • Continue
  • Kilo Code
  • Junie
  • Trae
  • OpenHands
  • Qwen Code
  • AI Agent
  • Tabnine Chat
  • Sourcegraph Cody
  • Amazon Q
  • Firebase Genkit
  • Sweep
  • Devin
  • Phind
  • Mentat
  • Claude Desktop
  • Aider
  • GPT Pilot
  • Plandex
  • bolt.new
  • v0
  • Replit Agent
  • Anse
  • TypingMind
  • BetterChatGPT
  • LibreChat
  • Warp AI
  • Pieces
  • Fig AI
Embed badge
vskill VERIFIED badge
[![vskill VERIFIED](https://verified-skill.com/api/v1/skills/larksuite/cli/lark-apps/badge)](https://verified-skill.com/skills/larksuite/cli/lark-apps)

Something wrong with this skill or its page? Tell us.