@fectivnfy112358/minimax-code-web 0.1.0-preview.0 → 0.1.0-preview.3

package/server/assets/skills/lark-tools/cli-skills/lark-base/references/lark-base-field-update.md

@@ -0,0 +1,97 @@
+# base +field-update
+
+> **前置条件：** 先阅读 [`../lark-shared/SKILL.md`](../../lark-shared/SKILL.md) 了解认证、全局参数和安全规则。
+
+更新一个已有字段。
+
+## 推荐命令
+
+```bash
+lark-cli base +field-update \
+  --base-token app_xxx \
+  --table-id tbl_xxx \
+  --field-id fld_xxx \
+  --json '{"name":"状态","type":"select","multiple":false,"options":[{"name":"Todo","hue":"Blue","lightness":"Lighter"},{"name":"Doing","hue":"Orange","lightness":"Light"},{"name":"Done","hue":"Green","lightness":"Light"}]}'
+
+lark-cli base +field-update \
+  --base-token app_xxx \
+  --table-id tbl_xxx \
+  --field-id fld_xxx \
+  --json '{"name":"负责人","type":"user","multiple":false,"description":"用于标记记录的直接负责人；协作约定可参考[团队字段约定](https://example.com/field-spec)"}'
+```
+
+## 参数
+
+| 参数 | 必填 | 说明 |
+|------|------|------|
+| `--base-token <token>` | 是 | Base Token |
+| `--table-id <id_or_name>` | 是 | 表 ID 或表名 |
+| `--field-id <id_or_name>` | 是 | 字段 ID 或字段名 |
+| `--json <body>` | 是 | 字段属性 JSON 对象 |
+## API 入参详情
+
+**HTTP 方法和路径：**
+
+```
+PUT /open-apis/base/v3/bases/:base_token/tables/:table_id/fields/:field_id
+```
+
+## JSON 值规范
+
+- `--json` 必须是 **JSON 对象**，顶层直接传字段定义。
+- 更新语义是 `PUT`（全量字段配置更新），不要只传零散片段；至少显式包含 `name`、`type`，并补齐该类型所需关键配置。
+- 如需字段说明，直接传 `description`；支持纯文本，也支持 Markdown 链接，如 `协作约定可参考[团队字段约定](https://example.com/field-spec)`。
+- `select` 更新时：`options` 仍按对象数组传，避免混入无效字段。
+- `link` 更新限制：
+  - 不能把非 `link` 字段改成 `link`，也不能把 `link` 改成非 `link`。
+  - 现有 `link` 字段的 `bidirectional` 不能改。
+
+**推荐更新示例**
+
+```json
+{
+  "name": "状态",
+  "type": "select",
+  "multiple": false,
+  "options": [
+    { "name": "Todo", "hue": "Blue", "lightness": "Lighter" },
+    { "name": "Doing", "hue": "Orange", "lightness": "Light" },
+    { "name": "Done", "hue": "Green", "lightness": "Light" }
+  ]
+}
+```
+
+**字段说明示例**
+
+```json
+{
+  "name": "负责人",
+  "type": "user",
+  "multiple": false,
+  "description": "用于标记记录的直接负责人；协作约定可参考[团队字段约定](https://example.com/field-spec)"
+}
+```
+
+## 返回重点
+
+- 返回 `field` 和 `updated: true`。
+
+## 工作流
+
+
+1. 建议先用 `+field-get` 拉现状，再做最小化修改。
+2. `formula/lookup` 类型更新前先阅读对应指南。
+
+## 坑点
+
+- ⚠️ 这是全量字段属性更新语义，不是 patch。
+- ⚠️ 这是写入操作，执行前必须确认。
+- ⚠️ 当 `type` 是 `formula` 或 `lookup` 时，先阅读对应指南再执行。
+
+## 参考
+
+- [lark-base-field.md](lark-base-field.md) — field 索引页
+- [lark-base-field-get.md](lark-base-field-get.md) — 查字段
+- [lark-base-shortcut-field-properties.md](lark-base-shortcut-field-properties.md) — shortcut 字段 JSON 规范（推荐）
+- [formula-field-guide.md](formula-field-guide.md) — formula 指南（更新公式前必读）
+- [lookup-field-guide.md](lookup-field-guide.md) — lookup 指南（更新查找引用前必读）

