yida-app

宜搭完整应用开发技能

概述

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

何时使用

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

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

使用示例

示例 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/<name>.js）
    ↓
自动调用 yida-publish-page 技能发布代码

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

---

步骤详解

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

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

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

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

1. 读取 prd 文档中的应用配置，获取已记录的 corpId
2. 读取 .cache/cookies.json，获取当前登录态的 corpId
3. 对比两个 corpId：
   • 如果一致：继续执行创建页面
   • 如果不一致或 prd 中无 corpId：提示用户选择处理方式

corpId 不一致时的处理选项：

场景	建议操作
prd 中有 corpId，但与当前登录态不一致	询问用户：是重新登录到 prd 中的组织，还是在当前组织新建应用？
prd 中无 corpId	直接新建应用

决策流程：

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

Step 1：创建应用

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

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

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

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

---

Step 2：创建自定义页面

创建页面命令

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

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

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

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

---

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