pi-feishu-cli 0.1.0

package/skills/lark-base/references/lark-base-form-questions-create.md

@@ -0,0 +1,118 @@
+# base +form-questions-create
+
+> **前置条件：** 先阅读 [`../lark-shared/SKILL.md`](../../lark-shared/SKILL.md) 了解认证、全局参数和安全规则。
+
+向多维表格表单/问卷中批量添加问题。
+
+## 命令
+
+```bash
+# 添加一个文本必填问题
+lark-cli base +form-questions-create \
+  --base-token <base_token> \
+  --table-id <table_id> \
+  --form-id <form_id> \
+  --questions '[{"type":"text","title":"您的姓名是？","required":true}]'
+
+# 添加多个问题（按顺序排列）
+lark-cli base +form-questions-create \
+  --base-token <base_token> \
+  --table-id <table_id> \
+  --form-id <form_id> \
+  --questions '[
+    {"type":"text","title":"您的姓名是？","required":true},
+    {"type":"text","title":"您的联系方式是？","required":false}
+  ]'
+
+# 添加单选题（带选项）
+lark-cli base +form-questions-create \
+  --base-token <base_token> \
+  --table-id <table_id> \
+  --form-id <form_id> \
+  --questions '[{"type":"select","title":"满意度评价","required":true,"multiple":false,"options":[{"name":"非常满意","hue":"Green"},{"name":"满意","hue":"Blue"},{"name":"一般","hue":"Yellow"}]}]'
+
+# 添加评分题
+lark-cli base +form-questions-create \
+  --base-token <base_token> \
+  --table-id <table_id> \
+  --form-id <form_id> \
+  --questions '[{"type":"number","title":"服务评分","style":{"type":"rating","icon":"star","min":1,"max":5}}]'
+  
+# 添加带描述的问题（纯文本）
+lark-cli base +form-questions-create \
+  --base-token <base_token> \
+  --table-id <table_id> \
+  --form-id <form_id> \
+  --questions '[{"type":"text","title":"您的姓名","description":"请填写真实姓名"}]'
+# 添加带描述的问题（含链接）
+lark-cli base +form-questions-create \
+  --base-token <base_token> \
+  --table-id <table_id> \
+  --form-id <form_id> \
+  --questions '[{"type":"text","title":"反馈建议","description":"更多详情请查看[帮助文档](https://example.com/help)"}]'  
+```
+
+## 参数
+
+| 参数 | 必填 | 说明 |
+|------|------|------|
+| `--base-token <token>` | 是 | Base Token（base_token） |
+| `--table-id <id>` | 是 | 数据表 ID |
+| `--form-id <id>` | 是 | 表单 ID |
+| `--questions <json>` | 是 | 问题 JSON 数组，最多 10 个（见下方格式） |
+| `--format` | 否 | 输出格式：json（默认）\| pretty \| table \| ndjson \| csv |
+| `--as` | 否 | 身份：user（默认）\| bot |
+| `--dry-run` | 否 | 预览 API 调用，不执行 |
+
+## `--questions` 格式
+
+每个问题对象支持以下字段：
+
+| 字段                    | 必填 | 说明 |
+|-----------------------|------|------|
+| `title`               | **是** | 问题标题（字段名） |
+| `type`                | **是** | 题目类型：`text`、`number`、`select`、`datetime`、`user`、`attachment`、`location` |
+| `description`         | 否 | 问题描述（纯文本或 Markdown 链接，如 `[文本](https://example.com)`） |
+| `required`            | 否 | 是否必填（true/false） |
+| `option_display_mode` | 否 | 选项展示方式（仅 `select` 有效）：`0`=下拉，`1`=纵向（默认），`2`=横向 |
+| `multiple`            | 否 | 是否多选（`select`/`user` 类型有效，bool） |
+| `options`             | 否 | 选项列表（仅 `select` 有效）：`[{"name":"选项1","hue":"Blue"}]`，hue 可选：`Red`/`Orange`/`Yellow`/`Green`/`Blue`/`Purple`/`Gray` |
+| `style`               | 否 | 字段样式配置（见下方说明） |
+
+### `style` 字段说明
+
+| 类型 | style 结构 | 说明 |
+|------|------|------|
+| `text` | `{"type":"plain"}` | 当前仅支持 `plain` |
+| `number` | `{"type":"plain","precision":2}` | precision 为小数位数 |
+| `number`（评分） | `{"type":"rating","icon":"star","min":1,"max":5}` | icon 可选：`star`/`heart`/`thumbsup`/`fire`/`smile`/`lightning`/`flower`/`number` |
+| `datetime` | `{"format":"yyyy/MM/dd"}` | format 可选：`yyyy/MM/dd`、`yyyy/MM/dd HH:mm`、`MM-dd`、`MM/dd/yyyy`、`dd/MM/yyyy` |
+
+## 输出格式
+
+返回创建成功的问题列表：
+
+```json
+{
+  "ok": true,
+  "data": {
+    "items": [
+      {"id": "q_001", "title": "您的姓名是？", "required": true}
+    ]
+  }
+}
+```
+
+## 工作流
+
+> [!CAUTION]
+> 这是**写入操作** — 执行前必须向用户确认。
+
+1. 先用 `+form-questions-list` 查看现有问题
+2. 确认要添加的问题内容
+3. 执行命令并报告新建的问题 ID
+
+## 参考
+
+- [lark-base](../SKILL.md) — 多维表格全部命令
+- [lark-shared](../../lark-shared/SKILL.md) — 认证和全局参数

