openyida yida-app
完整应用编排技能。它负责把一次“创建/搭建/补齐应用”的需求拆成资源解析、产品设计、资源落地、页面发布和结果输出。全局 CLI、ID、存储、发布和输出规则以主入口 SKILL.md 为准；按步骤执行该步骤所需 use_skill(...)。
模式入口（先按这里路由）
Plan 模式只读取 workflow/step-1-resource-context.md、workflow/step-2-design.md 和精确路径 workflow/plan/workflow.md；后者已经包含完整 Plan 入口。禁止用 Glob 查找 Plan 文件，也不要额外读取 workflow/plan/step-1-understand.md 或 workflow/plan/step-2-confirm.md。Plan 确认恢复后，若 explicitScope.allowInferredResources=false，直接读取 workflow/step-4-forms-processes.md 实施范围内资源，不再重读 Step 1、调用 list-forms 或做应用设置预检。
步骤模版（进行时展示给用户看的步骤）
完整应用搭建时，直接使用对应模式的步骤名称。
Plan 模式
- 需求识别与分析
- 设计功能和页面
- 生成PRD方案&确认
- 创建应用
- 搭建表单与审批流
- 准备示例数据
- 搭建业务页面
- 发布页面与配置导航
- 检查功能并交付
Fast 模式
- 需求识别与分析
- 设计功能和页面
- 创建应用
- 搭建表单与审批流
- 准备示例数据
- 搭建业务页面
- 发布页面与配置导航
- 检查功能并交付
已有应用时，直接省略“创建应用”，不另列“复用现有应用”待办，后续步骤重新编号；无需示例数据时跳过对应步骤。步骤状态按真实进度更新，有独立输入的工作可同时进行。
用户明确把本轮交付限定为一个或若干具体表单、流程、报表或页面时，按 explicitScope 只保留达到该交付所需的步骤；即使需求背景使用“应用/系统”，也不自动补示例数据、自定义工作台、主题设置、导航排序或其他资源。Plan 模式仍生成并确认方案，但确认后只执行该窄范围。
若窄范围只要求创建一个普通表单并交付链接，成功的 create-form create 结果就是本轮资源回读证据：立即交付其中的真实链接并停止。不要再调用 get-schema、list-forms、数据管理技能、示例数据、主题或导航命令，除非创建结果明确缺少 ID/链接或用户另外要求这些内容。
禁区：待办标题、说明和进度不出现技能名、命令、文件路径、登录账号、内部资源 ID；这些留在工具调用里。用户明确询问技术细节时再解释。
触发条件
用户要求创建、搭建、生成一个完整宜搭应用/系统/平台/管理工具，或已有 app/page 需要补齐成完整业务系统时使用本技能。
工作流
完整应用先分析需求；首次搭建按 yida-requirement-analysis/workflow/prepare-brief.md 确认未决事项，再进入已选 Fast / Plan。两种模式共享需求分析与 PRD 契约，以下并行生成规则用于 Fast；Plan 确认当前版本后交接派生文件，直接进入 Step 3。只有 Plan 的 build-plan.html 用于方案展示，其余设计文件保持内部使用。
以下 9 步仅用于内部执行，不复制为宿主待办；用户可见的步骤名称直接使用上方“步骤模版”。每一步开始前读取对应 workflow 文件；按真实依赖满足下游输入后继续。Step 3 拿到 appType 即可启动表单创建，主题生成与设置同步作为独立分支继续，不将主题完成作为所有后续步骤的串行前置条件。无直接依赖的页面同时开发，每页只等待自身资源，独立校验并发布；全部页面完成后再统一导航排序。
| 步骤 | 名称 | 目标 | 产出 |
|---|---|---|---|
| 1 | 解析资源上下文 | 合并本轮显式资源、绑定上下文、workspace 配置/缓存和会话历史，确认复用还是允许创建 | 目标 app/page/form/process 上下文 |
| 2 | 业务与视觉设计 | 整理需求后按 Fast 并行生成，或按 Plan 生成方案并确认；校验 PRD 与视觉契约 | 内部 requirement-brief.json + prd.md + design.md |
| 3 | 创建或复用应用 | 已有 appType 直接复用；缺少 app 且允许创建时执行 use_skill("yida-create-app") |
真实目标 appType |
| 4 | 创建或更新业务资源 | 执行 use_skill("yida-create-form-page")；按 PRD 执行 use_skill("yida-create-process")、use_skill("yida-get-schema")、use_skill("yida-report") 和 use_skill("yida-integration") |
真实 formUuid、processCode、必要 fieldId/reportId |
| 5 | 写入初始表单数据 | 执行 use_skill("yida-data-management")，为核心普通表单写入 1-3 条业务化 seed records 并 query 抽查 |
真实表单记录或明确跳过原因 |
| 6 | 创建或复用主页面 | 已有 display 页面直接复用；缺少主页面且允许创建时执行 use_skill("yida-create-page") |
真实主页面 formUuid |
| 7 | 编写或更新页面 | 执行 use_skill("yida-canvas-custom-page")；看板/工作台/驾驶舱必须再执行 use_skill("yida-dashboard")，读取表单数据时必须执行 use_skill("yida-canvas-data-binding") |
页面源码和真实 dataBinding 通过校验 |
| 8 | 发布页面并排序导航 | 执行 use_skill("yida-publish-page")，发布本轮源码到主页面并执行轻量导航排序 |
已发布主页面 URL |
| 9 | 输出与收尾 | 核对完成条件，按业务语言输出结果 | 2-3 句业务总结 + 一组应用访问入口 |
独立工作按 并行执行 调度，任务分别产出，由主流程汇合。完整应用在计划或主题确认后生成主题 CSS，appType 和 CSS 就绪就同步应用设置；explicitScope.allowInferredResources=false 的资源级交付不生成或上传主题、不修改应用设置、不排序导航。
核心规则
- 资源判断以 Step 1 为准：已有 app/page/form/process 默认复用；只有用户明确从零创建，或目标缺失且本轮允许创建时，才创建缺失资源。
- 显式目标优先：本轮用户给出的
appType、formUuid、URL、页面名或流程标识，优先级高于绑定上下文和历史缓存；同级冲突或无法唯一识别时才问用户。 - 产品与视觉分工：
yida-requirement-analysis先统一整理用户需求；业务目标、资源蓝图、页面结构、导航顺序和验收标准由yida-prd写入prd.md；主题 token、布局、材质、圆角、密度、组件和状态规则由yida-design写入design.md。两份文件校验通过前不得创建资源。 - 阶段技能按需加载：进入应用壳、表单、流程、页面、发布、数据写入等阶段时，才执行对应
use_skill(...)。 - 真实 ID 和真实数据：不编造
appType、formUuid、fieldId、processCode、reportId。无显式窄范围的完整应用默认给核心普通表单写入 1-3 条业务化 seed records 并 query 抽查；explicitScope.allowInferredResources=false时不得增加未点名的 seed records 或页面。 - 自定义页面开发技能固定：完整应用页面源码按 Step 7 执行。
- 删除必须确认：用户要求删除应用时，先展示应用名称、应用 ID 和影响范围，等待明确“确认删除”后才能执行。
- 列表页选择：默认使用普通表单的数据管理页；用户明确要求自定义列表页时才创建 display 页面。
- 交付物收口：Step 2 的三个文件和 Step 9 的 build manifest 都是内部文件，不是用户交付物。表单、流程、报表和页面只在业务总结中概述，不逐项生成用户可见附件；宿主支持交付工具时，final 只交付一次“应用访问入口”组。
- 窄范围停止点：完成
explicitScope中的资源回读与真实链接交付后立即停止；不得为了满足完整应用默认完成条件继续进入被裁剪的 Step 5-8。
关键决策树
- 需要收集或存储数据：先创建或复用核心普通表单，再生成页面；纯展示或静态内容可跳过表单创建。
- 需要审批、申请、审核、工单流转：先创建或复用流程表单，再生成页面。
- 需要标准统计：优先创建原生报表；明确高级图表或大屏时，再选择
yida-rechart/yida-chart。 - 主页面语义为看板、工作台、驾驶舱或 Dashboard：必须加载
yida-dashboard；页面读取任何表单业务数据时必须继续加载yida-canvas-data-binding，不能只加载yida-canvas-custom-page。 - PRD 明确包含报表或集成自动化时，它们属于 Step 4 主流程资源，不得推迟到 final 后置建议；自动化动作必须按通知、数据新增/更新、审批完成、定时或手动触发分别建模，不得统一退化成新增通知。
页面数据契约
- 默认页面源码不得使用
this.dataSourceMap.*，除非本轮已经创建并绑定对应设计器数据源。 - 真实表单数据默认通过页面数据桥或
window.__OPENYIDA_YIDA_API__.searchFormDatas(params)读取；流程发起、流程列表、表单保存/更新等能力也通过发布层注入的同一个 yida API 桥调用；不要用前端 seedRows 冒充真实表单数据。 - 页面根级运行态工具通过
window.__OPENYIDA_UTILS__读取，toast/dialog/openPage/router.push/isMobile等工具不能在YidaComp内直接写this.utils.*。 - 表单新建/提交/详情入口统一使用
FormOpenContainer，详情页必须从真实行数据解析formInstId。 - 用户明确要求的自定义列表、看板和详情页优先读取真实表单数据；
page-spec.json写dataBinding.mode=form、真实appType/formUuid/fieldId和字段映射。表单数据管理页不另生成页面源码。 - 完整应用默认先写入 1-3 条业务化 seed records 并 query 抽查；没写入成功时，页面展示空态、表单入口、刷新或登记按钮，并在 final 说明原因。
- 若页面确实依赖
this.dataSourceMap.*，必须执行use_skill("yida-data-source-connectors")创建/绑定数据源，并在发布后确认页面 Schema 中存在对应数据源；发布输出出现No custom page data sources to preserve时，本次发布不能视为完成。
完成条件
按 Step 9：输出与收尾 核对完成条件。完整应用默认完成点除资源和发布外，还要求已知非空的数据源在主页面显示至少一个一致的 KPI 数量或业务记录；页面全 0、空列表或数据绑定未验证时不得宣称完成。只有 verdict=pass 且运行态数据证据通过时才能说“已按 PRD 完成搭建”。
参考文件
| 文档 | 覆盖范围 | 何时阅读 |
|---|---|---|
| Step 1：解析资源上下文 | 只读预检、资源优先级、命令选择、路径口径 | 必读 |
| Step 2：业务与视觉设计 | 模式选择、业务与视觉交接、主题文件交付 | 必读 |
| Step 3：创建或复用应用 | app 复用、app 创建、主题文件与导航配置 | 必读 |
| Step 4：创建或更新表单/流程 | 表单、流程、字段 ID 与表单结构规则 | 必读 |
| Step 5：写入初始表单数据 | seed records、字段类型、query 抽查、跳过条件 | 必读 |
| Step 6：创建或复用主页面 | display 页面复用、页面创建、corpId 一致性检查 | 必读 |
| Step 7：编写或更新页面 | 页面源码、page-spec、dataBinding、本地校验 | 必读 |
| Step 8：发布页面并排序导航 | publish、导航排序、发布完成证据 | 必读 |
| Step 9：输出与收尾 | final 口径、URL 规则、可选后置、错误处理 | 必读 |
| 常见问题解决思路 | 资源冲突、字段 ID、seed records、页面数据、发布失败、输出口径等高频问题 | 遇到异常或执行结果不符合预期时 |