yida-create-page

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（首次运行会自动触发扫码登录）

调用流程

1. 读取项目根目录的 .cache/cookies.json 获取登录态；若不存在则自动调用 login.py 触发扫码登录
2. 调用 saveFormSchemaInfo 接口创建 display 类型页面；根据响应体 errorCode 自动处理异常（详见 yida-login 技能文档「错误处理机制」章节）
3. 从返回值中获取页面 ID（formUuid）
4. 将 pageId（formUuid）记录到 prd/<项目名>.md 的应用配置章节

文件结构

yida-create-page/
├── SKILL.md                # 本文档
└── scripts/
    └── create-page.js      # 页面创建脚本

接口说明

saveFormSchemaInfo 接口的完整参数、返回值和错误处理机制，请参考 reference/yida-api.md 文档中的「表单设计类 API」章节。

注意：创建自定义页面时，formType 参数固定为 display（区别于表单页面的 receipt）。

与其他技能配合

1. 创建应用 → 使用 yida-create-app 技能获取 appType
2. 创建自定义页面 → 本技能，获取 pageId（formUuid）
3. 编写 JSX 源码 → 必须先加载 yida-custom-page skill，严格按照其开发规范编写代码
4. 部署页面代码 → 使用 yida-publish-page 技能将代码部署到该页面

⚠️ 重要警告：宜搭自定义页面使用类组件模式，禁止使用 React Hooks（useState/useEffect）。编写代码前必须先加载 yida-custom-page skill 查看完整的开发规范。

提示：如果需要创建的是表单页面（带字段的数据收集页），请使用 yida-create-form-page 技能。