| name | yida-get-schema |
| description | 宜搭表单 Schema 获取技能，通过调用 getFormSchema 接口获取指定表单的完整 Schema 结构，用于分析字段定义、组件配置、确认字段 ID（fieldId）等。 |
| license | MIT |
| compatibility | ["opencode","claude-code"] |
| metadata | {"audience":"developers","workflow":"yida-development","version":"1.0.0","tags":["yida","low-code","schema","api"]} |
宜搭表单 Schema 获取技能
概述
本技能描述如何通过 getFormSchema 接口获取宜搭表单的完整 Schema 结构。获取到的 Schema 可用于分析字段定义、组件配置、学习表单结构等场景，也可用于在编码时确认字段 ID（fieldId）。
何时使用
当以下场景发生时使用此技能：
- 用户需要查看已有表单的字段结构
- 需要确认表单中各字段的 fieldId
- 在编码前需要了解表单的组件配置
- 需要分析现有表单作为参考
使用示例
示例 1：获取表单 Schema
场景：获取表单的完整 Schema 结构
命令：
node .claude/skills/yida-get-schema/scripts/get-schema.js APP_XXX FORM-XXX
输出：完整的 Schema JSON，包含 pages、componentsMap 等
使用方式
node .claude/skills/yida-get-schema/scripts/get-schema.js <appType> <formUuid>
参数说明：
| 参数 | 必填 | 说明 |
|---|
appType | 是 | 应用 ID，如 APP_XXX |
formUuid | 是 | 表单 UUID，如 FORM-XXX |
示例：
node .claude/skills/yida-get-schema/scripts/get-schema.js "APP_XXX" "FORM-XXX"
输出：日志输出到 stderr，Schema JSON 输出到 stdout。
前置依赖
- Node.js
- 项目根目录存在
.cache/cookies.json（首次运行会自动触发扫码登录）
调用流程
- 读取项目根目录的
.cache/cookies.json 获取登录态；若不存在则自动调用 login.py 触发扫码登录
- 调用
getFormSchema 接口获取表单 Schema；根据响应体 errorCode 自动处理异常（详见 yida-login 技能文档「错误处理机制」章节）
- 将 Schema 输出到 stdout
文件结构
get-schema/
├── SKILL.md # 本文档
├── getFormSchema.ts # 接口类型定义参考
└── scripts/
└── get-schema.js # Schema 获取脚本
接口说明
getFormSchema 接口的完整参数、返回值和错误处理机制，请参考 reference/yida-api.md 文档中的「表单设计类 API」章节。
与其他技能配合
- 获取已有表单 Schema → 本技能，用于确认字段 ID 或学习字段结构
- 创建表单页面 → 使用
yida-create-form-page 技能
- 部署页面代码 → 使用
yida-publish 技能