package/skills/lark-base/references/lark-base-form-questions-delete.md

@@ -0,0 +1,68 @@
+# base +form-questions-delete
+
+> **前置条件：** 先阅读 [`../lark-shared/SKILL.md`](../../lark-shared/SKILL.md) 了解认证、全局参数和安全规则。
+
+从多维表格表单中批量删除问题。**不可逆操作**，执行前务必确认。
+
+## 命令
+
+```bash
+# 删除一个问题
+lark-cli base +form-questions-delete \
+  --base-token <base_token> \
+  --table-id <table_id> \
+  --form-id <form_id> \
+  --question-ids '["q_001"]'
+
+# 批量删除多个问题
+lark-cli base +form-questions-delete \
+  --base-token <base_token> \
+  --table-id <table_id> \
+  --form-id <form_id> \
+  --question-ids '["q_001","q_002","q_003"]'
+
+# 预览（不实际执行）
+lark-cli base +form-questions-delete \
+  --base-token <base_token> \
+  --table-id <table_id> \
+  --form-id <form_id> \
+  --question-ids '["q_001"]' \
+  --dry-run
+```
+
+## 参数
+
+| 参数 | 必填 | 说明 |
+|------|------|------|
+| `--base-token <token>` | 是 | 多维表格 App token（base_token） |
+| `--table-id <id>` | 是 | 数据表 ID |
+| `--form-id <id>` | 是 | 表单 ID |
+| `--question-ids <json>` | 是 | 要删除的问题 ID JSON 数组，最多 10 个，如 `'["q_001","q_002"]'` |
+| `--as` | 否 | 身份：user（默认）\| bot |
+| `--dry-run` | 否 | 预览 API 调用，不执行 |
+
+## 输出格式
+
+```json
+{
+  "ok": true,
+  "data": {
+    "deleted": true,
+    "question_ids": ["q_001", "q_002"]
+  }
+}
+```
+
+## 工作流
+
+> [!CAUTION]
+> 这是**高风险写入操作（删除）** — 执行前必须明确向用户确认，告知此操作不可逆。
+
+1. 先用 `+form-questions-list` 查看问题列表，确认要删除的 `id`
+2. 向用户展示将要删除的问题标题和 ID，等待明确确认
+3. 执行删除并报告结果
+
+## 参考
+
+- [lark-base](../SKILL.md) — 多维表格全部命令
+- [lark-shared](../../lark-shared/SKILL.md) — 认证和全局参数

package/skills/lark-base/references/lark-base-form-questions-list.md

