lark-apps

Create, develop, and deploy Miaoda applications via the lark-cli command line.

Updated Mar 30, 2026
One-click install
npx skills add https://github.com/TrayMachi/dotfiles --skill lark-apps-traymachi
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: lark-apps
Source: https://github.com/TrayMachi/dotfiles/tree/main/agents/skills/lark-apps
Command: npx skills add https://github.com/TrayMachi/dotfiles --skill lark-apps-traymachi

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Building and shipping apps on the Lark Miaoda (Spark) platform involves many distinct operations—creating app assets, choosing between local full-stack development, HTML static hosting, or cloud AI generation, managing databases, and deploying releases. This Skill routes every user intent to the correct lark-cli command and enforces the platform's guardrails so nothing is published or deleted by mistake. ## Core Features & Use Cases - Intent routing and path selection: Maps requests like "build a tool", "deploy this", or "get a shareable link" to the right command, and decides between html vs full_stack app types and local vs cloud development before acting. - Three development paths: Local full-stack development (init, git clone, npm dev, release), HTML static publishing (html-publish returning a shareable URL), and cloud AI generation sessions (session-create, chat, polling). - Database and release management: Inspect tables, execute SQL with dry-run safety gates, initialize dev/online environments, create releases, and poll release status for online_url or error logs. - Use Case: A user says "build me a voting tool and give me a link". The Skill asks whether they want local code development or cloud AI generation, creates the app, drives the chosen workflow, deploys via release-create, and returns the published online_url. ## Quick Start Ask the assistant to create a new Miaoda app named "team poll" and deploy it so you get a shareable link.

Frequently Asked Questions about lark-apps

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I publish an HTML page as a shareable Miaoda app link?

Create an app with lark-cli apps +create --app-type html, then run +html-publish with --app-id and --path pointing to your index.html file or static directory. The command returns data.url, which is the published access link.

How do I deploy a full-stack Miaoda app after local development?

Commit and push your changes to the sprint/default branch, then run lark-cli apps +release-create --app-id. Poll with +release-get until status is finished, which returns the online_url, or failed, which returns error_logs.

What is the difference between local and cloud development for Miaoda apps?

Local development pulls the source code via +init or git clone so you edit code yourself, while cloud development sends messages through +session-create and +chat so the Miaoda AI agent generates the app. The choice depends only on who writes the code, not app complexity.

Can I run SQL against a Miaoda app database safely?

Yes, use lark-cli apps +db-execute with --app-id and --sql or --file. All executions require --yes, and destructive or irreversible statements should first be previewed with --dry-run before user confirmation.

Why is my Miaoda app link not showing the latest changes?

An is_published=true flag or a completed cloud session does not mean the latest content is deployed. You must run +release-create and confirm +release-get returns finished with an online_url before sharing the link.