@lark-apaas/coding-miaoda-sandbox-skills 0.1.0-dev.28c4f05 → 0.1.0-dev.4e64c13

package/shared/lark-cli/lark-slides/references/lark-slides-history.md

@@ -0,0 +1,105 @@
+# slides history（历史版本与回滚任务状态）
+
+用于查看 Slides XML presentation 的历史版本列表，以及查询回滚任务的执行状态。这两个都是
+**只读**接口：
+
+- `slides xml_presentation.history list` — 分页列出历史版本。
+- `slides xml_presentation.history revert_status` — 按 `task_id` 查询回滚任务状态。
+
+> 发起回滚本身（`xml_presentation.history revert`）是高风险写操作，不在本沙箱的只读推荐入口
+> 内。用户临时要求回滚而撞到 exit 10 时，按上层 lark-cli SKILL.md 的高风险写审批协议处理。`revert_status`
+> 只负责查询一个已存在的回滚任务的执行进度。
+
+`entries[].edit_time` 是 UTC RFC3339 时间字符串（例如 `2026-06-22T12:24:45Z`）。按时间匹配时先将
+其解析为时间值，再比较先后关系或时间差。
+
+## 命令形态
+
+```bash
+# 列出历史版本
+lark-cli slides xml_presentation.history list --as user --params '<json_params>'
+
+# 查询回滚任务状态
+lark-cli slides xml_presentation.history revert_status --as user --params '<json_params>'
+```
+
+> 参数结构以 schema 为准，调用前先查看：
+> `lark-cli schema slides.xml_presentation.history.list` /
+> `lark-cli schema slides.xml_presentation.history.revert_status`。
+> `list` 支持分页：无 `page_token` 取第一页，`has_more=true` 时用上一页返回的 `page_token`
+> 继续翻页；`revert_status` 需要提供发起回滚时返回的 `task_id`。
+
+## 按 revision_id 或时间点定位版本
+
+当用户说"看看昨天下午 3 点的版本""revision_id=42 是哪一条"这类需求时，用 `list` 定位：
+
+1. 执行 `list` 获取第一页历史记录；只有 `has_more=true` 且还需要更多候选时才继续翻页。
+2. 如果用户给出 `revision_id`：先筛选当前页中 `entries[].revision_id == 用户给出的 revision_id`。
+   如果未命中且 `has_more=true`，继续拉下一页；如果已经命中候选，最多额外再拉一页，补齐同一个
+   `revision_id` 可能跨页出现的相邻 `history_version_id`。若用户同时给出目标时间，在候选里选择
+   `edit_time` 与目标时间最接近的一条；若未给目标时间但候选只有一条，可直接使用；若多个候选无法
+   可靠区分，不要自行取第一条，向用户展示候选并确认。
+3. 如果用户只给出时间：用 `entries[].edit_time` 匹配，选择目标时刻之前最近的一条；如果用户表达
+   的是"最接近某时刻"，则选择绝对时间差最小的一条。
+4. 从最终匹配条目读取 `history_version_id`。`history_version_id` 对应服务端 `minor_history.version`。
+
+候选确认时使用类似格式：
+
+```text
+同一个 revision_id 命中多个历史版本，请确认是哪一条：
+- history_version_id=11 revision_id=42 edit_time=2026-06-22T12:24:45Z name=...
+- history_version_id=12 revision_id=42 edit_time=2026-06-22T12:25:14Z name=...
+```
+
+## 回滚任务状态轮询
+
+已发起的回滚任务返回 `task_id` 与 `status` 后：
+
+1. 如果 `status` 不是 `running`，不再调用状态接口。
+2. 如果 `status` 是 `running`，等待响应中的 `poll_after_ms` 后调用 `revert_status`；`poll_after_ms`
+   缺失、为 `0` 或非法时，默认等待 10 秒。
+3. 状态查询返回 `running` 时继续轮询；返回 `done`、`partial_failed` 或 `failed` 时停止。
+4. 默认最多轮询 5 分钟。达到上限后停止轮询，向用户说明任务仍在运行并返回 `task_id`，不得将其
+   描述为回滚失败。
+5. 状态查询出现临时错误时，按相同间隔最多连续重试 3 次；只重试 `revert_status`。
+6. `partial_failed` 或 `failed` 时展示 `failed_block_tokens`。
+
+## 返回值要点
+
+`list` 返回：
+
+```json
+{
+  "entries": [
+    {
+      "revision_id": 42,
+      "history_version_id": "11",
+      "edit_time": "2026-06-22T12:24:45Z",
+      "type": 1,
+      "name": "版本名",
+      "description": "版本说明",
+      "editor_ids": ["ou_xxx"]
+    }
+  ],
+  "has_more": true,
+  "page_token": "page_token"
+}
+```
+
+`revert_status` 返回：
+
+```json
+{
+  "status": "partial_failed",
+  "history_version_id": "11",
+  "failed_block_tokens": ["blk_xxx"]
+}
+```
+
+`status` 可能是 `running`、`done`、`partial_failed`、`failed`。当状态是 `partial_failed` 或
+`failed` 时，优先检查 `failed_block_tokens`。
+
+## 相关命令
+
+- [xml_presentations get](lark-slides-xml-presentations-get.md) — 读取整份演示文稿 XML
+- [xml_presentation.slide get](lark-slides-xml-presentation-slide-get.md) — 按 `slide_id` 读取单页 XML