@@ -0,0 +1,84 @@
+# base +form-questions-list
+
+> **前置条件：** 先阅读 [`../lark-shared/SKILL.md`](../../lark-shared/SKILL.md) 了解认证、全局参数和安全规则。
+
+列出多维表格表单/问卷中的所有问题。只读操作，不修改任何数据。
+
+## 命令
+
+```bash
+# 列出表单所有问题
+lark-cli base +form-questions-list \
+  --base-token <base_token> \
+  --table-id <table_id> \
+  --form-id <form_id>
+
+# 以表格形式展示
+lark-cli base +form-questions-list \
+  --base-token <base_token> \
+  --table-id <table_id> \
+  --form-id <form_id> \
+  --format table
+
+# 使用应用身份（bot）
+lark-cli base +form-questions-list \
+  --base-token <base_token> \
+  --table-id <table_id> \
+  --form-id <form_id> \
+  --as bot
+```
+
+## 参数
+
+| 参数 | 必填 | 说明 |
+|------|------|------|
+| `--base-token <token>` | 是 | Base Token（base_token） |
+| `--table-id <id>` | 是 | 数据表 ID |
+| `--form-id <id>` | 是 | 表单 ID |
+| `--format` | 否 | 输出格式：json（默认）\| pretty \| table \| ndjson \| csv |
+| `--as` | 否 | 身份：user（默认）\| bot |
+| `--dry-run` | 否 | 预览 API 调用，不执行 |
+
+## 输出格式
+
+每条问题包含以下字段：
+
+| 字段 | 说明 |
+|------|------|
+| `id` | 问题 ID（即数据表的 field_id） |
+| `title` | 问题标题 |
+| `description` | 问题描述 |
+| `required` | 是否必填 |
+
+```json
+{
+  "ok": true,
+  "data": {
+    "questions": [
+      {
+        "id": "q_001",
+        "title": "您的姓名是？",
+        "description": "请填写真实姓名",
+        "required": true
+      },
+      {
+        "id": "q_002",
+        "title": "您的联系方式是？",
+        "description": "手机号或邮箱",
+        "required": false
+      }
+    ],
+    "total": 2
+  }
+}
+```
+
+## 提示
+
+- 问题 `id` 与数据表的 `field_id` 相同
+- 返回的问题列表已按顺序排列
+
+## 参考
+
+- [lark-base](../SKILL.md) — 多维表格全部命令
+- [lark-shared](../../lark-shared/SKILL.md) — 认证和全局参数

package/skills/lark-base/references/lark-base-form-questions-update.md