package/server/assets/skills/lark-tools/cli-skills/lark-base/references/lark-base-field.md

@@ -0,0 +1,22 @@
+# base field shortcuts
+
+> **前置条件：** 先阅读 [`../lark-shared/SKILL.md`](../../lark-shared/SKILL.md) 了解认证、全局参数和安全规则。
+
+field 相关命令索引。
+
+## 命令导航
+
+| 文档 | 命令 | 说明 |
+|------|------|------|
+| [lark-base-field-list.md](lark-base-field-list.md) | `+field-list` | 分页列字段 |
+| [lark-base-field-get.md](lark-base-field-get.md) | `+field-get` | 获取单字段配置 |
+| [lark-base-field-create.md](lark-base-field-create.md) | `+field-create` | 创建字段 |
+| [lark-base-field-update.md](lark-base-field-update.md) | `+field-update` | 更新字段 |
+| [lark-base-field-search-options.md](lark-base-field-search-options.md) | `+field-search-options` | 搜索选项字段候选值 |
+| [lark-base-field-delete.md](lark-base-field-delete.md) | `+field-delete` | 删除字段 |
+
+## 说明
+
+- 聚合页只保留目录职责；每个命令的详细说明请进入对应单命令文档。
+- 所有 `+xxx-list` 调用都必须串行执行；若要批量跑多个 list 请求，只能串行执行。
+- 写字段 JSON 前优先阅读 [lark-base-shortcut-field-properties.md](lark-base-shortcut-field-properties.md)。

package/server/assets/skills/lark-tools/cli-skills/lark-base/references/lark-base-form-create.md

@@ -0,0 +1,87 @@
+# base +form-create
+
+> **前置条件：** 先阅读 [`../lark-shared/SKILL.md`](../../lark-shared/SKILL.md) 了解认证、全局参数和安全规则。
+
+在多维表格数据表中创建新表单。
+
+## ⚠️ 注意事项
+
+- **表格选择**：创建问卷前先考虑：这是新的业务领域吗？如果是，建议先用 `+table-create` 创建新表格
+- **命名一致性**：问卷名称应与表格用途相关，避免在通用表格（如"收集表"）中创建不相关的问卷
+
+## 命令
+
+```bash
+# 创建表单（仅必填参数）
+lark-cli base +form-create \
+  --base-token <base_token> \
+  --table-id <table_id> \
+  --name "用户调研问卷"
+
+# 创建时附带描述（纯文本）
+lark-cli base +form-create \
+  --base-token <base_token> \
+  --table-id <table_id> \
+  --name "用户调研问卷" \
+  --description "2024年度用户满意度调研"
+
+# 创建时附带描述（含链接）
+lark-cli base +form-create \
+  --base-token <base_token> \
+  --table-id <table_id> \
+  --name "用户调研问卷" \
+  --description "2024年度调研，[详情请查看](https://example.com)"
+
+# 使用应用身份（bot）
+lark-cli base +form-create \
+  --base-token <base_token> \
+  --table-id <table_id> \
+  --name "用户调研问卷" \
+  --as bot
+```
+
+## 参数
+
+| 参数 | 必填 | 说明 |
+|------|------|------|
+| `--base-token <token>` | 是 | 多维表格 App token（base_token） |
+| `--table-id <id>` | 是 | 数据表 ID |
+| `--name <name>` | 是 | 表单名称 |
+| `--description <string>` | 否 | 表单描述（纯文本或 Markdown 链接，如 `[文本](https://example.com)`） |
+| `--format` | 否 | 输出格式：json（默认）\| pretty \| table \| ndjson \| csv |
+| `--as` | 否 | 身份：user（默认）\| bot |
+| `--dry-run` | 否 | 预览 API 调用，不执行 |
+
+## 输出格式
+
+| 字段 | 说明 |
+|------|------|
+| `id` | 新创建的表单 ID |
+| `name` | 表单名称 |
+| `description` | 表单描述 |
+
+```json
+{
+  "ok": true,
+  "data": {
+    "id": "vewX58te9D",
+    "name": "用户调研问卷",
+    "description": "2024年度用户满意度调研"
+  }
+}
+```
+
+## 工作流
+
+> [!CAUTION]
+> 这是**写入操作** — 执行前必须向用户确认。
+
+1. 确认目标 `app_token` 和 `table_id`
+2. 确认表单名称和描述
+3. 执行命令
+4. 报告返回的 `form_id`，后续可用于添加问题（`+form-questions-create`）
+
+## 参考
+
+- [lark-base](../SKILL.md) — 多维表格全部命令
+- [lark-shared](../../lark-shared/SKILL.md) — 认证和全局参数

