docs: add dormant local/cloud dev-mode design to lark-apps skill

skills/lark-apps/SKILL.md

@@ -102,6 +102,18 @@ lark-cli auth login --domain apps
 - `apps +access-scope-set` 三种 scope **互斥**：specific 必传 `--targets`、不允许 `--require-login`；public 必传 `--require-login`、不允许 `--targets` / `--apply-enabled` / `--approver`；tenant 不允许任何其他 flag
 - 失败时**优先转述 `error.hint`**（CLI 给的可执行修复建议），hint 为空时退回 `error.message`；不要原样把 envelope JSON 复述给用户。`error.type == "missing_scope"` 例外：按上面「身份与一次性授权」走
 
+## 开发模式（规划中 · 命令未上线 · 暂不启用）
+
+> ⚠️ **本节描述规划中的本地 / 云端开发模式。下列命令尚未上线（`+git-credential-init` / `+git-credential-list` / `+git-credential-remove`、`+db-table-list` / `+db-table-schema` / `+db-sql` / `+db-multi-env-init`、`+env-pull`、`+session-create` / `+session-read` / `+session-list` / `+session-stop`、`+chat`、`+publish` / `+publish-status` / `+publish-history`），当前请勿调用、勿进入这些流程。** 用户提出本地开发 / 云端开发 / clone 到本地 / 数据库操作 / 云端 session 对话等需求时，**明确告知「妙搭本地 / 云端开发能力正在规划中，暂未上线」**，不要尝试执行上述命令。本区块仅作设计预览，便于命令上线后接入路由。
+
+规划中的意图路由（**命令上线后**才启用）：
+
+| 用户意图 | 进入条件 | 设计预览 ref |
+|---------|---------|------------|
+| 创建 + 本地开发 | 新建 fullstack 应用并要在本地改代码 | [local-setup](references/lark-apps-local-setup.md) → [local-dev](references/lark-apps-local-dev.md) |
+| 已有 appId + 本地开发 | 给了 app_id / 应用链接，要本地开发 | [local-setup](references/lark-apps-local-setup.md) → [local-dev](references/lark-apps-local-dev.md) |
+| 云端开发 | 给了 app_id，非代码目录，要 chat 式开发 | [cloud-dev](references/lark-apps-cloud-dev.md) |
+
 ## Shortcuts（推荐优先使用）
 
 Shortcut 是对常用操作的高级封装（`lark-cli apps +<verb> [flags]`）。有 Shortcut 的操作优先使用。

skills/lark-apps/references/lark-apps-cloud-dev.md

@@ -0,0 +1,29 @@
+# apps 云端开发模式（规划中 · 命令未上线 · 暂不执行）
+
+> ⚠️ **本文件为设计预览。下列命令（`+session-*`、`+chat`、`+publish`）尚未上线，当前请勿执行。** 用户要求云端 session 对话式开发时，告知该能力规划中、暂未上线。
+
+> **前置条件：** 命令上线后，先阅读 [`../../lark-shared/SKILL.md`](../../lark-shared/SKILL.md)。
+
+## 定位
+
+用户给了 app_id / 应用链接 / 应用名，且在非代码目录时的云端 chat 式开发。
+
+## 可用能力（命令未上线）
+
+| 命令 | 职责 |
+|------|------|
+| `apps +session-create --app-id <id>` | 创建一个云端开发 session |
+| `apps +session-read --session-id <id>` | 读取 session 状态 / 历史消息 |
+| `apps +session-list --app-id <id>` | 列举当前应用的活跃 session |
+| `apps +session-stop --session-id <id>` | 停止指定 session |
+| `apps +chat --session-id <id> --message "<内容>" [--attach ...]` | 向云端 session 发消息（多轮） |
+| `apps +publish` | 发布 |
+
+## 典型串联组合（命令上线后）
+
+- `apps +session-create` → 多轮 `apps +chat` → `apps +publish`
+- 或 `apps +session-list` 查活跃 session → `apps +chat` → `apps +publish`
+
+## 参考
+
+- [lark-apps](../SKILL.md)

skills/lark-apps/references/lark-apps-local-dev.md

