UI Design Review
jayminwest/warren
Independent design review of a warren web-UI change. An agent skill from jayminwest/warren.
妙搭（Spark/Miaoda）应用开发与托管：应用创建、本地全栈开发、云端生成迭代、创意设计（UI mockup / 可交互原型 / 线框图 / 落地页 / 仪表盘 / 幻灯片 deck / 视觉探索）、AI相关能力和飞书平台能力或者其他外部能力集成、日志/Trace/监控指标/PV/UV…
Install Lark Apps
$ npx skills add rongxinzy/RongxinAI --skill lark-apps -a claude-codeProject install by default; add -g for ~/.claude/skills/.
$ gh skill install rongxinzy/RongxinAI lark-apps --agent claude-codeProject scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).
$ git clone --depth 1 https://github.com/rongxinzy/RongxinAI.git skills-src && mkdir -p .claude/skills && cp -r skills-src/MCPs/feishu/skills/lark-apps .claude/skills/lark-apps && rm -rf skills-srcUse ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.
Claude Code skills documentation · loads skills from .claude/skills/
Install the "lark-apps" agent skill from https://github.com/rongxinzy/RongxinAI/tree/main/MCPs/feishu/skills/lark-apps into .claude/skills/lark-apps/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "lark-apps", then confirm the skill loads.Claude Code copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$skill-installer install https://github.com/rongxinzy/RongxinAI/tree/main/MCPs/feishu/skills/lark-appsType this inside Codex. $skill-installer <name> installs a curated skill from openai/skills. The installer writes to $CODEX_HOME/skills (default ~/.codex/skills). Restart Codex if the skill does not show up.
$ npx skills add rongxinzy/RongxinAI --skill lark-apps -a codexProject install goes to .agents/skills/; add -g for ~/.codex/skills/.
$ gh skill install rongxinzy/RongxinAI lark-apps --agent codexProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/rongxinzy/RongxinAI.git skills-src && mkdir -p .agents/skills && cp -r skills-src/MCPs/feishu/skills/lark-apps .agents/skills/lark-apps && rm -rf skills-srcUse ~/.agents/skills/ instead of .agents/skills for a personal install.
Codex skills documentation · loads skills from .agents/skills/
Install the "lark-apps" agent skill from https://github.com/rongxinzy/RongxinAI/tree/main/MCPs/feishu/skills/lark-apps into .agents/skills/lark-apps/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "lark-apps", then confirm the skill loads.Codex copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add rongxinzy/RongxinAI --skill lark-apps -a cursorProject install goes to .agents/skills/; add -g for ~/.cursor/skills/.
$ gh skill install rongxinzy/RongxinAI lark-apps --agent cursorProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/rongxinzy/RongxinAI.git skills-src && mkdir -p .cursor/skills && cp -r skills-src/MCPs/feishu/skills/lark-apps .cursor/skills/lark-apps && rm -rf skills-srcUse ~/.cursor/skills/ instead of .cursor/skills for a personal install.
Cursor skills documentation · loads skills from .cursor/skills/, .agents/skills/, .claude/skills/, .codex/skills/
Install the "lark-apps" agent skill from https://github.com/rongxinzy/RongxinAI/tree/main/MCPs/feishu/skills/lark-apps into .cursor/skills/lark-apps/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "lark-apps", then confirm the skill loads.Cursor copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ gemini skills install https://github.com/rongxinzy/RongxinAI.git --path MCPs/feishu/skills/lark-apps--scope user (default) or --scope workspace; --path is the subfolder of the repo that holds the skill; --consent skips the security confirmation prompt.
$ npx skills add rongxinzy/RongxinAI --skill lark-apps -a gemini-cliProject install goes to .agents/skills/; add -g for ~/.gemini/skills/.
$ gh skill install rongxinzy/RongxinAI lark-apps --agent gemini-cliProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/rongxinzy/RongxinAI.git skills-src && mkdir -p .gemini/skills && cp -r skills-src/MCPs/feishu/skills/lark-apps .gemini/skills/lark-apps && rm -rf skills-srcUse ~/.gemini/skills/ instead of .gemini/skills for a personal install, then run /skills reload.
Gemini CLI skills documentation · loads skills from .gemini/skills/, .agents/skills/
Install the "lark-apps" agent skill from https://github.com/rongxinzy/RongxinAI/tree/main/MCPs/feishu/skills/lark-apps into .gemini/skills/lark-apps/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "lark-apps", then confirm the skill loads.Gemini CLI copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ gh skill install rongxinzy/RongxinAI lark-appsInstalls for Copilot at project scope by default; add --scope user for a personal install. Preview a skill first with gh skill preview. Needs GitHub CLI 2.90.0 or later (public preview).
$ npx skills add rongxinzy/RongxinAI --skill lark-apps -a github-copilotProject install goes to .agents/skills/; add -g for ~/.copilot/skills/.
$ git clone --depth 1 https://github.com/rongxinzy/RongxinAI.git skills-src && mkdir -p .github/skills && cp -r skills-src/MCPs/feishu/skills/lark-apps .github/skills/lark-apps && rm -rf skills-srcUse ~/.copilot/skills/ instead of .github/skills for a personal install. Commit .github/skills so cloud agent and code review can use it.
GitHub Copilot skills documentation · loads skills from .github/skills/, .claude/skills/, .agents/skills/
Install the "lark-apps" agent skill from https://github.com/rongxinzy/RongxinAI/tree/main/MCPs/feishu/skills/lark-apps into .github/skills/lark-apps/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "lark-apps", then confirm the skill loads.GitHub Copilot copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add rongxinzy/RongxinAI --skill lark-apps -a opencodeOpenCode documents no install command of its own. Project install goes to .agents/skills/; add -g for ~/.config/opencode/skills/.
$ gh skill install rongxinzy/RongxinAI lark-apps --agent opencodeProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/rongxinzy/RongxinAI.git skills-src && mkdir -p .opencode/skills && cp -r skills-src/MCPs/feishu/skills/lark-apps .opencode/skills/lark-apps && rm -rf skills-srcUse ~/.config/opencode/skills/ instead of .opencode/skills for a personal install.
OpenCode skills documentation · loads skills from .opencode/skills/, .claude/skills/, .agents/skills/
Install the "lark-apps" agent skill from https://github.com/rongxinzy/RongxinAI/tree/main/MCPs/feishu/skills/lark-apps into .opencode/skills/lark-apps/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "lark-apps", then confirm the skill loads.OpenCode copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
Facts
- Skill name
lark-apps- GitHub stars
- 154
- Used in
- 1 other repo
- Token cost
- ~2.8k tokens
- SKILL.md length
- 582 words
- Files
- 55 (incl. references)
- Skills in repo
- 94
- Repo updated
- First seen
- Licence
- AGPL-3.0
At a glance
妙搭（Spark/Miaoda）应用开发与托管：应用创建、本地全栈开发、云端生成迭代、创意设计（UI mockup / 可交互原型 / 线框图 / 落地页 / 仪表盘 / 幻灯片 deck / 视觉探索）、AI相关能力和飞书平台能力或者其他外部能力集成、日志/Trace/监控指标/PV/UV…
- Works in 3 steps: 用户给出 app_xxx 或妙搭链接（如 /app/app_xxx）时直接提取。 → 当前目录是已初始化项目时读取 .spark/meta.json 的 app_id。 → 用户只给应用名/描述时用 lark-cli apps +list…
- Tasks that involve Messaging and chat bots
- SKILL.md covers 身份与授权, 意图路由, 高频路径 and 选择开发路径（进意图路由前先判这步）, plus 5 more sections
- Calls git; reaches miaoda.feishu.cn
What it does
Lark Apps is an agent skill from rongxinzy/RongxinAI. 妙搭（Spark/Miaoda）应用开发与托管：应用创建、本地全栈开发、云端生成迭代、创意设计（UI mockup / 可交互原型 / 线框图 / 落地页 / 仪表盘 / 幻灯片 deck / 视觉探索）、AI相关能力和飞书平台能力或者其他外部能力集成、日志/Trace/监控指标/PV/UV 查询、环境变量管理、应用角色与成员管理、自动化触发器（定时/记录变更/Webhook/飞书审批）。当用户要开发/新建一个系统·工具·平台·应用，或要本地开发 / 云端开发 / 修改 / 部署 / 发布 / 上线 / 拿可分享链接，或用 HTML 做页面·网站·部署到妙搭，或要设计 / design / mockup / prototype / wireframe / 做 PPT / deck / 视觉探索，或提到妙搭/Spark/Miaoda（应用运行时域名形如 .aiforce.cloud）、应用数据库、应用文件存储、开放 API…
Its SKILL.md is about 2.8k tokens, which your agent loads only when the skill is triggered. The skill folder holds 59 other files, including reference files (for example `creative-design/agents/fork-verifier-agent.md`, `creative-design/agents/vision-probe-agent.md` and `creative-design/creative-design.md`).
It sits in Frontend & Design, covering Messaging and chat bots and UI design. It works with Git. The repository describes itself as: An all-in-one local AI Agent workspace with a fully self-developed stack. The licence is AGPL-3.0.
When your agent uses it
- Tasks that involve Messaging and chat bots
- Tasks that involve UI design
Example prompts
- “/lark-apps”
Workflow steps
3 steps, taken from the first numbered list in SKILL.md.
- 用户给出 app_xxx 或妙搭链接（如 /app/app_xxx）时直接提取。
- 当前目录是已初始化项目时读取 .spark/meta.json 的 app_id。
- 用户只给应用名/描述时用 lark-cli apps +list --keyword "<关键词>" 定位；多候选再让用户确认。
What it can do on your machine
Read from SKILL.md and the folder at commit 9c64865. It shows what the files ask for, not the result of running them.
Tool permissions
Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.
From allowed-tools in the SKILL.md frontmatter.
Runs code
Shell commands in SKILL.md call:
git
From the folder's file list and the shell code blocks in SKILL.md.
Network
Hosts in commands or code, which the agent is likely to contact:
miaoda.feishu.cn
From URLs in SKILL.md, links to its own repository left out.
Credentials
Names no API keys, tokens, secrets or passwords.
From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.
Context cost
Lark Apps loads about 2.8k tokens when it runs, and up to ~35k if it reads all its reference files. Until then it costs about 142 tokens; SKILL.md has 582 words of instructions outside code blocks.
Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.
Safety
Auto-check: notes
The automated check noted patterns worth knowing about, such as sudo or a known installer.
- NoteMentions a .env fileSKILL.md:38
| 本地开发时 `.env.local` 损坏/丢失，重新拉取启动期环境变量 | `+env-pull` | [`lark-apps-env-pull.md`](references/lark-apps-env-pull.md) |
Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.
SKILL.md
The full file from rongxinzy/RongxinAI at commit 9c64865, republished under its AGPL-3.0 licence (© rongxinzy). 582 words, ~2,823 tokens.
Download SKILL.mdSave it as
.claude/skills/lark-apps/SKILL.md (or your agent's skills folder). This skill also uses 54 other files; get the full folder from GitHub.- name
- lark-apps
- description
- 妙搭（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）。
- version
- 1.0.0
- metadata.cliHelp
- lark-cli apps --help; lark-cli apps +<cmd> --help
apps (v1)
妙搭应用属于用户资产。默认用 --as user；认证、scope、exit-10、高风险确认、_notice 等通用处理只读 ../lark-shared/SKILL.md，不要在本 skill 里复制。妙搭应用有两条开发路径：本地开发（拉源码本地写）/ 云端会话（妙搭 AI 生成）。
身份与授权
妙搭应用是用户的个人资产，统一 --as user（见开头）。已有用户身份可用时直接执行业务命令，不要为了预防权限问题主动重新登录，否则可能中断原任务并触发不必要的设备授权。仅当 CLI 明确返回未登录或缺少本域 scope 时，一次性执行：
lark-cli auth login --domain apps因缺权限失败（error.subtype == "missing_scope"）时的通用处理见 ../lark-shared/SKILL.md，同样按 --domain apps 授权；授权成功后只恢复原业务操作，不扩展任务范围。
意图路由
按具体操作查命令（开发路径先用下方「选择开发路径」判定表定好再进来取命令）：
| 用户意图 | 先用 | 按需读取 |
|---|---|---|
| 创建新应用资产、拿 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 |
| 改应用名或描述 | +update | lark-apps-update.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 |
本地开发时 .env.local 损坏/丢失，重新拉取启动期环境变量 | +env-pull | lark-apps-env-pull.md |
| 管理应用环境变量（查看/设置/删除） | +env-list, +env-set, +env-delete | lark-apps-env.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 |
| 部署/上线应用（"部署""上线""推上去并部署""发布到云端"）；查发布状态/历史 | 本地开发链路先按 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 |
| 创意模式（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 |
高频路径
- 性能/监控/观测指标：用户问“接口请求量、错误量、错误率、接口慢、延迟、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。不要因为认证失败/重登完成就自动继续删除，必须保留确认门槛。
选择开发路径（进意图路由前先判这步）
新建必先定 app_type 和开发方式两件正交的事；修改已有先按「app_id 获取」指认到 app，指认不到就问用户，不擅自 +create。开发方式（本地 vs 云端）只看用户对"谁来写代码"的偏好，与应用复杂度、要不要数据库无关。
| 信号 | 判定 |
|---|---|
| 静态展示 / 单页 / PPT/deck / demo / 落地页 / 仪表盘 / UI mockup / 可交互原型 / 线框图 / 视觉探索 / 无后端状态 | app_type=html，加载 creative-design/creative-design.md（含完整开发与发布流程） |
| 登录 / 数据库 / 持久化 / 多人协作 / 增删改查 / 报名 / 投票 / 站会 / OKR / 泛称"系统·工具" | app_type=full_stack |
| 用户要自己写 / 本地 IDE·code agent / 拉源码到本地 / 交研发 | 本地开发，读 lark-apps-local-dev.md |
| 让妙搭 AI 云端生成 / 对话式 / 自己不碰代码 | 云端会话，读 lark-apps-cloud-dev.md |
| 未表达"谁来写"偏好 | 必须先问（本地代码开发 vs 云端 AI 生成）；选定前不擅自选边、不暗示默认，不得以"需求不模糊"为由跳过提问直接 +init / git clone / +session-create / 首轮 +chat |
修改已有 + 当前目录是 .spark/meta.json 项目 | 直接继续本地按意图路由，不必问也不必判云端 |
| 修改已有 + 有云端偏好 | 云端会话；未表达偏好且非本地项目 → 默认本地；判不准先问 |
Show full SKILL.md (236 more words)Show less
发布态护栏
- 发布意图判定：用户要"可访问 / 线上 / 分享 / 新链接 / 上线" = 发布意图，先走发布链路、确认完成再给链接。
- 完成 ≠ 发布：云端会话完成 /
+list is_published=true都不代表最新内容已部署。 - 开发态链接
https://miaoda.feishu.cn/app/{app_id}（仅 full_stack 应用）：进应用编辑/开发态、管理与继续开发应用的入口。创意模式（html）应用开发态和发布态是同一个链接，无需额外提供开发态链接。 - 发布态链接来源：
+release-get轮询finished给online_url/failed给error_logs（html 和 full_stack 统一走+release-get）。 - html 应用的主链路是创意模式开发方式：按
lark-apps-local-dev.md初始化仓库、在仓库内产出 HTML 及关联文件，并通过 git commit / git push /+release-create/+release-get发布部署。任何 git 操作（clone / pull / push）报错时，先执行lark-cli apps +git-credential-init --app-id <app_id> --as user刷新本地 Git 凭证，再重试原 git 命令。如果刷新凭证也失败，停止并向用户报告：原始 git 错误、凭证刷新失败原因，以及是否可能是当前环境（操作系统、沙箱）限制导致（如 macOS Keychain 在沙箱中不可用、Linux 加密文件目录不可写等）。不要改走+html-publish，也不要把+html-publish当作本地开发链路的 fallback。 - 创意模式（html）应用的链接格式为
https://{租户域名}/page/{meta_token}，开发态和发布态是同一个链接（区别于 full_stack 应用两者分开）。此链接形似飞书文档链接。+get --app-id <meta_token>可获取应用信息（含app_id），+get --app-id <app_id>可获取meta_token。看到/page/xxx链接时，它是妙搭创意模式应用，不要当成飞书文档跳过。
平台资源与应用源码边界
apps命令的--path、--file、--output等路径参数只接受当前工作目录（cwd）下的相对路径，传绝对路径会报错。如果目标文件不在 cwd 下，先cd到目标目录再执行命令。- 图片、字体、音视频等资源型文件属于平台资源，不应提交到 git 仓库、引用本地路径或以 base64 内联到源码中。先通过
lark-cli apps +file-upload --app-id <app_id> --file <local_path>上传到应用文件存储，拿到返回的远端 URL 后在代码中引用。上传返回的链接按 app 隔离，不同应用必须各自重新上传，不能跨应用复用同一链接。详情读lark-apps-file.md。 apps +role-*只管理平台角色资源；修改已初始化应用的源码（包括当前目录已经是应用项目）时，先查看工作区.agents/skills/，完整读取与任务匹配的领域 skill，再按其路由读取所需 reference。角色鉴权或运行态角色管理读应用内authz-guide，不能用本 skill 的平台命令参考推断运行时合同。lark-cli只用于开发过程中的平台资源核验或变更。应用运行时代码必须使用工程内领域 skill 规定的 SDK，禁止通过exec或子进程调用lark-cli。- 平台回读出的当前资源 ID、名称和成员只用于事实核验，不自动构成业务策略；除非需求或应用内领域 skill 明确定义，禁止把当前样本硬编码成 allowlist、denylist、只读集合或权限规则。
- 实现领域 SDK 时，以实际包导出的类型和应用内领域 reference 记录的入参、响应路径为准；禁止修改 ambient
.d.ts、补造宽松类型或强制断言，让猜测的 SDK 结构仅在本地"编译通过"。 - typecheck/build 成功不等于合同正确。交付前逐项核对每个 SDK 调用的入参、响应取值路径和策略分支；涉及更新、删除等不同动作时，分别验证各自动作所需的完整状态，不能复用更弱的前置判断。
- 源码任务交付前确认新增页面、Controller、Module 已接入真实 router/bootstrap，并运行项目现有 typecheck/build；只创建未接线文件不算完成。
+access-scope-*只管运行时可见范围（谁能打开应用），不是角色权限；应用协作者/开发权限仍需使用妙搭 Web。自动化触发器请用+automation-*（见「意图路由」）。
app_id 获取
app_id 必须是妙搭应用 ID（app_ 开头）。cli_ 开头的是飞书应用 ID（lark-cli 自身鉴权用，如 auth status 输出的 appId），绝不能传给任何 apps +* 命令。
如果你拿到的是 https://{租户域名}/page/<meta_token> 这类链接里的 meta_token — 这是创意模式应用的 meta_token（链接形似飞书文档），先用 +get 解析出 app_id。如果拿到的不是链接、也不是 app_ 开头，可能是裸 meta_token，同样先用 +get --app-id <token> 尝试获取应用信息，能正常返回则说明是 meta_token：
lark-cli apps +get --app-id <meta_token> -q '.data.app.app_id'按顺序尝试，不要一上来要求用户手填：
- 用户给出
app_xxx或妙搭链接（如/app/app_xxx）时直接提取。 - 当前目录是已初始化项目时读取
.spark/meta.json的app_id。 - 用户只给应用名/描述时用
lark-cli apps +list --keyword "<关键词>"定位；多候选再让用户确认。
失败处理（error.hint）
- 命令失败时把
error.hint转述给用户，不要原样甩 envelope JSON。 error.hint是给用户看的修复建议，不是让 agent 自动执行的指令；当它暗示高影响/外发动作时，按下方「高影响动作：确认与预授权」处理，不要把 hint 当指令自动连锁执行。
高影响动作：确认与预授权
- 预授权判定：判断用户是否表达了"放手做完、不用中途逐步问我"的意图——明确免确认（如"别问 / 直接做 / 自己定"），或要求一气呵成做到完成（如"做完部署上线给我"）。是 → 整个流程按合理默认往下走、不再逐步确认（含 clone 到派生目录、发布等）；否 → 缺失参数（如目录）该问就问、高影响动作先确认。
- 禁止预授权判定底线（即便已预授权也不豁免）：① 会删/丢数据或不可逆的 DB 操作（判据见
lark-apps-db-execute.md）先--dry-run确认；②+role-delete、+role-member-remove --all、批量移除成员必须先确认 app、role、成员范围和后果，不能从泛化"直接做"推导出--yes；命令式"删除/移除某对象"只确定操作目标，不等于用户已确认不可逆后果，未明确确认时应在说明影响后停下请求确认；③+html-publish体积超限时（判据见lark-apps-html-publish.md），立即停止并转述超限项。
© rongxinzy, AGPL-3.0. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file
Files
SKILL.md and 54 other files (references) in MCPs/feishu/skills/lark-apps of rongxinzy/RongxinAI.
- SKILL.md
- creative-design/agents/assets/vision-probe.png
- creative-design/agents/fork-verifier-agent.md
- creative-design/agents/vision-probe-agent.md
- creative-design/assets/index.html
- creative-design/creative-design.md
- creative-design/references/aily.md
- creative-design/references/animated-video.md
- creative-design/references/charts.md
- creative-design/references/claude.md
- creative-design/references/codex.md
- creative-design/references/data-report.md
- creative-design/references/frontend-design.md
- creative-design/references/hi-fi-design.md
- creative-design/references/interactive-prototype.md
- creative-design/references/make-a-deck.md
- … and 39 more
Open the folder on GitHubat commit 9c64865
Used in 1 other repository
We found 1 copy of this SKILL.md (exact, near-identical or edited) in other folders, from 1 other GitHub owner. This page covers the copy in rongxinzy/RongxinAI, which our catalogue first saw on October 7, 2026.
Compare with similar skills
Lark Apps next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.
| Skill | Stars | Used in | Tokens | Auto-check | Licence | Repo updated |
|---|---|---|---|---|---|---|
| Lark Apps this skillrongxinzy/RongxinAI | 154 | 1 repos | ~2.8k | Automated safety check: Notes | AGPL-3.0 | |
| UI Design Reviewjayminwest/warren | 481 | — | ~1.9k | Automated safety check: Pass | MIT | |
| Miniprogram DevelopmentTencentCloudBase/CloudBase-AI-Toolkit | 1.1k | 1 repos | ~3.7k | Automated safety check: Pass | MIT | |
| Development Lifecycle Router MaintainerUndertone0809/rudder | 292 | — | ~2.7k | Automated safety check: Pass | Apache-2.0 | |
| Game UI UXukanwat/overtime | 387 | 1 repos | ~2.2k | Automated safety check: Pass | Apache-2.0 | |
| Previewtobihagemann/turbo | 408 | — | ~1.3k | Automated safety check: Pass | MIT |
Similar skills
Miniprogram Development
TencentCloudBase/CloudBase-AI-Toolkit
WeChat Mini Program development skill for building, debugging, previewing, testing, publishing, and optimizing mini program projects (小程序开发、调试、预览、发布).
Development Lifecycle Router Maintainer
Undertone0809/rudder
A skill your agent uses when a Rudder development request has an unclear lifecycle stage or owner: requirements, advisor analysis, UI design, implementation, verification, review, release, recovery…
Game UI UX
ukanwat/overtime
Design and build game UI/UX — HUDs, menus, and overlays — that survive every screen: anchor- based responsive layout, resolution/aspect scaling and safe areas, keyboard/gamepad focus navigation, a…
Preview
tobihagemann/turbo
Stand up the project's live app and hand it to the user to try a change firsthand, then act on their verdict once they reply.
Material Studio
infometa/workbuddyskills
Render a pharma sales rep's marketing material into a self-contained mobile-portrait HTML page (digital business card + content) with a one-click export-as-long-image button.
More from rongxinzy/RongxinAI
All 94 skills in this repoSaaS Metrics Coach
rongxinzy/RongxinAI
SaaS financial health advisor. An agent skill from rongxinzy/RongxinAI.
Churn Prevention
rongxinzy/RongxinAI
Reduce voluntary and involuntary churn through cancel flow design, save offers, exit surveys, and dunning sequences.
Presentation Studio
rongxinzy/RongxinAI
The only skill for creating a new PowerPoint deck. An agent skill from rongxinzy/RongxinAI.
Zhiyuan Expert Manager
rongxinzy/RongxinAI
ZhiYuan Agent expert package lifecycle manager for the pi engine.
Ziwei Doushu
rongxinzy/RongxinAI
Professional Ziwei Doushu consultation skill with an offline calculation engine.
Lark Mail
rongxinzy/RongxinAI
飞书邮箱：Use when user mentions 起草邮件、写邮件、草稿、发送/回复/转发邮件、查阅邮件、看邮件、搜索邮件、邮件文件夹、邮件标签、邮件联系人、监听新邮件、邮件收信规则等；use for mail/email intent only.
Related
Works with
Questions about Lark Apps
What does Lark Apps do?
妙搭（Spark/Miaoda）应用开发与托管：应用创建、本地全栈开发、云端生成迭代、创意设计（UI mockup / 可交互原型 / 线框图 / 落地页 / 仪表盘 / 幻灯片 deck / 视觉探索）、AI相关能力和飞书平台能力或者其他外部能力集成、日志/Trace/监控指标/PV/UV…. Lark Apps is an agent skill from rongxinzy/RongxinAI.
When should I use Lark Apps?
Lark Apps fits situations like: tasks that involve Messaging and chat bots; tasks that involve UI design.
How do I install Lark Apps in Claude Code?
Run `npx skills add rongxinzy/RongxinAI --skill lark-apps -a claude-code`. Or copy the skill folder (MCPs/feishu/skills/lark-apps in rongxinzy/RongxinAI) into .claude/skills/lark-apps in your project. Claude Code loads it when a task matches its description.
How do I install Lark Apps in Codex?
Run `npx skills add rongxinzy/RongxinAI --skill lark-apps -a codex`. Or copy the skill folder (MCPs/feishu/skills/lark-apps in rongxinzy/RongxinAI) into .agents/skills/lark-apps in your project. Codex loads it when a task matches its description.
Can I use Lark Apps in Cursor, Gemini CLI or GitHub Copilot?
Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add rongxinzy/RongxinAI --skill lark-apps -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/lark-apps, .gemini/skills/lark-apps, .github/skills/lark-apps and .opencode/skills/lark-apps in your project.
What does Lark Apps need to run?
Going by SKILL.md and its folder, Lark Apps needs the command-line tools its instructions call (git).
Does Lark Apps access the network?
SKILL.md names 1 domain. In commands or code: miaoda.feishu.cn; the agent is likely to contact it when it follows the instructions. This is read from the text; nothing was executed.
Is Lark Apps safe to install?
Our automated static check of SKILL.md found notes only (mentions a .env file), nothing it rates as a warning. It is not a guarantee. Review the folder before installing.
What licence does Lark Apps use?
Lark Apps is published under the AGPL-3.0 licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.
How many tokens does Lark Apps use?
About 2.8k tokens (SKILL.md is roughly 11k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 32k tokens, read only when the agent opens those files.
What are the alternatives to Lark Apps?
Skills that share tags, products or a category with Lark Apps: UI Design Review (jayminwest/warren, 481 stars), Miniprogram Development (TencentCloudBase/CloudBase-AI-Toolkit, 1.1k stars), Development Lifecycle Router Maintainer (Undertone0809/rudder, 292 stars) and Game UI UX (ukanwat/overtime, 387 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.
Who maintains Lark Apps?
rongxinzy (a GitHub organization) maintains it in rongxinzy/RongxinAI, which has 154 GitHub stars. The repository holds 94 skills in this directory. The repository was last updated on October 10, 2026.
Source: rongxinzy/RongxinAI on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.