宜搭完整应用开发技能

概述

本技能描述如何从零到一完整搭建一个宜搭应用，涵盖从应用创建到代码发布的全流程。每个步骤均依赖对应的子技能完成。

何时使用

当以下场景发生时使用此技能：

• - 用户想要一句话生成完整的宜搭应用
• 用户需要从头开始开发一个宜搭应用
• 用户不了解宜搭开发流程，需要完整指导
• 进行完整的宜搭应用开发项目

使用示例

示例 1：一句话生成应用

1. 1. 调用 yida-create-app 创建应用
2. 需求分析，写入 prd 文档
3. 调用 yida-create-page 创建自定义页面
4. 如需存储数据，调用 yida-create-form-page 创建表单
5. 调用 yida-custom-page 编写页面代码
6. 调用 yida-publish-page 发布页面

完整开发流程

创建应用
↓
需求分析 → 创建 prd 文档（prd/<项目名>.md）
↓
创建自定义页面
↓
（如需存储数据）创建表单 → 将字段描述信息写入 prd 文档
↓
调用 yida-custom-page 技能编写页面代码（src/.js）
↓
自动调用 yida-publish-page 技能发布代码

💡 登录态说明：各脚本会自动读取项目根目录的 .cache/cookies.json。若 Cookie 不存在或已失效，脚本会报错退出，此时必须先调用 yida-login skill 完成交互式扫码登录（agent 用 browser 工具打开页面截图发给用户扫码），再重新执行后续步骤。严禁直接告知用户去自己打开浏览器扫码。

步骤详解

⚠️ 前置强制规则（必须遵守）

在开始任何宜搭应用开发前，必须先执行以下检查：

⚠️ corpId 一致性检查（关键步骤）

在执行创建页面前，必须检查 prd 文档中的 corpId 与当前登录态的 corpId 是否一致：

1. 1. 读取 prd 文档中的应用配置，获取已记录的 corpId
2. 读取 .cache/cookies.json，获取当前登录态的 corpId
3. 对比两个 corpId：

corpId 不一致时的处理选项：

决策流程：

检查 prd.corpId vs Cookie.corpId
│
├── 一致 → 继续创建页面
│
└── 不一致
│
├── 用户选择重新登录 → 执行 yida-logout → 重新扫码登录到正确组织
│
└── 用户选择新建应用 → 回到 Step 1 创建新应用（会自动覆盖 prd 配置）

Step 1：创建应用

调用 yida-create-app 技能创建宜搭应用，获取 appType。

bash
node .claude/skills/yida-create-app/scripts/create-app.js <应用名称> [描述]

输出：appType（如 APP_XXXXXX），用 markdown 记录到 prd 文件夹下文档备用。

详见 yida-create-app 技能文档。

Step 2：创建自定义页面

创建页面命令

确认 corpId 一致后，调用 yida-create-page 技能：

bash
node .claude/skills/yida-create-page/scripts/create-page.js <页面名称>

输出：pageId（如 FORM-XXXXXX），记录到 prd 文档备用。

详见 yida-create-page 技能文档。

Step 3：需求分析 → 写入 prd 文档

将分析的需求文档结果写入 prd/<项目名>.md：

prd 文档应包含以下内容：

markdown

<项目名> 需求文档

应用配置

💡 提示：

• - corpId 由 create-app.js 自动写入，用于组织一致性校验
• 如果登录态变更或创建新应用，create-app.js 会自动更新本表格

功能需求

• - 描述页面的核心功能、交互逻辑、业务规则
• 深度分析需求，并且识别核心功能 和 隐含期望，体现应用的潜在价值
• 应用RD文档需要与上述步骤紧密相关，按照步骤产出详细功能说明
• 表单字段设计需要优先满足用户指定需要的字段，再根据实际使用场景进行字段的合理扩充，以更好的满足实际场景表单对于数据的收集，发挥表单数据的价值挖掘，同时避免字段冗余
• PRD 不要包含测试、发布、推广等其他内容，不要包含 PRD 文件头、文件尾等，直接输出核心内容

页面与表单配置

（记录每个页面/表单的名称、类型和字段信息，见 Step 5）

格式示例：

用户信息表（表单页面）

首页（自定义页面）

展示用户信息列表，支持搜索和分页。

UI 设计

（描述页面风格、布局、响应式要求）

重要：

• - prd 文档只记录业务语义信息（应用名称、页面名称、页面类型、字段名称、字段类型、字段说明），不记录 formUuid、fieldId 等 Schema 中的具体 ID 值
• Schema ID（formUuid、fieldId 等）写入 .cache/<项目名>-schema.json 临时文件，供编码时读取，注意不要写在系统的其他文件夹中
• 每次创建或修改表单/自定义页面后，必须同步更新 prd 文档中对应的页面/字段信息

Step 5：创建表单（按需）

当页面需要存储数据时，调用 yida-create-form-page 技能创建表单页面。

5.1 定义字段

将字段定义写入 prd/<项目名>-pageName-field.md

json
[
{ type: TextField, label: 词语, required: true },
{ type: TextField, label: 图片地址 },
{ type: TextField, label: 用户ID },
{ type: TextField, label: 用户名 }
]

5.2 创建表单

bash
node .claude/skills/yida-create-form-page/scripts/create-form-page.js create <表单名称> .claude/skills/yida-create-form-page/scripts/fields.json

输出：formUuid 和各字段的 fieldId（如 textField_xxxxxxxx）。

5.3 将表单信息写入 prd 文档和 .cache 临时文件

写入 prd 文档（只记录业务语义信息，不记录 Schema ID）：

markdown

页面与表单配置

图片生成表（表单页面）

首页（自定义页面）

展示图片生成结果，支持关键词搜索。

写入 .cache/<项目名>-schema.json（记录 Schema ID，供编码时读取）：

json
{
appType: APP_XXXXXX,
pages: {
图片生成表: {
formUuid: FORM-XXXXXX,
fields: {
词语: textField_xxxxxxxx,
图片地址: textField_xxxxxxxx,
用户ID: textField_xxxxxxxx,