---
name: form-builder
description: 动态表单技能：向用户展示结构化输入表单，收集多字段信息（需启用 formbuilder 扩展）
---

# 表单收集

使用 `formbuilder` MCP 扩展在聊天中展示交互式表单，替代多轮逐一询问。

## 何时使用

- 需要收集 3 个以上结构化字段
- 有下拉选项、必填校验的场景
- 配置向导、信息录入、参数填写

## 前提

Settings → Extensions 中启用 **Form Builder** 扩展。

## 工具

`show_form(title, description?, fields)` — 渲染表单并等待用户提交

## 字段类型

| type | 说明 |
|------|------|
| `text` | 单行文本 |
| `number` | 数字 |
| `textarea` | 多行文本 |
| `select` | 下拉选择（需提供 `options`） |
| `checkbox` | 勾选框 |

## 规则

1. 用户提交后，结果以 JSON 回传，解析后继续任务
2. `required: true` 的字段前端会校验，不会提交空值
3. 表单不超过 8 个字段，太多拆成多步