@@ -0,0 +1,92 @@
+# base +form-questions-update
+
+> **前置条件：** 先阅读 [`../lark-shared/SKILL.md`](../../lark-shared/SKILL.md) 了解认证、全局参数和安全规则。
+
+批量更新多维表格表单/问卷中的问题（标题、描述、是否必填）。
+
+## 命令
+
+```bash
+# 更新一个问题的标题
+lark-cli base +form-questions-update \
+  --base-token <base_token> \
+  --table-id <table_id> \
+  --form-id <form_id> \
+  --questions '[{"id":"q_001","title":"您的真实姓名是？"}]'
+
+# 同时更新多个问题
+lark-cli base +form-questions-update \
+  --base-token <base_token> \
+  --table-id <table_id> \
+  --form-id <form_id> \
+  --questions '[
+    {"id":"q_001","title":"姓名（必填）","required":true},
+    {"id":"q_002","title":"联系方式","required":false}
+  ]'
+  
+# 更新问题描述（纯文本）
+lark-cli base +form-questions-update \
+  --base-token <base_token> \
+  --table-id <table_id> \
+  --form-id <form_id> \
+  --questions '[{"id":"q_001","description":"请填写您的真实姓名"}]'
+# 更新问题描述（含链接）
+lark-cli base +form-questions-update \
+  --base-token <base_token> \
+  --table-id <table_id> \
+  --form-id <form_id> \
+  --questions '[{"id":"q_001","description":"更多说明请参考[帮助文档](https://example.com/help)"}]'  
+```
+
+## 参数
+
+| 参数 | 必填 | 说明 |
+|------|------|------|
+| `--base-token <token>` | 是 | Base Token（base_token） |
+| `--table-id <id>` | 是 | 数据表 ID |
+| `--form-id <id>` | 是 | 表单 ID |
+| `--questions <json>` | 是 | 问题更新 JSON 数组，最多 10 个（见下方格式） |
+| `--format` | 否 | 输出格式：json（默认）\| pretty \| table \| ndjson \| csv |
+| `--as` | 否 | 身份：user（默认）\| bot |
+| `--dry-run` | 否 | 预览 API 调用，不执行 |
+
+## `--questions` 格式
+
+每个问题对象必须包含 `id`，其余字段按需传入：
+
+| 字段 | 必填 | 说明 |
+|------|------|------|
+| `id` | **是** | 问题 ID（field_id），不可修改 |
+| `title` | 否 | 新的问题标题 |
+| `description` | 否 | 新的问题描述（纯文本或 Markdown 链接，如 `[文本](https://example.com)`） |
+| `required` | 否 | 是否必填 |
+| `option_display_mode` | 否 | 选项展示方式（仅 `select` 有效）：`0`=下拉，`1`=纵向（默认），`2`=横向 |
+
+## 输出格式
+
+返回更新后的问题列表：
+
+```json
+{
+  "ok": true,
+  "data": {
+    "items": [
+      {"id": "q_001", "title": "姓名（必填）", "required": true}
+    ]
+  }
+}
+```
+
+## 工作流
+
+> [!CAUTION]
+> 这是**写入操作** — 执行前必须向用户确认。
+
+1. 先用 `+form-questions-list` 获取现有问题及其 `id`
+2. 构造包含 `id` 的更新数组
+3. 执行命令并报告更新结果
+
+## 参考
+
+- [lark-base](../SKILL.md) — 多维表格全部命令
+- [lark-shared](../../lark-shared/SKILL.md) — 认证和全局参数

package/skills/lark-base/references/lark-base-form-questions.md

@@ -0,0 +1,23 @@
+# base form questions shortcuts
+
+> **前置条件：** 先阅读 [`../lark-shared/SKILL.md`](../../lark-shared/SKILL.md) 了解认证、全局参数和安全规则。
+
+form questions 相关命令索引。
+
+## 命令导航
+
+| 文档 | 命令 | 说明 |
+|------|------|------|
+| [lark-base-form-questions-list.md](lark-base-form-questions-list.md) | `+form-questions-list` | 列出表单问题 |
+| [lark-base-form-questions-create.md](lark-base-form-questions-create.md) | `+form-questions-create` | 创建表单问题 |
+| [lark-base-form-questions-update.md](lark-base-form-questions-update.md) | `+form-questions-update` | 更新表单问题 |
+| [lark-base-form-questions-delete.md](lark-base-form-questions-delete.md) | `+form-questions-delete` | 删除表单问题 |
+
+## 相关
+
+- [lark-base-form.md](lark-base-form.md) — 表单管理
+
+## 说明
+
+- 聚合页只保留目录职责；每个命令的详细说明请进入对应单命令文档。
+- 所有 `+xxx-list` 调用都必须串行执行；若要批量跑多个 list 请求，只能串行执行。

package/skills/lark-base/references/lark-base-form-submit.md