package/server/assets/skills/lark-tools/cli-skills/lark-base/references/lark-base-form-delete.md

@@ -0,0 +1,64 @@
+# base +form-delete
+
+> **前置条件：** 先阅读 [`../lark-shared/SKILL.md`](../../lark-shared/SKILL.md) 了解认证、全局参数和安全规则。
+
+删除多维表格数据表中的指定表单。**不可逆操作**，执行前务必确认。
+
+## 命令
+
+```bash
+# 删除表单
+lark-cli base +form-delete \
+  --base-token <base_token> \
+  --table-id <table_id> \
+  --form-id <form_id>
+
+# 预览（不实际执行）
+lark-cli base +form-delete \
+  --base-token <base_token> \
+  --table-id <table_id> \
+  --form-id <form_id> \
+  --dry-run
+```
+
+## 参数
+
+| 参数 | 必填 | 说明 |
+|------|------|------|
+| `--base-token <token>` | 是 | 多维表格 App token（base_token） |
+| `--table-id <id>` | 是 | 数据表 ID |
+| `--form-id <id>` | 是 | 要删除的表单 ID |
+| `--as` | 否 | 身份：user（默认）\| bot |
+| `--dry-run` | 否 | 预览 API 调用，不执行 |
+
+## 输出格式
+
+```json
+{
+  "ok": true,
+  "data": {
+    "deleted": true,
+    "form_id": "vewX58te9D"
+  }
+}
+```
+
+## 工作流
+
+> [!CAUTION]
+> 这是**高风险写入操作（删除）** — 执行前必须明确向用户确认，告知此操作不可逆。
+
+1. 先用 `+form-list` 或 `+form-get` 确认目标表单存在
+2. 向用户展示将要删除的表单名称和 ID，等待明确确认
+3. 执行删除
+4. 报告删除结果
+
+## 提示
+
+- 删除前建议先用 `+form-questions-list` 了解表单内容，避免误删
+- `form_id` 可通过 `+form-list` 查询
+
+## 参考
+
+- [lark-base](../SKILL.md) — 多维表格全部命令
+- [lark-shared](../../lark-shared/SKILL.md) — 认证和全局参数

package/server/assets/skills/lark-tools/cli-skills/lark-base/references/lark-base-form-get.md

