Yida App

触发条件

正向触发（用户意图是从零搭建完整应用）：

• "帮我搭建一个完整应用"
• "从零开始创建系统"
• "一句话生成应用"
• "帮我做一个 XXX 系统/平台/工具"

不适用场景（不要触发，改用对应子技能）：

• 只需创建应用 → yida-create-app
• 只需创建/修改表单 → yida-create-form-page
• 只需发布页面 → yida-publish-page
• 只需配置流程 → yida-process-rule 或 yida-create-process
• 只需查询/录入数据 → yida-data-management

完整开发流程

[Step 1] 创建应用 → openyida create-app          → 获得 appType
              ↓
[Step 2] 需求分析 → 写入 prd/<项目名>.md
              ↓
[Step 3] 创建自定义页面 → openyida create-page    → 获得 formUuid（自定义页面）
              ↓
[Step 4]（按需）创建/更新表单 → openyida create-form → 获得 formUuid（表单）
              ↓
[Step 5]（按需，需求含「审批」「流程」「申请」「审核」「工单」等关键词时必须执行）
          配置流程 → 读取 skills/yida-create-process/SKILL.md → openyida create-process / configure-process
              ↓
[Step 6] 编写自定义页面代码 → yida-custom-page 规范 → pages/src/<项目名>.js
              ↓  （列表/表格类页面：参考 yida-density 技能选择合适的信息密度）
              ↓
[Step 7] 发布页面 → openyida publish <源文件路径> <appType> <formUuid>
              ↓
[Step 8] 输出访问链接，用系统浏览器打开

编写自定义页面代码前必须完整学习 skills/yida-custom-page/SKILL.md

生成表单 schema 前必须完整学习 skills/yida-create-form-page/SKILL.md

使用模板文件确保一次性成功

为避免生成错误代码，必须使用各技能的模板文件：

代码生成前必须：

1. 读取对应的模板文件
2. 以模板为基础进行扩展
3. 验证所有参数名称与 CLI 一致

关键决策树

决策 1：是否需要存储数据？

用户需求
    │
    ├── 纯展示 / 静态内容 → 跳过 Step 5（无需创建表单）
    │
    └── 需要收集 / 存储数据 → Step 5 创建表单

决策 2：是否需要审批流程？

表单创建后
    │
    ├── 无审批需求 → 直接进入 Step 6 编写代码
    │
    └── 有审批需求 → 调用 yida-create-process 配置流程后再编写代码

决策 3：是否需要数据可视化报表？

应用功能需求
    │
    ├── 标准统计报表 → 调用 yida-report 创建原生报表
    │
    └── 高级 ECharts 大屏 → 先 yida-report 创建数据源，再 yida-chart 创建可视化页面

决策 4：corpId 一致性检查（创建页面前必须执行）

读取 prd 文档中的 corpId vs 读取 .cache/cookies.json 中的 corpId
    │
    ├── 一致 → 继续创建页面
    │
    └── 不一致
        │
        ├── 用户选择"重新登录" → openyida logout → 重新扫码登录到正确组织
        │
        └── 用户选择"新建应用" → 回到 Step 1（会自动覆盖 prd 配置）

步骤详解

Step 1：创建应用

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

openyida create-app "<应用名称>" "[描述]"

输出：appType（如 APP_XXXXXX），自动写入 prd 文档的应用配置表。

📖 详见 skills/yida-create-app/SKILL.md

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

深度分析用户需求，识别核心功能和隐含期望，将结果写入 prd/<项目名>.md。

prd 文档结构：

# <项目名> 需求文档

## 应用配置

| 配置项 | 值 |
|--------|-----|
| appType | APP_XXXXXX |
| corpId | dingXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX |
| baseUrl | https://www.aliwork.com |

## 功能需求

（描述页面的核心功能、交互逻辑、业务规则）

## 页面与表单配置

### 用户信息表（表单页面）

| 字段名称 | 字段类型 | 说明 |
|---------|---------|------|
| 姓名 | TextField / 单行文本 | 必填 |
| 部门 | SelectField / 下拉单选 | 必填，选项：技术部、产品部、运营部 |
| 备注 | TextareaField / 多行文本 | 选填 |

### 首页（自定义页面）

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

## UI 设计

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

⚠️ 重要约定：

• prd 文档只记录业务语义信息（字段名称、类型、说明），不记录 formUuid、fieldId 等 Schema ID
• Schema ID 统一写入 .cache/<项目名>-schema.json，供编码时读取
• 每次创建或修改表单/页面后，必须同步更新 prd 文档

Step 3：创建自定义页面

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