@@ -0,0 +1,171 @@
+# base +form-submit
+
+> **前置条件：** 先阅读 [`../lark-shared/SKILL.md`](../../lark-shared/SKILL.md) 了解认证、全局参数和安全规则。
+
+通过表单分享链接填写并提交多维表格表单。仅支持分享模式（share_token），支持填写普通字段值和上传本地文件作为附件。
+
+## 填写前必读：先获取表单详情
+
+**在调用 `+form-submit` 之前，必须先使用 [`+form-detail`](lark-base-form-detail.md) 获取表单详情。** 原因如下：
+
+1. **字段类型匹配**：每个题目的 `type` 决定了值的格式（文本、数字、选项、人员、日期等），需根据类型正确构造 `fields` 中的值
+2. **必填校验**：通过 `questions[].required` 判断哪些题目为必填项，避免遗漏
+3. **显示条件过滤**：部分题目带有 `filter`（显示/隐藏逻辑），需根据用户已填的其他题目值判断该题目是否应该出现——**不应填写被 filter 隐藏的题目**
+4. **获取 base_token（附件场景必用）**：`+form-detail` 返回的 `data.base_token` 是该表单所属的多维表格标识。当表单包含附件字段时，提交时必须通过 `--base-token` 传入此值，因为附件需要上传到该 Base 的 Drive Media 中
+
+典型流程：
+
+```bash
+# 1️⃣ 先获取表单详情，了解所有题目
+lark-cli base +form-detail --share-token <share_token>
+
+# 2️⃣ 根据返回的 questions 列表，按 type 格式化值、检查 required、判断 filter 条件
+
+# 3️⃣ 再提交
+lark-cli base +form-submit \
+  --share-token <share_token> \
+  --json '{"fields":{...}}'
+```
+
+详见 [`lark-base-form-detail.md`](lark-base-form-detail.md) 中的「questions 结构说明」和「filter 结构说明」。
+
+## 命令
+
+```bash
+# 基本提交（填写普通字段）
+lark-cli base +form-submit \
+  --share-token <share_token> \
+  --json '{"fields":{"服务评分":5,"评价内容":"服务态度好"}}'
+
+# 带附件提交（需要额外提供 --base-token）
+lark-cli base +form-submit \
+  --share-token <share_token> \
+  --base-token <base_token> \
+  --json '{
+    "fields": {"服务评分": 5, "评价内容": "好"},
+    "attachments": {
+      "附件字段名": ["./report.pdf", "./photo.png"],
+      "另一个附件字段": ["./doc.docx"]
+    }
+  }'
+
+# 使用应用身份（bot）
+lark-cli base +form-submit \
+  --share-token <share_token> \
+  --json '{"fields":{...}}' \
+  --as bot
+
+# 预览 API 调用（不实际执行）
+lark-cli base +form-submit \
+  --share-token <share_token> \
+  --json '{"fields":{...}}' \
+  --dry-run
+```
+
+## 参数
+
+| 参数 | 必填 | 说明 |
+|------|------|------|
+| `--share-token <token>` | 是 | 表单分享 Token（必填），从表单分享链接中提取 |
+| `--base-token <token>` | 条件必填 | Base token；**当 `--json` 包含 `attachments` 时必须提供**，用于将附件上传到 Base Drive Media |
+| `--json <json>` | 是 | JSON 对象，包含 `"fields"`（普通字段值）和 `"attachments"`（附件上传），详见下方说明 |
+| `--format` | 否 | 输出格式：json（默认）\| pretty \| table \| ndjson \| csv |
+| `--as` | 否 | 身份：user（默认）\| bot |
+| `--dry-run` | 否 | 预览 API 调用，不执行 |
+
+### --json 结构说明
+
+`--json` 是一个 JSON 对象，包含两个部分：
+
+#### fields（普通字段）
+
+`fields` 中的单元格值写法与 [`lark-base-cell-value.md`](lark-base-cell-value.md) 完全对齐，填写前应先阅读该文档了解各类型的构造规则：
+
+```json
+{
+  "文本字段": "Hello World",
+  "电话字段": "13800000000",
+  "超链接字段": "https://example.com",
+  "数字字段": 12.5,
+  "单选字段": "选项A",
+  "多选字段": ["选项A", "选项B"],
+  "时间字段": "2026-04-27 14:30:00",
+  "复选框字段": true,
+  "人员字段": [{ "id": "ou_7094d131420c8749632145f08fbf114a" }],
+  "关联字段": [{ "id": "recXXXXXXXXXXXX" }],
+  "地理位置字段": { "lng": 116.397428, "lat": 39.90923 }
+}
+```
+
+> **注意：附件类型字段不要写在 `fields` 里。** `fields` 中不包含附件，附件有独立的填写方式，见下方「attachments（附件上传）」章节。
+
+> 自动编号、公式、创建/修改人、创建/修改时间等系统字段会自动填入，无需手动传入。
+
+#### attachments（附件上传）
+
+**附件字段的填写方式与 `fields` 中的普通单元格完全不同**，不能在 `fields` 里传 `file_token` 或其他附件格式。必须将附件字段单独放在 `--json` 的顶层 `attachments` 对象中，值为**本地文件路径数组**（不是 token）：
+
+```json
+{
+  "attachments": {
+    "附件字段名": ["./report.pdf", "./photo.png"],
+    "另一个附件字段": ["./doc.docx"]
+  }
+}
+```
+
+CLI 收到路径后会自动完成以下流程：
+1. 校验所有文件（存在性、大小 ≤2GB、常规文件）
+2. 并行上传到 Base Drive Media（并发上限 5，跨字段重复路径自动去重）
+3. 获取 `file_token` 后合并到最终表单提交内容中
+
+> 与 [`lark-base-cell-value.md`](lark-base-cell-value.md) 中 Record 场景的附件写法不同：Record 写入时附件走独立的 `+record-upload-attachment` 命令；而 `+form-submit` 只需在 `attachments` 中传本地路径，上传由 CLI 内部自动完成。
+
+### 从分享链接提取 share-token
+
+用户提供形如以下格式的表单分享链接时：
+
+```
+https://www.example.com/share/base/form/shrbcvST8eZy0vk8zjVZ1CAXNye
+```
+
+**提取方式：** 取 URL 路径最后一段作为 `--share-token`。
+
+以上述链接为例：
+
+- `share-token` = `shrbcvST8eZy0vk8zjVZ1CAXNye`
+
+```bash
+lark-cli base +form-submit \
+  --share-token shrbcvST8eZy0vk8zjVZ1CAXNye \
+  --json '{"fields":{...}}'
+```
+
+## 输出格式
+
+| 字段 | 类型 | 说明 |
+|------|------|------|
+| `can_submit_again` | bool | 是否可以再次填写 |
+
+```json
+{
+  "ok": true,
+  "data": {
+    "can_submit_again": true
+  }
+}
+```
+
+## 提示
+
+- 本命令仅支持通过表单分享链接（share_token）提交，不支持通过 base_token + table_id + view_id 方式提交
+- **当 `--json` 包含 `attachments` 时，必须额外提供 `--base-token`**，因为附件上传到 Base Drive Media 需要指定目标 Base
+- 附件字段只需在 `--json.attachments` 中提供本地路径即可，CLI 自动完成校验、并行上传、Token 获取和合并写入
+- 限流：单应用 20 QPS，单用户 5 QPS
+- 权限要求：`base:form:update`；使用 attachments 时还需 `docs:document.media:upload`
+
+## 参考
+
+- [lark-base](../SKILL.md) — 多维表格全部命令
+- [lark-shared](../../lark-shared/SKILL.md) — 认证和全局参数
+- [lark-base-form](references/lark-base-form.md) — 表单管理总览