@@ -0,0 +1,68 @@
+# base +form-get
+
+> **前置条件：** 先阅读 [`../lark-shared/SKILL.md`](../../lark-shared/SKILL.md) 了解认证、全局参数和安全规则。
+
+获取多维表格数据表中指定表单的详情。只读操作，不修改任何数据。
+
+## 命令
+
+```bash
+# 获取表单详情
+lark-cli base +form-get \
+  --base-token <base_token> \
+  --table-id <table_id> \
+  --form-id <form_id>
+
+# 以 pretty 格式展示
+lark-cli base +form-get \
+  --base-token <base_token> \
+  --table-id <table_id> \
+  --form-id <form_id> \
+  --format pretty
+
+# 使用应用身份（bot）
+lark-cli base +form-get \
+  --base-token <base_token> \
+  --table-id <table_id> \
+  --form-id <form_id> \
+  --as bot
+```
+
+## 参数
+
+| 参数 | 必填 | 说明 |
+|------|------|------|
+| `--base-token <token>` | 是 | 多维表格 App 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 |
+| `name` | 表单名称 |
+| `description` | 表单描述 |
+
+```json
+{
+  "ok": true,
+  "data": {
+    "id": "vewX58te9D",
+    "name": "用户调研问卷",
+    "description": "2024年度用户满意度调研"
+  }
+}
+```
+
+## 提示
+
+- `form_id` 可通过 `lark-cli base +form-list --base-token <token> --table-id <id>` 获取
+
+## 参考
+
+- [lark-base](../SKILL.md) — 多维表格全部命令
+- [lark-shared](../../lark-shared/SKILL.md) — 认证和全局参数

package/server/assets/skills/lark-tools/cli-skills/lark-base/references/lark-base-form-list.md

@@ -0,0 +1,73 @@
+# base +form-list
+
+> **前置条件：** 先阅读 [`../lark-shared/SKILL.md`](../../lark-shared/SKILL.md) 了解认证、全局参数和安全规则。
+
+列出多维表格数据表中的所有表单。自动翻页，一次性返回全量结果。只读操作，不修改任何数据。
+
+## 命令
+
+```bash
+# 列出指定数据表的所有表单
+lark-cli base +form-list \
+  --base-token <base_token> \
+  --table-id <table_id>
+
+# 以表格形式展示
+lark-cli base +form-list \
+  --base-token <base_token> \
+  --table-id <table_id> \
+  --format table
+
+# 使用应用身份（bot）
+lark-cli base +form-list \
+  --base-token <base_token> \
+  --table-id <table_id> \
+  --as bot
+```
+
+## 参数
+
+| 参数 | 必填 | 说明 |
+|------|------|------|
+| `--base-token <token>` | 是 | 多维表格 App token（base_token） |
+| `--table-id <id>` | 是 | 数据表 ID |
+| `--page-size <n>` | 否 | 每次请求的分页大小，默认 100，最大 100 |
+| `--format` | 否 | 输出格式：json（默认）\| pretty \| table \| ndjson \| csv |
+| `--as` | 否 | 身份：user（默认）\| bot |
+| `--dry-run` | 否 | 预览 API 调用，不执行 |
+
+## 输出格式
+
+每条表单包含以下字段：
+
+| 字段 | 说明 |
+|------|------|
+| `id` | 表单 ID（如 `vewX58te9D`） |
+| `name` | 表单名称 |
+| `description` | 表单描述 |
+
+JSON 输出示例（`--format json`，默认）：
+
+```json
+{
+  "ok": true,
+  "data": {
+    "forms": [
+      {"id": "vewX58te9D", "name": "用户调研问卷", "description": "..."},
+      {"id": "form_yyyy",  "name": "产品反馈表",   "description": "..."}
+    ],
+    "total": 2
+  }
+}
+```
+
+## 提示
+
+- `base_token` 在多维表格 URL 中可找到（形如 `bascnXXXX`）
+- `table_id` 可通过 `lark-cli base app.tables list --app-token <token> --params '{"app_token":"<token>"}'` 获取
+- 如无表单，输出 `forms: []`
+
+## 参考
+
+- [lark-base](../SKILL.md) — 多维表格全部命令
+- [lark-shared](../../lark-shared/SKILL.md) — 认证和全局参数

package/server/assets/skills/lark-tools/cli-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>` | 是 | 多维表格 App 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"}` | type 可选：`plain`（纯文本）、`phone`（电话）、`url`（链接）、`email`（邮件）、`barcode`（扫码） |
+| `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` | `{"type":"plain","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/server/assets/skills/lark-tools/cli-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/server/assets/skills/lark-tools/cli-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>` | 是 | 多维表格 App 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) — 认证和全局参数