package/shared/lark-cli/lark-slides/references/lark-slides-xml-presentation-slide-get.md

@@ -0,0 +1,108 @@
+# lark-slides xml_presentation.slide get
+
+## 用途
+
+按 `slide_id` 拉取指定演示文稿单页的 XML 内容（可指定历史版本）。
+
+## 命令
+
+```bash
+lark-cli slides xml_presentation.slide get --as user --params '<json_params>'
+```
+
+## 参数说明
+
+| 参数 | 类型 | 必需 | 说明 |
+|------|------|------|------|
+| `--params` | JSON string | 是 | 路径参数与查询参数 |
+
+### params JSON 结构
+
+```json
+{
+  "xml_presentation_id": "slides_example_presentation_id",
+  "slide_id": "slide_example_id",
+  "revision_id": -1
+}
+```
+
+| 字段 | 类型 | 必需 | 说明 |
+|------|------|------|------|
+| `xml_presentation_id` | string | 是 | 目标演示文稿唯一标识 |
+| `slide_id` | string | 是 | 目标页面唯一标识 |
+| `revision_id` | integer | 否 | 版本号，`-1` 表示最新版（默认）|
+
+## 使用示例
+
+### 读最新版本
+
+```bash
+lark-cli slides xml_presentation.slide get --as user --params '{
+  "xml_presentation_id": "slides_example_presentation_id",
+  "slide_id": "slide_example_id"
+}'
+```
+
+### 只提取 XML 内容
+
+```bash
+lark-cli slides xml_presentation.slide get --as user \
+  --params '{"xml_presentation_id":"slides_example_presentation_id","slide_id":"slide_example_id"}' \
+  | jq -r '.data.slide.content'
+```
+
+### 读指定历史版本
+
+```bash
+lark-cli slides xml_presentation.slide get --as user --params '{
+  "xml_presentation_id": "slides_example_presentation_id",
+  "slide_id": "slide_example_id",
+  "revision_id": 42
+}'
+```
+
+## 返回值
+
+```json
+{
+  "ok": true,
+  "identity": "user",
+  "data": {
+    "slide": {
+      "slide_id": "slide_example_id",
+      "content": "<slide id=\"slide_example_id\"><style/><data>...</data></slide>"
+    },
+    "revision_id": 100
+  }
+}
+```
+
+| 字段 | 类型 | 说明 |
+|------|------|------|
+| `data.slide.slide_id` | string | 页面唯一标识 |
+| `data.slide.content` | string | 页面完整 XML（`<slide>` 根节点，不含 xmlns）|
+| `data.revision_id` | integer | 此次读到的版本号 |
+
+## 常见错误
+
+| 错误码 | 含义 |
+|--------|------|
+| 404 | 演示文稿或页面不存在，检查 `xml_presentation_id` / `slide_id` |
+| 403 | 对该演示文稿无访问权限 |
+| 400 | `revision_id` 不存在，用 `-1` 或真实存在的版本号 |
+
+## 注意事项
+
+1. **执行前必做**：`lark-cli schema slides.xml_presentation.slide.get` 查看最新参数结构
+2. **block_id 提取**：返回 XML 里每个顶层块（shape、img、table、chart 等）的 `id` 属性即为 `block_id`，通常是 3 字符短码，例如 `<shape id="bUn" ...>`。用以下命令列出当前页所有 block_id：
+
+   ```bash
+   lark-cli slides xml_presentation.slide get --as user \
+     --params "{\"xml_presentation_id\":\"$PID\",\"slide_id\":\"$SID\"}" \
+     | jq -r '.data.slide.content' | grep -oE 'id="[^"]+"' | sed 's/id="//;s/"//'
+   ```
+
+## 相关命令
+
+- [xml_presentations get](lark-slides-xml-presentations-get.md) — 读取整份演示文稿 XML
+- [slides history](lark-slides-history.md) — 历史版本列表与回滚任务状态查询