package/skills/lark-base/references/lark-base-form-update.md

@@ -0,0 +1,82 @@
+# base +form-update
+
+> **前置条件：** 先阅读 [`../lark-shared/SKILL.md`](../../lark-shared/SKILL.md) 了解认证、全局参数和安全规则。
+
+更新多维表格数据表中指定表单的名称或描述。
+
+## 命令
+
+```bash
+# 更新表单名称
+lark-cli base +form-update \
+  --base-token <base_token> \
+  --table-id <table_id> \
+  --form-id <form_id> \
+  --name "新表单名称"
+
+# 更新描述（纯文本）
+lark-cli base +form-update \
+  --base-token <base_token> \
+  --table-id <table_id> \
+  --form-id <form_id> \
+  --description "新的描述内容"
+
+# 更新描述（含链接）
+lark-cli base +form-update \
+  --base-token <base_token> \
+  --table-id <table_id> \
+  --form-id <form_id> \
+  --description "新描述，[了解更多](https://example.com)"
+
+# 同时更新名称和描述
+lark-cli base +form-update \
+  --base-token <base_token> \
+  --table-id <table_id> \
+  --form-id <form_id> \
+  --name "新表单名称" \
+  --description "新的描述内容"
+```
+
+## 参数
+
+| 参数 | 必填 | 说明 |
+|------|------|------|
+| `--base-token <token>` | 是 | Base Token（base_token） |
+| `--table-id <id>` | 是 | 数据表 ID |
+| `--form-id <id>` | 是 | 表单 ID |
+| `--name <name>` | 否 | 新的表单名称 |
+| `--description <string>` | 否 | 新的表单描述（纯文本或 Markdown 链接，如 `[文本](https://example.com)`） |
+| `--format` | 否 | 输出格式：json（默认）\| pretty \| table \| ndjson \| csv |
+| `--as` | 否 | 身份：user（默认）\| bot |
+| `--dry-run` | 否 | 预览 API 调用，不执行 |
+
+> `--name` 和 `--description` 至少传一个，否则无实际变更。
+
+## 输出格式
+
+返回更新后的表单信息：
+
+```json
+{
+  "ok": true,
+  "data": {
+    "id": "vewX58te9D",
+    "name": "新表单名称",
+    "description": "新的描述内容"
+  }
+}
+```
+
+## 工作流
+
+> [!CAUTION]
+> 这是**写入操作** — 执行前必须向用户确认。
+
+1. 确认 `form_id`（可通过 `+form-list` 获取）
+2. 确认要修改的字段
+3. 执行命令并报告更新后的值
+
+## 参考
+
+- [lark-base](../SKILL.md) — 多维表格全部命令
+- [lark-shared](../../lark-shared/SKILL.md) — 认证和全局参数