openyida create-page <appType> "<页面名称>"

输出：formUuid（如 FORM-XXXXXX），写入 .cache/<项目名>-schema.json。

📖 详见 skills/yida-create-page/SKILL.md

Step 4：创建表单（按需）

当页面需要收集/存储数据时，调用 yida-create-form-page 技能。

4.1 定义字段，写入 .cache/xxx-fields.json

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

4.2 创建表单

openyida create-form create <appType> "<表单名称>" .cache/xxx-fields.json

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

4.3 将 Schema ID 写入 .cache/<项目名>-schema.json

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

📖 详见 skills/yida-create-form-page/SKILL.md

Step 5：配置流程（按需）

当需求含「审批」「流程」「申请」「审核」「工单」等关键词时必须执行。

openyida create-process <appType> --formUuid <formUuid> <流程定义文件>

📖 详见 skills/yida-create-process/SKILL.md

Step 6：编写自定义页面代码

编写前必须：

1. 完整读取 skills/yida-custom-page/SKILL.md
2. 执行 openyida sample yida-custom-page custom-page-template 获取模板，再用 read_file 读取 .cache/samples/custom-page-template.js
3. 读取 prd 文档和 .cache/<项目名>-schema.json 获取所有 ID

代码文件路径：pages/src/<项目名>.js

核心规范：

• 使用 export function 导出函数（didMount、didUnmount、renderJsx 三个必须导出）
• 状态管理使用 _customState + setCustomState
• 输入框使用非受控组件（defaultValue 而非 value）
• 所有样式通过内联 style 对象定义
• 列表/表格类页面：参考 yida-density 技能选择合适的信息密度

📖 详见 skills/yida-custom-page/SKILL.md

Step 7：发布页面

调用 yida-publish-page 技能，将源码编译并部署到宜搭平台：

openyida publish <源文件路径> <appType> <formUuid>

发布流程：Babel 编译 JSX → ES5 → UglifyJS 压缩 → 调用 saveFormSchema 保存 Schema

📖 详见 skills/yida-publish-page/SKILL.md

Step 8：输出访问链接并用系统浏览器打开

访问地址格式参考文档末尾 「宜搭应用 URL 规则」 章节。

数据流转说明

各步骤产出的关键数据，是后续步骤的输入：

存储约定：

• 业务语义信息（应用名、页面名、字段名、字段类型）→ prd/<项目名>.md
• Schema ID（appType、formUuid、fieldId）→ .cache/<项目名>-schema.json

典型场景示例

场景 1：一句话生成应用（如"生日祝福小游戏"）

1. yida-create-app → 创建应用，获取 appType
2. 需求分析 → 写入 prd/birthday-game.md
3. yida-create-page → 创建自定义页面，获取 pageId
4. yida-create-form-page → 创建祝福记录表单，获取 formUuid + fieldId
5. yida-custom-page → 编写游戏页面代码
6. yida-publish-page → 发布，输出访问链接

场景 2：带审批的 CRM 系统

1. yida-create-app → 创建 CRM 应用
2. 需求分析 → 写入 prd/crm.md
3. yida-create-form-page → 创建客户信息表、跟进记录表
4. yida-create-process → 配置客户审批流程
5. yida-report → 创建销售数据报表
6. yida-create-page → 创建 CRM 首页
7. yida-custom-page → 编写首页代码（集成表单 + 报表）
8. yida-publish-page → 发布

场景 3：数据大屏（ECharts 可视化）

1. yida-create-app → 创建应用
2. yida-create-form-page → 创建数据录入表单
3. yida-report → 创建原生报表（作为 ECharts 数据源）
4. yida-chart → 创建 ECharts 自定义页面（引用原生报表数据）
5. yida-publish-page → 发布

宜搭应用 URL 规则

💡 所有地址拼接 &corpid={corpId} 后可自动切换到对应组织，建议首页加上。

删除应用（危险操作）

⚠️ 删除应用不可逆，将永久清除该应用下的所有表单、页面、数据记录，无法恢复。

执行前必须完成以下确认流程，缺一不可：

1. 向用户展示操作摘要：

   ⚠️ 即将删除应用
   应用名称：<appName>
   应用 ID：<appType>
   影响范围：该应用下的所有表单、页面、数据将被永久删除，不可恢复。
   请回复「确认删除」继续，或回复「取消」中止操作。
   

2. 等待用户明确回复（必须包含"确认"或"确认删除"等明确同意词）
3. 用户确认后才可执行删除命令

若用户未明确确认，或回复模糊（如"好的"、"嗯"、"可以"），必须再次询问确认，不得执行删除。

异常处理