package/shared/lark-cli/lark-slides/references/lark-slides-xml-presentations-get.md

@@ -0,0 +1,77 @@
+# lark-slides xml_presentations get
+
+## 用途
+
+读取飞书幻灯片（PPT）演示文稿的完整 XML 内容信息。
+
+## 命令形态
+
+```bash
+lark-cli slides xml_presentations get --as user --params '<json_params>'
+```
+
+### 参数说明
+
+| 参数 | 类型 | 必需 | 说明 |
+|------|------|------|------|
+| `--params` | JSON string | 是 | 路径参数与查询参数，结构以 schema 为准 |
+
+### params JSON 结构
+
+```json
+{
+  "xml_presentation_id": "slides_example_presentation_id",
+  "revision_id": -1
+}
+```
+
+| 字段 | 类型 | 必需 | 说明 |
+|------|------|------|------|
+| `xml_presentation_id` | string | 是 | 演示文稿的唯一标识符 |
+| `revision_id` | integer | 否 | 版本号，`-1` 表示最新版本 |
+
+### 返回值
+
+成功时返回演示文稿的完整信息：
+
+```json
+{
+  "ok": true,
+  "identity": "user",
+  "data": {
+    "xml_presentation": {
+      "presentation_id": "slides_example_presentation_id",
+      "revision_id": 1,
+      "content": "<presentation xmlns=\"https://www.larkoffice.com/sml/2.0\" height=\"540\" width=\"960\">...</presentation>"
+    }
+  }
+}
+```
+
+### 返回字段说明
+
+| 字段 | 类型 | 说明 |
+|------|------|------|
+| `data.xml_presentation.presentation_id` | string | 演示文稿唯一标识 |
+| `data.xml_presentation.revision_id` | integer | 版本号 |
+| `data.xml_presentation.content` | string | XML 格式的完整内容 |
+
+### 常见错误
+
+| 错误码 | 含义 |
+|--------|------|
+| 404 | 演示文稿不存在，检查 `xml_presentation_id` 是否正确 |
+| 403 | 对该演示文稿无访问权限 |
+| 400 | 参数格式错误，确保 `--params` 是合法的 JSON 字符串 |
+
+### 注意事项
+
+1. 直接调用前，使用 `lark-cli schema slides.xml_presentations.get` 查看最新的参数结构
+2. 返回的 XML 在 `data.xml_presentation.content` 字段中
+3. 如果只需要部分信息，可以使用 `jq` 等工具过滤返回结果
+4. 完整 XML 可能很长，用 `jq` 提取到本地文件而不是直接打到终端，避免输出被截断
+
+## 相关命令
+
+- [xml_presentation.slide get](lark-slides-xml-presentation-slide-get.md) — 按 `slide_id` 读取单页 XML
+- [slides history](lark-slides-history.md) — 历史版本列表与回滚任务状态查询

package/shared/lark-cli/lark-task/README.md