@@ -0,0 +1,32 @@
+# apps 本地开发模式（规划中 · 命令未上线 · 暂不执行）
+
+> ⚠️ **本文件为设计预览。下列命令（`+db-*`、`+env-pull`、`+publish*`）尚未上线，当前请勿执行。** 用户要求本地数据库操作 / 拉环境 / 发布本地开发应用时，告知该能力规划中、暂未上线。
+
+> **前置条件：** 命令上线后，先阅读 [`../../lark-shared/SKILL.md`](../../lark-shared/SKILL.md)。
+
+## 定位
+
+cwd 在已 clone 的本地开发仓库内时的开发指导。通过本地 setup（[local-setup](lark-apps-local-setup.md)）进入。
+
+## 可用能力（命令未上线）
+
+| 命令 | 职责 |
+|------|------|
+| `apps +db-table-list` | 列出应用数据库的所有表 |
+| `apps +db-table-schema` | 查看指定表的 schema |
+| `apps +db-sql` | 执行 SQL 查询 / 操作 |
+| `apps +db-multi-env-init` | 多环境数据库初始化 |
+| `apps +env-pull --app-id <id>` | 拉取应用 env 到本地 |
+| `apps +publish` | 本地开发应用发布 |
+| `apps +publish-status` | 查询发布状态 |
+| `apps +publish-history` | 查询发布历史 |
+
+## 典型串联组合（命令上线后）
+
+- 编辑迭代 → `apps +db-sql` / `apps +db-table-schema` 改 / 查数据 → `apps +publish`
+- 或 `apps +env-pull` 拉新环境配置 → 继续开发
+
+## 参考
+
+- [lark-apps-local-setup](lark-apps-local-setup.md) — 进入本地开发的一次性 setup
+- [lark-apps](../SKILL.md)

skills/lark-apps/references/lark-apps-local-setup.md

@@ -0,0 +1,35 @@
+# apps 本地开发 setup（规划中 · 命令未上线 · 暂不执行）
+
+> ⚠️ **本文件为设计预览。下列命令（`+git-credential-init` 等）尚未上线，当前请勿执行。** 用户要求"本地开发 / clone 到本地"时，告知该能力规划中、暂未上线。
+
+> **前置条件：** 命令上线后，先阅读 [`../../lark-shared/SKILL.md`](../../lark-shared/SKILL.md)（认证、全局参数）。
+
+进入本地开发只需一次性 setup，两种进入场景最终汇到同一段（git 凭据初始化 → clone → cd）：
+
+## 场景 A：从 0 创建本地开发应用
+
+用户要新建一个全栈 / 需本地改代码的应用：
+
+| 步骤 | 命令（未上线） | 说明 |
+|------|---------------|------|
+| 1 | `apps +create --app-type fullstack --message "<用户原话>"` | 拿 `app_id`（此命令已上线，见 [lark-apps-create.md](lark-apps-create.md)） |
+| 2 | `apps +git-credential-init --app-id <id>` | 初始化 git 凭据 + 注入本地 git 配置；响应返回仓库 repo 地址（命令未上线，repo 地址来源暂定） |
+| 3 | `git clone <repo>` → 引导用户 `cd` 进仓库目录 | clone 后进入仓库，换 session 继续本地开发 |
+
+## 场景 B：已有 appId 直接本地开发
+
+用户给了 `app_xxx` / 应用链接并说"帮我本地开发"：跳过创建，直接 setup。
+
+| 步骤 | 命令（未上线） | 说明 |
+|------|---------------|------|
+| 1 | `apps +git-credential-init --app-id app_xxx` | 同场景 A step 2 |
+| 2 | `git clone <repo>` → 引导 `cd` | 同场景 A step 3 |
+
+## 终点
+
+clone 完成、`cd` 进仓库后即进入「本地开发模式」，后续能力见 [lark-apps-local-dev.md](lark-apps-local-dev.md)。理想形态下由仓库内 AGENTS.md bootstrap 自动衔接（AGENTS.md 尚未设计，不在当前范围）。
+
+## 参考
+
+- [lark-apps](../SKILL.md) — 妙搭应用全部命令
+- [lark-apps-local-dev](lark-apps-local-dev.md) — 本地开发模式能力