| name | yida-create-page |
| description | 宜搭自定义页面创建技能,通过调用 saveFormSchemaInfo 接口快速创建自定义展示页面。 |
| license | MIT |
| compatibility | ["opencode","claude-code"] |
| metadata | {"audience":"developers","workflow":"yida-development","version":"1.0.0","tags":["yida","low-code","page"]} |
宜搭自定义页面创建技能
概述
本技能描述如何通过 HTTP 请求调用宜搭 saveFormSchemaInfo 接口创建自定义展示页面(display 类型)。创建后可通过 yida-publish 技能部署自定义 JSX 代码。
何时使用
当以下场景发生时使用此技能:
- 用户需要在已有应用中创建自定义展示页面
- 用户需要创建用于展示内容的主页、列表页等非表单页面
- 已通过 yida-create-app 创建应用后,需要创建第一个页面
使用示例
示例 1:基础用法
场景:在已有应用中创建一个自定义页面
命令:
node .claude/skills/yida-create-page/scripts/create-page.js "APP_XXX" "游戏主页"
输出:
{"success":true,"pageId":"FORM-XXX","pageName":"游戏主页","appType":"APP_XXX","url":"{base_url}/APP_XXX/workbench/FORM-XXX"}
使用方式
node .claude/skills/yida-create-page/scripts/create-page.js <appType> <pageName>
参数说明:
| 参数 | 必填 | 说明 |
|---|
appType | 是 | 应用 ID,如 APP_XXX |
pageName | 是 | 页面名称 |
示例:
node .claude/skills/yida-create-page/scripts/create-page.js "APP_xxx" "游戏主页"
输出:日志输出到 stderr,JSON 结果输出到 stdout:
{"success":true,"pageId":"FORM-XXX","pageName":"游戏主页","appType":"APP_XXX","url":"{base_url}/APP_XXX/workbench/FORM-XXX"}
前置依赖
- Node.js
- 项目根目录存在
.cache/cookies.json(首次运行会自动触发扫码登录)
调用流程
- 读取项目根目录的
.cache/cookies.json 获取登录态;若不存在则自动调用 login.py 触发扫码登录
- 调用
saveFormSchemaInfo 接口创建 display 类型页面;根据响应体 errorCode 自动处理异常(详见 yida-login 技能文档「错误处理机制」章节)
- 从返回值中获取页面 ID(formUuid)
- 将
pageId(formUuid)记录到 prd/<项目名>.md 的应用配置章节
文件结构
yida-create-page/
├── SKILL.md # 本文档
└── scripts/
└── create-page.js # 页面创建脚本
接口说明
saveFormSchemaInfo 接口的完整参数、返回值和错误处理机制,请参考 reference/yida-api.md 文档中的「表单设计类 API」章节。
注意:创建自定义页面时,formType 参数固定为 display(区别于表单页面的 receipt)。
与其他技能配合
- 创建应用 → 使用
yida-create-app 技能获取 appType
- 创建自定义页面 → 本技能,获取
pageId(formUuid)
- 编写 JSX 源码 → 必须先加载
yida-custom-page skill,严格按照其开发规范编写代码
- 部署页面代码 → 使用
yida-publish-page 技能将代码部署到该页面
⚠️ 重要警告:宜搭自定义页面使用类组件模式,禁止使用 React Hooks(useState/useEffect)。编写代码前必须先加载 yida-custom-page skill 查看完整的开发规范。
提示:如果需要创建的是表单页面(带字段的数据收集页),请使用 yida-create-form-page 技能。