@@ -0,0 +1,93 @@
+# task (v2)
+
+## 身份
+
+任务查询针对当前登录用户（默认 `--as user`）。当用户提到"我"（例如"分配给我""由我创建""我关注的"）时，默认取当前登录用户的 `open_id` 作为对应参数值。
+
+## 搜索 vs 列取（意图判断）
+
+- **任务搜索技巧**：先区分用户是否**特地指定使用搜索**，以及是否真的提供了**查询关键字**（例如任务名称、关键词、片段描述）。如果用户特地指定使用搜索，或明确给出了任务查询关键字，则目标是**任务**时优先使用 `+search`。如果用户没有特地指定使用搜索，且意图里没有查询关键字，只有范围条件（例如"今年以来""已完成""由我创建""我关注的"），并且列取与搜索都能达到目的时，应优先使用列表型能力：其中"与我相关 / 我关注的 / 由我创建"优先 `+get-related-tasks`；"我负责的 / 分配给我"优先 `+get-my-tasks`。不要把时间范围词（例如"今年以来"）本身误当成 `query` 去走搜索。
+- **任务搜索相关性提示**：`+search` 当前不会自动判断搜索结果与搜索发起人的相关性。如果用户明确要求搜索"与我相关"的任务，必须先识别具体关系，获取当前用户的 `open_id`，并显式传入对应的 `--assignee`（负责人）、`--creator`（创建人）或 `--follower`（关注人）过滤条件；不能只依赖 `query` 期待自动返回与当前用户相关的任务。
+- **任务清单搜索技巧**：任务清单遵循同样的判断逻辑。有清单查询关键字（清单名称、关键词、片段描述）或明确要求搜索时用 `+tasklist-search`；若只有范围条件（例如"由我创建的任务清单""今年以来创建的清单"），可用原生 `tasklists list` 列取（先 `lark-cli schema task.tasklists.list`，再 `lark-cli task tasklists list --as user ...`），再按 `creator`、`created_at` 等字段做本地筛选和分页控制。
+- **意图区分补充**：像"搜索飞书中今年以来我关注的任务"这类表达，虽字面带"搜索"，但若无真正查询关键字、本质是限定"与我相关 + 时间范围"，应优先走 `+get-related-tasks`；像"搜索飞书中由我创建的任务清单"，若无清单关键字、本质是限定"清单范围 + 创建者"，应优先用原生 `tasklists list` 后本地筛选。
+
+## 待办归属 disambiguation（必读）
+
+用户提到「待办 / todo / 任务」时，**先判断归属**，不要默认走本 skill：
+
+- **妙记里的待办能力在当前沙箱不可用**（也不走本 skill）：上下文含 **妙记 / 会议纪要 / minute_token / 妙记 URL**（`/minutes/`）；或「在某某妙记里新建/修改待办」「妙记 AI 待办」「会议录制里的待办」——直接告知用户该能力当前在沙箱不可用，不要用本 skill 或其它域命令替代。
+- **走本 skill（lark-task）**：任务清单、分配给我、项目待办、截止日期/提醒、子任务、任务清单成员；或 applink 含 `client/todo/task?guid=`；或明确说「飞书任务」「任务中心」「我的任务清单」。
+- 用户要在妙记里加待办时，不要用 task 命令去「找清单再放任务」。
+
+## 输出与渲染
+
+- **友好输出**：输出任务（或清单）结果时，建议同时提取并输出返回结果里的 `url` 字段（任务链接），方便用户点击跳转。
+- **人员字段**：渲染负责人、创建人、owner、成员等人员字段时，除展示 `id`（如 open_id）外，应尽量通过通讯录（`lark-cli contact +search-user --user-ids <open_id>`）解析并展示真实姓名，便于识别。
+- **时间字段**：渲染创建时间、截止时间等字段时使用本地时区，格式为 `2006-01-02 15:04:05`。
+
+## Task GUID 定义
+
+Task OpenAPI 中用于操作任务的 `guid` 是任务的全局唯一标识（GUID），不是客户端展示的任务编号（例如 `t104121` / `suite_entity_num`）。对于飞书任务 applink（例如 `.../client/todo/task?guid=...`），必须使用 URL query 里的 `guid` 参数作为 task guid。
+
+## Shortcuts
+
+| Shortcut | 说明 |
+|----------|------|
+| [`+get-my-tasks`](references/lark-task-get-my-tasks.md) | 列出分配给当前用户的任务（支持按完成状态、创建时间、截止时间过滤） |
+| [`+get-related-tasks`](references/lark-task-get-related-tasks.md) | 列出与当前用户相关的任务（支持仅看我创建 / 我关注） |
+| [`+search`](references/lark-task-search.md) | 按关键词与过滤条件搜索任务 |
+| [`+tasklist-search`](references/lark-task-tasklist-search.md) | 按关键词与过滤条件搜索任务清单 |
+
+## API Resources
+
+除上述快捷命令外，本域在沙箱内**仅**以下只读原生 API 命令可用（通用格式 `lark-cli task <resource> <method> [flags]`）：
+
+### tasks
+
+- `get` — 获取任务详情
+- `list` — 列取任务列表
+
+### tasklists
+
+- `get` — 获取清单详情
+- `list` — 获取清单列表
+- `tasks` — 获取清单任务列表
+
+### subtasks
+
+- `list` — 获取任务的子任务列表
+
+示例：
+
+```bash
+# 获取单个任务详情
+lark-cli task tasks get --task-guid <task_guid>
+
+# 获取清单下的任务列表
+lark-cli task tasklists tasks --tasklist-guid <tasklist_guid>
+```
+
+### 查询方法的使用方式
+
+- 查看方法的 cli flag：`lark-cli task <resource> <method> -h`
+- 查看方法 API 参数：`lark-cli schema task.<resource>.<method>`（例：`lark-cli schema task.tasks.get`）
+
+沙箱内仅上述 API 命令可用，不要尝试其它 `service`/`api` 组合或写操作方法。
+
+## 权限表（保留只读命令）
+
+| 方法 | 所需 scope |
+|------|-----------|
+| `tasks.get` | `task:task:read` |
+| `tasks.list` | `task:task:read` |
+| `tasklists.get` | `task:tasklist:read` |
+| `tasklists.list` | `task:tasklist:read` |
+| `tasklists.tasks` | `task:tasklist:read` |
+| `subtasks.list` | `task:task:read` |
+
+## 常用其他域命令
+
+```bash
+# 把任务里的人员 open_id 解析为真实姓名，更多参数详见 lark-contact
+lark-cli contact +search-user --user-ids <open_id>
+```