package/skills/lark-base/references/lark-base-form.md

@@ -0,0 +1,25 @@
+# base form shortcuts
+
+> **前置条件：** 先阅读 [`../lark-shared/SKILL.md`](../../lark-shared/SKILL.md) 了解认证、全局参数和安全规则。
+
+form 相关命令索引。
+
+## 命令导航
+
+| 文档 | 命令 | 说明 |
+|------|------|------|
+| [lark-base-form-list.md](lark-base-form-list.md) | `+form-list` | 分页列出表单 |
+| [lark-base-form-get.md](lark-base-form-get.md) | `+form-get` | 获取表单详情（Base 内部路径） |
+| [lark-base-form-detail.md](lark-base-form-detail.md) | `+form-detail` | 通过分享链接获取表单详情（含题目列表） |
+| [lark-base-form-create.md](lark-base-form-create.md) | `+form-create` | 创建表单 |
+| [lark-base-form-update.md](lark-base-form-update.md) | `+form-update` | 更新表单 |
+| [lark-base-form-delete.md](lark-base-form-delete.md) | `+form-delete` | 删除表单 |
+
+## 相关
+
+- [lark-base-form-questions.md](lark-base-form-questions.md) — 表单问题（表单字段）管理
+
+## 说明
+
+- 聚合页只保留目录职责；每个命令的详细说明请进入对应单命令文档。
+- 所有 `+xxx-list` 调用都必须串行执行；若要批量跑多个 list 请求，只能串行执行。

package/skills/lark-base/references/lark-base-history.md

@@ -0,0 +1,16 @@
+# base history shortcuts
+
+> **前置条件：** 先阅读 [`../lark-shared/SKILL.md`](../../lark-shared/SKILL.md) 了解认证、全局参数和安全规则。
+
+history 相关命令索引。
+
+## 命令导航
+
+| 文档 | 命令 | 说明 |
+|------|------|------|
+| [lark-base-record-history-list.md](lark-base-record-history-list.md) | `+record-history-list` | 按 `table-id + record-id` 查询记录变更历史 |
+
+## 说明
+
+- 聚合页只保留目录职责；每个命令的详细说明请进入对应单命令文档。
+- 所有 `+xxx-list` 调用都必须串行执行；若要批量跑多个 list 请求，只能串行执行。