package/shared/lark-cli/lark-task/references/lark-task-get-my-tasks.md

@@ -0,0 +1,57 @@
+# task +get-my-tasks
+
+If the user query only specifies a task name (e.g., "Complete task Lobster No. 1"), use this command to list and search for the task by its summary.
+
+> **Output rendering note:**
+> 1. If you need to present user fields (assignee, creator, etc.), do not only output the raw `id` (e.g. open_id). Also try to resolve and display the user's real name (e.g. via the contact skill) for readability.
+> 2. When rendering timestamps (e.g. created time, due time), use the local timezone. Format is 2006-01-02 15:04:05
+
+List tasks assigned to the current user, with support for filtering by completion status, creation time, and due date.
+By default, the command will automatically paginate up to 20 times. Use `--page-all` to fetch more (up to 40 pages).
+
+> **Pending vs all tasks:** When `--complete` is not provided, the result contains **both completed and incomplete tasks**.
+> For standup / daily-summary / pending-todo scenarios, you **must** pass `--complete=false`; otherwise completed tasks will be surfaced as if they were still pending.
+
+## Recommended Commands
+
+```bash
+# Search for a specific task by name
+lark-cli task +get-my-tasks --query "Lobster No. 1"
+
+# Get all my tasks, both completed and incomplete (fetches up to 20 pages by default)
+lark-cli task +get-my-tasks
+
+# Pending-only: my incomplete tasks (use this for standup/daily-summary)
+lark-cli task +get-my-tasks --complete=false
+
+# Pending-only with a due-date upper bound (e.g. end of today / this week)
+lark-cli task +get-my-tasks --complete=false --due-end "2026-03-27T23:59:59+08:00"
+
+# Fetch all my tasks (up to 40 pages)
+lark-cli task +get-my-tasks --page-all
+
+# Fetch up to 10 pages
+lark-cli task +get-my-tasks --page-limit 10
+
+# Resume from a known page token
+lark-cli task +get-my-tasks --page-token "pt_xxx"
+```
+
+## Parameters
+
+| Parameter | Required | Description |
+|-----------|----------|-------------|
+| `--query <string>` | No | Search for tasks by summary. Returns exact matches if any; otherwise returns partial matches. |
+| `--complete=<bool>` | No | Optional. If not provided, it fetches all tasks (both incomplete and completed). Set to `true` to fetch only completed tasks, or `false` for incomplete tasks. |
+| `--created_at <string>` | No | Query tasks created after this time. Supports date: `YYYY-MM-DD`, relative: `-2d`, or ms timestamp. |
+| `--due-start <string>` | No | Query tasks with a due date after this time. Supports date: `YYYY-MM-DD`, relative: `-2d`, or ms timestamp. |
+| `--due-end <string>` | No | Query tasks with a due date before this time. Supports date: `YYYY-MM-DD`, relative: `-2d`, or ms timestamp. |
+| `--page-all` | No | Automatically paginate through all pages (max 40). |
+| `--page-limit <int>` | No | Max page limit (default 20). |
+| `--page-token <string>` | No | Start from the specified page token (useful for resuming a previous query). |
+
+## Workflow
+
+1. Determine the filters based on the user's request.
+2. Execute the command. The CLI will automatically loop up to the specified limit (default 20, or 40 with `--page-all`) to fetch records.
+3. Show the results (ID, summary, due time, and created date).

package/shared/lark-cli/lark-task/references/lark-task-get-related-tasks.md

@@ -0,0 +1,49 @@
+# task +get-related-tasks
+
+> **Pagination / Time Cursor Rule:**
+> In `+get-related-tasks`, `page_token` is the task `updated_at` cursor in microseconds.
+>
+> **Execution Priority:**
+> 1. If the request contains a start/end time boundary (for example, "今年以来", "最近一个月", "从 3 月 1 日开始"), first convert the **start time** boundary to a microsecond `page_token` and query from that token.
+> 2. Continue pagination using returned `page_token` until `has_more=false`, but never exceed 40 total page fetches.
+> 3. Do NOT default to `--page-all` for time-bounded queries.
+>
+> Only use `--page-all` from the beginning when:
+> 1. the user explicitly asks for a full scan of all related tasks, or
+> 2. no time boundary can be inferred from the request.
+
+List tasks related to the current user.
+
+## Recommended Commands
+
+```bash
+# List all related tasks
+lark-cli task +get-related-tasks
+
+# List incomplete related tasks starting from a page token
+lark-cli task +get-related-tasks --include-complete=false --page-token "1752730590582902"
+
+# Show only tasks created by me
+lark-cli task +get-related-tasks --created-by-me
+```
+
+## Parameters
+
+| Parameter | Required | Description |
+|-----------|----------|-------------|
+| `--include-complete=<bool>` | No | Default behavior includes completed tasks. Set to `false` to keep only incomplete tasks. |
+| `--page-all` | No | Automatically paginate through all pages (max 40). |
+| `--page-limit <int>` | No | Max page limit (default 20). |
+| `--page-token <string>` | No | Start from the specified page token. This token is the task's last update time cursor in microseconds. |
+| `--created-by-me` | No | Keep only tasks whose creator is the current user. This is a client-side filter applied after fetching related-task pages. |
+| `--followed-by-me` | No | Keep only tasks followed by the current user. This is a client-side filter applied after fetching related-task pages. |
+
+> **Page Token Note:** In `+get-related-tasks`, the `page_token` is a microsecond-level cursor representing the task's last update time. For example, `1752730590582902` should be treated as an updated-at cursor, not a task ID.
+>
+> **Pagination Note for Client-side Filters:** When `--created-by-me` or `--followed-by-me` is used, filtering happens locally after each upstream related-task page is fetched. The returned `has_more` and `page_token` still describe the upstream cursor, so later pages may contain more matching tasks, or may contain none.
+
+## Workflow
+
+1. Determine whether the user needs all related tasks or a filtered subset.
+2. Execute `lark-cli task +get-related-tasks ...`
+3. Report the matching tasks and, if present, the next `page_token`.

package/shared/lark-cli/lark-task/references/lark-task-search.md

@@ -0,0 +1,36 @@
+# task +search
+
+Search tasks by keyword and optional filters.
+
+## Recommended Commands
+
+```bash
+# Search by keyword
+lark-cli task +search --query "test"
+
+# Search incomplete tasks assigned to specific users
+lark-cli task +search --assignee "ou_xxx,ou_yyy" --completed=false
+
+# Search by due time range
+lark-cli task +search --query "release" --due "-1d,+7d"
+```
+
+## Parameters
+
+| Parameter | Required | Description |
+|-----------|----------|-------------|
+| `--query <string>` | No | Search keyword. If omitted, at least one filter must be provided. |
+| `--creator <ids>` | No | Creator open_ids, comma-separated. |
+| `--assignee <ids>` | No | Assignee open_ids, comma-separated. |
+| `--follower <ids>` | No | Follower open_ids, comma-separated. |
+| `--completed=<bool>` | No | Filter by completion state. |
+| `--due <range>` | No | Due time range in `start,end` form. Each side supports ISO/date/relative/ms input. |
+| `--page-token <string>` | No | Page token for pagination. |
+| `--page-all` | No | Automatically paginate through all pages (max 40). |
+| `--page-limit <int>` | No | Max page limit (default 20). |
+
+## Workflow
+
+1. Build the keyword and filters from the user's request.
+2. Execute `lark-cli task +search ...`
+3. Report the matched tasks and include the next `page_token` if more results exist.

package/shared/lark-cli/lark-task/references/lark-task-tasklist-search.md

@@ -0,0 +1,35 @@
+# task +tasklist-search
+
+> **Note:** This shortcut uses tasklist search followed by tasklist detail queries to render the final output.
+
+Search tasklists by keyword and optional filters.
+
+## Recommended Commands
+
+```bash
+# Search by keyword
+lark-cli task +tasklist-search --query "测试"
+
+# Search tasklists created by specific users
+lark-cli task +tasklist-search --creator "ou_xxx,ou_yyy"
+
+# Search by creation time range
+lark-cli task +tasklist-search --query "Q2" --create-time "-30d,+0d"
+```
+
+## Parameters
+
+| Parameter | Required | Description |
+|-----------|----------|-------------|
+| `--query <string>` | No | Search keyword. If omitted, at least one filter must be provided. |
+| `--creator <ids>` | No | Creator open_ids, comma-separated. |
+| `--create-time <range>` | No | Creation time range in `start,end` form. Each side supports ISO/date/relative/ms input. |
+| `--page-token <string>` | No | Page token for pagination. |
+| `--page-all` | No | Automatically paginate through all pages (max 40). |
+| `--page-limit <int>` | No | Max page limit (default 20). |
+
+## Workflow
+
+1. Build the search keyword and filters from the user's request.
+2. Execute `lark-cli task +tasklist-search ...`
+3. Report the matched tasklists and the next `page_token` if more results exist.

package/shared/lark-cli/lark-vc/README.md

@@ -0,0 +1,40 @@
+# vc (v1)
+
+> [!IMPORTANT]
+> - 运行 `lark-cli --version`，确认可用，无需询问用户。
+
+## 身份
+
+vc 域命令默认使用 `--as user`。
+
+## Shortcuts
+
+| Shortcut | 说明 |
+|----------|------|
+| [`+recording`](references/lark-vc-recording.md) | 查会议录制信息：回看链接、时长、关联妙记 token |
+
+- 使用 Shortcut 前，必须先读 [references/lark-vc-recording.md](references/lark-vc-recording.md)。
+
+## 输入要求 —— 必须直接给 ID
+
+`+recording` 只接受 `meeting_id` 或日程实例 ID。本域没有按会议链接、会议号或自然语言描述
+定位会议的命令，所以拿到这些形式时**先向用户索取 ID**，不要试其它域的命令绕。
+
+| 用户给了什么 | 怎么做 |
+|---|---|
+| `meeting_id` | `+recording --meeting-ids <id>` |
+| 日程实例 ID | `+recording --calendar-event-ids <id>` |
+| 会议链接 / 会议号 / 「上周三那个会」 | 告知用户需要提供会议 ID 或日程实例 ID |
+
+## 意图路由
+
+| 用户需求 | 命令 |
+|---|---|
+| 这个会有没有录制、能不能回看 | `+recording --meeting-ids <meeting_id>` |
+| 这个会录了多长 | 同上，读返回的 `duration` |
+| 从日程查对应会议的录制 | `+recording --calendar-event-ids <日程实例 ID>` |
+
+## 拿到 minute_token 之后
+
+`+recording` 返回体含 `minute_token`。需要下载录制的音视频文件时，切到
+[lark-minutes](../lark-minutes/README.md) 用 `minutes +download`——那是本 skill 内可用的下载入口。

package/shared/lark-cli/lark-vc/references/lark-vc-recording.md

@@ -0,0 +1,31 @@
+# vc +recording
+
+命令事实以 `lark-cli vc +recording --help` 为准。
+
+## 命令骨架
+
+```bash
+lark-cli vc +recording --meeting-ids <meeting_id> --as user
+lark-cli vc +recording --calendar-event-ids <日程实例 ID> --as user
+```
+
+- `--meeting-ids` 与 `--calendar-event-ids` 二选一，都支持逗号分隔批量。
+- 没有其它定位方式：本域只有 `+recording` 一个入口，只有会议链接或会议号时无法换到
+  `meeting_id`，需向用户索取。
+
+## 输出契约
+
+关键字段：
+
+| 字段 | 含义 |
+|---|---|
+| `recording_url` | 回看入口链接 |
+| `duration` | 录制时长 |
+| `minute_token` | 关联妙记 token，可交给 [lark-minutes](../lark-minutes/README.md) 的 `minutes +download` 下载音视频 |
+
+## Agent 规则
+
+- 用户问「能不能回看」「录了多久」时，直接转述 `recording_url` 与 `duration`，不必展开整个响应体。
+- 批量查多个会议时用一次调用传逗号分隔的 ID，不要循环单查。
+- 命令失败时把 `error.hint` 转述给用户；录制读取依赖高级权限，权限类报错要说明是权限问题，
+  不要改用其它命令重试。

package/shared/lark-cli/lark-whiteboard/README.md

@@ -0,0 +1,35 @@
+# whiteboard (v1)
+
+> [!IMPORTANT]
+> - 运行 `lark-cli --version`，确认可用，无需询问用户。
+
+## 身份
+
+画板导出默认使用 `--as user`。
+
+## Shortcuts
+
+| Shortcut | 说明 |
+|----------|------|
+| [`+export`](references/lark-whiteboard-export.md) | 导出画板为预览图片、SVG 矢量图、代码或原始节点结构。 |
+
+- 使用 Shortcut 前，必须先读其对应 reference 文档。
+
+## 意图路由
+
+| 用户需求 | 命令 |
+|---|---|
+| 查看画板内容 / 导出图片 | [`+export --output-type preview`](references/lark-whiteboard-export.md) |
+| 导出 SVG 矢量图 | [`+export --output-type svg`](references/lark-whiteboard-export.md) |
+| 获取画板的 Mermaid/PlantUML 代码 | [`+export --output-type source`](references/lark-whiteboard-export.md) |
+| 检查画板是否由代码绘制 | [`+export --output-type source`](references/lark-whiteboard-export.md) |
+| 导出画板原始节点结构（OpenAPI 原生格式） | [`+export --output-type raw`](references/lark-whiteboard-export.md) |
+
+## 获取画板 token
+
+导出需要画板 token（形如 `wbcnXXX`）：
+
+| 用户给了什么 | 怎么获取 |
+|---|---|
+| 直接给了 whiteboard token（`wbcnXXX`）| 直接使用 |
+| 文档 URL 或 doc_id，文档中已有画板 | `lark-cli docs +fetch --doc <URL> --as user`，从返回的 `<whiteboard token="xxx"/>` 提取（参数详见 [lark-doc](../lark-doc/README.md)）|