openyida 2026.9.2 → 2026.9.3

package/yida-skills/skills/yida-prd/references/app/blueprint.md

@@ -0,0 +1,73 @@
+# 应用结构字段
+
+用于单个页面需要感知完整应用时，承接 `yida-prd` 的产品输出。
+
+## 必填字段
+
+| 字段 | 说明 |
+| --- | --- |
+| `appName` | 应用名 |
+| `entry` | 首页或入口页 |
+| `shell` | `side_nav/top_nav/l_shaped/fullbleed-screen/split-pane/single_page` |
+| `roles` | 用户角色 |
+| `navigationGroups` | 导航分组和页面列表 |
+| `pages` | 页面清单，含 `name/scene/targetRole/purpose/blocks/entryMode` |
+| `resourceBlueprint` | 页面、普通表单、流程表单、报表等资源清单 |
+
+## 使用规则
+
+- 页面 PRD 章节只引用与当前页有关的应用结构信息，不展开整个应用 PRD。
+- 多页面应用的首页不一定是工作台：外部传播可用 landing，管理决策可用 dashboard，投屏可用 screen。
+
+导航字段按下表写，不能混用：
+
+| 需求 | 字段 | 后续技能/命令 |
+| --- | --- | --- |
+| 常规应用导航、导航分组、页面排序 | `navigationGroups` | `yida-nav-group` |
+| 自定义页自绘应用级顶部/侧边/导航壳 | `hideAppNav='y'` | `yida-nav-shell` + `openyida update-app <appType> --hide-app-nav` |
+| 页面隐藏导航、无导航、`isRenderNav=false` | 页面级隐藏配置 | `yida-page-config` / `update-form-config` |
+
+默认导航可见并优先与宜搭运行态融合；普通页面内 tab、分段筛选和快捷入口不隐藏平台导航。用户只要求页面隐藏导航、无导航或 `isRenderNav=false` 时，记录页面级隐藏配置，不自动写 `hideAppNav`。
+
+`entryMode` 只允许 `platform-shell` 或 `standalone`。页面自身具备完整导航壳，或不依赖工作台导航即可完成主要业务闭环时才使用 `standalone`；普通工作台、看板、tab 或仍依赖平台导航的页面使用 `platform-shell`。信息不足时默认 `platform-shell`。
+
+## resourceBlueprint
+
+`resourceBlueprint` 对齐 `yida-app` 的页面与表单设计，描述“应该有什么资源”，运行后 ID 由实现阶段记录。
+
+```json
+{
+  "pages": [
+    {
+      "name": "经营工作台",
+      "resourceType": "display-page",
+      "scene": "workbench",
+      "entryMode": "platform-shell",
+      "isMain": true,
+      "purpose": "应用第一入口、今日概览、快捷入口"
+    }
+  ],
+  "forms": [
+    {
+      "name": "商品管理",
+      "formKind": "normal-form",
+      "purpose": "维护商品基础资料",
+      "fields": ["商品名称", "商品分类", "售价", "商品状态"]
+    },
+    {
+      "name": "采购审批",
+      "formKind": "process-form",
+      "purpose": "采购申请与审批流转",
+      "process": ["发起", "主管审批", "采购执行"]
+    }
+  ],
+  "reports": [
+    {
+      "name": "销售趋势报表",
+      "purpose": "汇总订单金额和销量趋势"
+    }
+  ]
+}
+```
+
+字段写业务名、字段类型、必填、默认值、Divider 分组等语义；真实 `formUuid`、`fieldId`、`processCode` 由实现阶段创建后写入 `.cache/<项目名>-schema.json`。

package/yida-skills/skills/yida-prd/references/app/navigation-patterns.md

@@ -0,0 +1,43 @@
+# 导航模式
+
+## 快速判断
+
+| 需求 | 使用模式 | 要不要隐藏应用导航 | 备注 |
+| --- | --- | --- | --- |
+| 常规业务系统、多页面后台 | 平台导航 | 不隐藏 | 用 `yida-nav-group` 管导航分组和顺序 |
+| 自定义页自绘应用级顶部/侧边/导航壳 | 页面内导航壳 | 隐藏 | 设置 `hideAppNav='y'`，再用 `yida-nav-shell` |
+| 页面内 tab、分段、局部切换 | 混合导航 | 不隐藏 | 这是当前页面内部结构 |
+| 页面全屏、无导航、`isRenderNav=false` | 页面级隐藏 | 不一定 | 不等同于隐藏应用导航 |
+
+## 平台导航
+
+适合常规中后台、多页面业务系统。优先使用宜搭左侧导航分组，页面内容保持与平台主题融合。
+
+规则：
+
+- 门面页靠前，配置/录入类页面靠后。
+- 同一角色的高频页面放同组。
+- 同应用内页面优先在平台应用导航内切换；不要把一组同应用页面复制成自定义页里的快捷入口卡。
+- 看板、工作台、列表、详情不要无序混排。
+
+## 页面内导航壳
+
+适合应用导航已隐藏，且自定义页需要自己承担应用级入口的场景。
+
+规则：
+
+- 默认不要在自定义页里自建同级导航。
+- 只有明确要顶部导航、侧边导航、导航壳、自绘应用级导航或隐藏应用导航时才使用。
+- 自绘应用级导航前必须开启 `hideAppNav`；不要用 `isRenderNav=false` 表达应用导航隐藏。
+- 顶部导航适合官网/门户；侧边导航适合复杂后台；浮动胶囊适合沉浸展示。
+- 页面内导航只负责当前沉浸体验，不替代平台真实导航管理。
+
+## 混合导航
+
+适合复杂应用：平台导航承载模块，页面内 tab 承载同页子视图。
+
+规则：
+
+- 平台层做跨模块跳转。
+- 页面层做当前模块内切换。
+- 不同时出现两套同级导航。

package/yida-skills/skills/yida-prd/references/app/role-journey.md

@@ -0,0 +1,30 @@
+# 角色旅程
+
+应用级体验要先回答“谁进来做什么”。
+
+## 角色卡
+
+```markdown
+- 角色：经销商
+- 第一入口：经销商数据看板
+- 高频任务：查看 GMV / 补货风险 / 活动转化 / 巡店建议
+- 需要页面：dashboard + list + detail
+- 不需要页面：内部配置表单直接暴露在首屏
+```
+
+## 页面映射
+
+| 角色需求 | 页面类型 |
+| --- | --- |
+| 了解品牌价值 | landing |
+| 处理待办和入口 | workbench |
+| 判断业务健康 | dashboard |
+| 监控态势 | screen |
+| 找对象和批处理 | list |
+| 看单个对象全貌 | detail |
+
+## 验收
+
+- 每个核心角色至少有一个明确入口。
+- 页面命名体现角色任务，不用泛化标题。
+- 不为所有角色展示同一套入口密度。

package/yida-skills/skills/yida-prd/workflow/output-prd.md

@@ -0,0 +1,188 @@
+# 输出：prd.md
+
+> 本文件定义完整应用的 `prd/<项目名>/prd.md` 输出格式。`prd.md` 记录业务语义、产品设计、页面结构、资源创建顺序、页面实现交付顺序和导航顺序。PRD 不写 UI 视觉设计规范，只写应用主题色和风格摘要，并引用 `design.md` 章节。
+
+## PRD 输出格式
+
+```markdown
+# <应用名> PRD
+
+## 1. 应用基本信息
+
+| 项目 | 内容 |
+| --- | --- |
+| 应用名称 | <业务名称> |
+| 应用类型 | <企业管理 / 经营分析 / 流程审批 / 数据采集 / 客户服务 / 库存进销存 / 项目协作 / 资产设备 / 教育培训 / 知识内容 / 监控指挥 / 官网门户 / 活动报名 / 轻量工具> |
+| 业务目标 | <一句话说明这个应用解决什么问题> |
+| 核心用户 | <角色 1 / 角色 2 / 管理员等> |
+| 使用场景 | <PC 办公 / 移动录入 / 大屏查看 / 外部官网等> |
+| 核心对象 | <客户 / 订单 / 商品 / 工单 / 审批单等> |
+| 主题色 | <当前应用主题色 / 用户指定品牌色 / 待创建后回填；写清色值或主题 key> |
+| 权限口径 | <谁能看、谁能填、谁能审批、谁能管理> |
+
+## 2. 应用配置
+
+| 配置项 | 值 |
+| --- | --- |
+| appType | <已有应用填真实 appType；从零创建时写“待创建后回填”> |
+| corpId | <目标组织 corpId；未知时写“待登录态确认”> |
+| baseUrl | <平台地址，如 https://www.aliwork.com 或私有化域名> |
+| 是否隐藏平台导航 | <否 / 是；默认否。仅自绘应用级导航或用户明确要求隐藏时写“是”，并配置 `hideAppNav='y'`；`isRenderNav=false` 只隐藏当前页面导航> |
+
+## 3. 数据结构（业务语义，不含细节 ID）
+
+### <表单 / 数据对象名称>
+
+| 字段名 | 字段类型 | 必填 | 默认值 / 选项 | 关联关系 | 分组 | 说明 |
+| --- | --- | --- | --- | --- | --- | --- |
+| <字段> | <文本 / 数字 / 日期 / 单选 / 多选 / 子表单 / 关联表> | <是/否> | <默认值或选项> | <关联对象> | <基础信息 / 状态 / 明细> | <业务说明> |
+
+### 初始示例数据计划
+
+完整应用默认在表单创建后、页面实现前，为核心业务普通表单写入 1-3 条业务化示例记录。这里写业务语义，真实 fieldId 由实现阶段通过 `openyida get-schema` 回填。
+
+| 表单 | 默认写入数量 | 示例记录语义 | 是否允许跳过 | 跳过条件 |
+| --- | --- | --- | --- | --- |
+| <核心业务表单> | <1-3> | <记录 1：关键字段和值；记录 2：关键字段和值；记录 3：关键字段和值> | <否 / 是> | <用户明确不要造数 / 配置字典表 / 敏感数据 / 字段缺少可安全构造值> |
+
+要求：示例记录必须贴合当前业务，不写“测试1/测试2”；日期字段在实现阶段必须转成 13 位毫秒时间戳；普通表单逐条 `openyida data create form` 写入并 query 抽查。流程表单只有 processCode 已确认且页面需要流程实例时才发起。
+
+流程表单需要补充：
+
+| 节点 | 处理人 | 流转条件 | 表单动作 |
+| --- | --- | --- | --- |
+| 提交 | <角色> | <条件> | <填写/校验> |
+
+## 4. 页面与功能设计
+
+### <页面名>
+
+- 页面类型：<display-page / form-page / process-form / report / detail-entry>
+- 页面定位：<主入口页面 / 核心业务页 / 详情页 / 报表页 / 配置页；说明为什么需要这个页面>
+- 入口模式：<`platform-shell` / `standalone`；信息不足时必须写 `platform-shell`>
+- 页面目标：<这个页面帮助用户完成什么判断或操作>
+- 页面关系：<从哪里进入、下一步去列表 / 看板 / 表单提交 / 详情 / 报表中的哪一个>
+- 设计文件：<display-page 填 `prd/<项目名>/design.md`；普通表单 / 流程表单填写表单结构与填写路径引导>
+- 设计引用：<引用 design.md 中的章节 ID，例如 themeProfile、sceneRecipes.workbench、components.table、states.empty>
+- 风格理由：<一句话说明该页面为什么采用 design.md 中的对应场景规则>
+- 主题关系：<跟随当前应用主题 / 平台预置主题 / 应用自定义主题文件；只写摘要，具体 token 与 UI 规则见 design.md>
+- 关联资源：
+  - 表单：<表单名称；用于新增、编辑、查询或作为列表数据来源>
+  - 流程：<流程名称；用于提交、审批、处理或状态流转>
+  - 报表 / 数据源：<报表或数据来源；用于指标、图表或大屏>
+  - 详情页：<原生 formDetail / 自定义详情页 / 抽屉详情>
+- 需要设计的区块：
+  - <区块名称>：<区块目的；数据来源；主操作；状态>
+  - 工作台、首页、门户、看板、展示页和业务入口页推荐逐条列出 8-10 个 `contentBlocks` 以上，但这不是硬门槛。KPI 组、快捷入口组、列表组各只算 1 个区块，不能用子项或列表行凑数；窄场景可以更少，并说明取舍理由。
+  - 自定义页面需要逐个写清首屏、筛选、列表/卡片、图表、表单入口、详情抽屉、空态等区块。
+- 布局骨架：<顶部概览 / 筛选区 / 表格 / 卡片列表 / 图表区 / 右侧详情等>
+- 核心组件：<KPI / 快捷入口 / 表格 / 图表 / 表单入口 / 状态标签等>
+- 主操作：<新增 / 提交 / 查看 / 审批 / 编辑 / 跳转>
+- PC / 移动端差异：<PC 抽屉 / 移动端整页 / 卡片堆叠 / 隐藏低频列>
+- pageSpecHandoff：
+  - pageStructure：<workbench / dashboard-overview / business-list / detail-profile / split-pane-detail / portal-shell-home / official-homepage / data-screen>
+  - scene：<workbench / dashboard / list / detail / landing / screen>
+  - entryMode：<platform-shell / standalone>
+  - contentBlocks：<推荐列出 8-10 个业务区块以上；KPI/快捷入口/列表/图表子项不分别计数>
+  - themeSummary：<应用主题色 / 风格关键词 / 主题交付方式摘要；必须与 design.md 一致，不写 token 和视觉规则>
+  - designFile：<prd/<项目名>/design.md>
+  - designRefs：<themeProfile / sceneRecipes.<scene> / components.<name> / states.<name>>
+  - 引用规则以 [yida-design 的 join 稳定引用契约](../../yida-design/workflow/output-design.md#join-稳定引用契约) 为准；`sceneRecipes.<sceneKey>` 中的 `sceneKey` 必须逐字取自共享 `requirement-brief.json` 的对应 `pageScenes`（对象项使用其 `key`，字符串项原样使用），不得改写、翻译或重新生成。
+  - dataBinding：<form / report / connector / static-empty；真实资源 ID 由实现阶段回填>
+  - primaryAction：<主操作和打开方式>
+
+`entryMode=standalone` 只用于页面自身已经具备完整导航壳，或不依赖宜搭工作台导航即可完成主要业务闭环的员工自助/轻量业务入口。页面只有 tab、筛选、分段、卡片切换、普通看板，或仍依赖平台导航进入核心表单/流程时必须使用 `platform-shell`。不得根据访问者角色猜测；证据不足时默认 `platform-shell`。
+
+## 5. 应用主题与风格摘要
+
+| 项目 | 内容 |
+| --- | --- |
+| 设计文件 | `prd/<项目名>/design.md` |
+| 应用主题色 | <平台预置 key 或自定义色盘名称；必须与 design.md 的 Theme Profile 一致> |
+| 风格摘要 | <2-3 个业务风格关键词，例如高效协同、稳重可信、经营洞察；完整 UI 设计见 design.md> |
+| 主题交付 | <平台预置 / 应用自定义主题文件 / 继承当前应用；具体 themeProfile、token、主题文件交付策略见 design.md> |
+| 明暗模式 | <light 默认；dark 只在明确暗色/夜间/高对比/黑金时使用；具体色阶见 design.md> |
+| 页面设计引用 | <逐页列出 designRefs，不复制 design.md 内容> |
+| 素材策略摘要 | <官网/品牌页是否需要真实图片或生成图片；具体视觉表达见 design.md> |
+| 一致性要求 | <PRD 中主题色和风格摘要必须与 design.md 保持一致；冲突时以 design.md 为准并修正 PRD 摘要> |
+
+## 6. 业务逻辑与交互状态
+
+| 类型 | 规则 |
+| --- | --- |
+| 表单提交后 | <刷新列表 / 回到当前工作台 / 触发流程 / 更新状态> |
+| 新增/提交入口 | <PC 侧边抽屉 iframe 承载页面级隐藏导航的 `submission/{formUuid}?isRenderNav=false`，抽屉默认半屏 `50vw`；移动端整页或新页打开；必要时用 `update-form-config` 持久化表单设置 `isRenderNav=false`> |
+| 详情查看 | <PC 侧边抽屉 iframe 承载页面级隐藏导航的 `formDetail/{formUuid}?formInstId={formInstId}&navConfig.layout=1180&isRenderNav=false`，抽屉默认半屏 `50vw`；移动端整页或新页打开；formInstId 来自真实数据记录并优先取 row.formInstId，缺失时禁用详情入口> |
+| 数据变更 | <自动计算、状态流转、通知或提醒> |
+| 权限规则 | <角色能看、能改、能审批的边界> |
+| 空状态 | <无数据时的说明、主操作入口和下一步> |
+| 加载状态 | <骨架屏 / 表格 loading / 图表 loading> |
+| 错误状态 | <错误提示、重试、回退入口> |
+
+## 7. 资源蓝图
+
+| 资源 | 类型 | 用途 | 关键字段 / 功能 | 创建策略 |
+| --- | --- | --- | --- | --- |
+| <主页面> | display-page / main | <入口和概览> | <contentBlocks：推荐 8-10 个区块以上，如标题上下文、筛选、摘要、主操作、待办、最近记录、动态、提醒、右侧上下文、空态行动等；不作为硬门槛> | <复用 / 创建> |
+| <业务表单> | normal-form | <数据录入和列表管理> | <核心字段> | <复用 / 创建 / 更新> |
+| <审批表单> | process-form | <流程闭环> | <节点和条件> | <复用 / 创建 / 更新> |
+| <报表> | report | <汇总分析> | <指标口径> | <复用 / 创建 / 更新> |
+
+默认不创建自定义列表页；用户明确要求时才新增 `display-page / list`。
+
+## 8. 资源创建顺序
+
+资源创建顺序服务于依赖关系；表单/流程在自定义页面之前创建，便于页面消费表单 URL、字段语义和数据来源。
+
+| 顺序 | 资源 | 依赖原因 | 创建后记录 |
+| --- | --- | --- | --- |
+| 1 | 应用 | 承载所有页面、表单、流程和导航 | `appType` |
+| 2 | 普通表单 / 流程表单 | 自定义页面需要表单 URL、字段语义和数据来源 | `formUuid`、字段映射 |
+| 3 | 应用主题与导航配置 | 在应用级统一配置主题，并明确是否隐藏平台导航 | `themeFile`、`themeColor`、`navTheme`、`logoSource`、`layoutDirection`、`hideAppNav` |
+| 4 | 初始示例数据 | 页面需要读取真实表单记录，完整应用默认写入 1-3 条核心业务记录 | 写入数量、抽查结果 |
+| 5 | 主自定义页面 / 业务自定义页面 | 页面消费表单入口和表单数据 | `displayPageFormUuid` |
+| 6 | 报表 / 数据看板数据源 | 看板或大屏需要汇总指标时创建 | `reportId` 或数据源信息 |
+| 7 | 发布与导航排序 | 页面发布成功后再调整导航展示 | 发布 URL、导航状态 |
+
+## 9. 页面实现交付顺序
+
+页面实现交付顺序是页面开发和验收顺序，不等同于资源创建顺序，也不等同于导航顺序。
+
+| 顺序 | 页面 | 实现重点 | 依赖资源 | 验收点 |
+| --- | --- | --- | --- | --- |
+| 1 | <主页面 / 工作台 / 官网首页> | <首屏、核心入口、主题风格> | <表单入口 / 空态 / 指标口径> | <打开后能完成核心判断> |
+| 2 | <数据管理入口> | <默认使用表单数据管理页；用户要求时实现自定义列表> | <核心业务表单> | <可新增或查看详情> |
+| 3 | <详情 / 看板 / 大屏> | <对象叙事、图表、状态、洞察> | <表单数据 / 报表> | <能解释业务状态> |
+| 4 | <辅助页面> | <配置、说明、低频入口> | <相关表单或链接> | <不阻断主链路> |
+
+## 10. 导航顺序
+
+导航顺序是用户在平台导航中看到的顺序，按业务入口和使用频率排列。
+
+| 分组 | 页面顺序 | 导航呈现 | 放置原则 |
+| --- | --- | --- | --- |
+| 门户 / 首页 | <主页面 / 工作台 / 官网首页> | <平台导航 / 顶部导航 / 侧边导航 / 单页入口> | 第一入口放最前 |
+| 业务办理 | <流程表单 / 新增入口 / 待办相关页面> | <平台导航或页面内快捷入口> | 高频动作靠前 |
+| 数据管理 | <表单数据管理页 / 用户要求的自定义列表页 / 详情页> | <平台导航分组> | 数据录入、查询和维护集中 |
+| 经营分析 | <看板 / 报表 / 大屏> | <平台导航 / 大屏全屏入口 / 页面级隐藏导航 isRenderNav=false> | 管理者查看，放在业务操作之后或独立分组 |
+| 系统配置 | <配置表 / 字典表 / 权限说明> | <平台导航靠后分组> | 低频维护靠后 |
+
+## 11. 验收标准
+
+| 场景 | 验收标准 |
+| --- | --- |
+| 主页面访问 | <页面发布成功，打开后首屏能完成核心判断> |
+| 数据录入 | <表单能提交，提交后页面能刷新或回到正确入口> |
+| 主题配置与页面消费 | <应用主题文件已配置，自定义页面已消费对应主题变量> |
+| 初始示例数据 | <完整应用默认已为核心普通表单写入 1-3 条业务化示例记录并 query 抽查；跳过时说明原因> |
+| 数据查看 | <默认使用表单数据管理页；自定义列表 / 看板 / 详情显示真实数据或空态> |
+| 权限 / 流程 | <权限规则或流程节点生效> |
+| 视觉一致性 | <主题色、布局密度、状态、图标和当前业务一致> |
+| 导航可用 | <导航顺序符合 PRD，主入口靠前，配置/低频资源靠后> |
+```
+
+## 交给实现阶段
+
+- `yida-app` 读取 `prd/<项目名>/prd.md` 和 `prd/<项目名>/design.md` 后创建或复用资源。
+- 真实 ID 写入 `.cache/<项目名>-schema.json`。
+- 页面实现阶段读取 `prd.md` 的业务内容，并直接读取 `design.md` 的主题、布局、材质、圆角、密度、呼吸感、组件和状态规则；只有走页面生成器或需要稳定交接时才派生 `page-spec.json`，再交给 `yida-canvas-custom-page` 实现。

package/yida-skills/skills/yida-prd/workflow/step-1-read-brief.md

@@ -0,0 +1,15 @@
+# Step 1：读取共享需求简报
+
+只读取 `.cache/openyida/<项目名>/requirement-brief.json`，不重新分析一套与视觉设计不同的需求。
+
+## 检查
+
+1. 文件存在且 JSON 可解析，`schemaVersion=1`。
+2. `projectName` 与目标产物目录一致。
+3. `businessGoals`、`targetUsers`、`coreFunctions`、`businessObjects` 和 `pageScenes` 足以形成 PRD。
+4. `explicitScope` 非空时原样保留，不添加用户未要求的同级资源。
+5. `openQuestions` 中存在会改变范围的事项时，PRD artifact 保持未完成并返回编排 owner。
+
+## 产出
+
+形成 PRD 输入摘要：项目与应用类型、角色和任务、业务对象、资源上下文、明确范围、约束和验收方向。该步骤不写 `prd.md`。

package/yida-skills/skills/{yida-design/workflow/step-3-information-architecture.md → yida-prd/workflow/step-2-information-architecture.md}

@@ -1,4 +1,4 @@
-# Step 3：规划页面和导航
+# Step 2：规划页面和导航
 
 > 先画功能结构，再定页面。宜搭里优先使用平台导航、原生表单和流程能力，自定义页面负责体验入口和信息展示。
 
@@ -82,4 +82,4 @@
 
 ## 下一步
 
-→ [Step 4：页面结构和交互设计](step-4-wireframe-interaction.md)
+→ [PRD 输出格式](output-prd.md)

package/yida-skills/skills/yida-publish-page/SKILL.md

@@ -81,7 +81,7 @@ openyida publish <源文件路径> <appType> <formUuid> [--compat] [--canvas] [-
 | `--compat` / `--modern` | 否 | 兼容构建开关；仅在确认源文件属于平台 JSX 组件页面且扩展名不规范时使用；`.oyd.jsx` 默认自动启用 |
 | `--canvas` | 否 | 显式写入 `YidaCodeCanvas` Schema；`.canvas.jsx` / `.canvas.tsx` 扩展名已自动启用，仅当扩展名不规范但确认为 `YidaCodeCanvas` 组件源码时需要 |
 | `--health-check` | 否 | 发布成功后用 token 读回目标页面 Schema，校验 `YidaCodeCanvas.runtimeCode` 或平台 `Jsx + actions.module.compiled` 与本次发布内容匹配；不请求页面 HTML，不依赖 Cookie |
-| `--auto-nav-order` | 否 | 发布成功后立刻执行轻量导航排序；PRD 已写明导航顺序时优先用 `openyida nav-group order <appType> <页面/表单...>`，PRD 缺少明确页面清单时才用本参数兜底；排序失败只警告，不回滚已发布页面 |
+| `--auto-nav-order` | 否 | 仅在 PRD 缺少明确导航清单时使用；PRD 已写明顺序时不要传本参数，发布后只执行一次 `openyida nav-group order <appType> <页面/表单...>`。排序失败不回滚页面，结果保留在结构化 `navOrder` 中 |
 | `--force` | 否 | 显式绕过发布目标类型保护；只有确认目标是自定义页面但导航接口暂时无法识别时才使用 |
 
 ## 确认命令

package/yida-skills/skills/yida-requirement-analysis/SKILL.md

@@ -0,0 +1,49 @@
+---
+name: yida-requirement-analysis
+description: 分析完整应用的用户需求与现有资源，生成供 PRD 和视觉设计共同使用的结构化需求简报。
+---
+
+# yida-requirement-analysis
+
+本技能是完整应用双产物的唯一共享输入 owner。它只生成需求简报，不生成 PRD、视觉设计或页面源码。
+
+## 使用场景
+
+- 从零搭建或补齐完整应用：先运行本技能，再并行加载 `yida-prd` 与 `yida-design`。
+- 只改字段、流程、页面源码、权限或发布：使用对应单点技能，不运行本技能。
+
+## 输出
+
+写入 `.cache/openyida/<项目名>/requirement-brief.json`：
+
+| 字段 | 内容 |
+| --- | --- |
+| `schemaVersion` | 固定为 `1` |
+| `projectName` | 稳定的项目目录名 |
+| `appName` | 用户可见的应用名称候选 |
+| `industry` / `appType` | 业务领域和应用类型 |
+| `targetUsers` | 核心角色和使用场景 |
+| `businessGoals` | 要解决的问题和成功结果 |
+| `coreFunctions` | 核心功能与必要辅助功能 |
+| `businessObjects` | 客户、订单、项目、工单等核心对象 |
+| `pageScenes` | 工作台、列表、详情、看板等页面场景候选 |
+| `resourceContext` | 已确认可复用的 app/page/form/process 业务上下文，不写猜测 ID |
+| `explicitScope` | 用户明确指定的页面、表单、流程、报表、导航项和本轮范围；没有时为 `null` |
+| `brandHints` / `colorHints` | 明确的品牌、参考页面、已有主题、偏好色与避用色 |
+| `constraints` | 组织、设备、权限、交付等约束 |
+| `assumptions` / `openQuestions` | 可安全默认的事项与会改变范围的未决问题 |
+
+## 规则
+
+1. 读取用户原始需求和 Step 1 已确认的资源上下文，只记录可证实事实。
+2. 用户明确给出的资源和本轮范围原样写入 `explicitScope`，不得扩展同级页面或业务对象。
+3. 真实 `appType`、`formUuid`、`fieldId` 等 ID 只有已有证据时才可放入 `resourceContext`；不得猜测。
+4. 会改变资源范围、权限或业务对象的未知项写入 `openQuestions`，不能静默假设。
+5. 文件成功写入并通过 JSON 解析后，才允许启动两个 artifact owner。
+6. 简报进入 ready 后即冻结。后续创建出的 `appType`、`formUuid`、`fieldId` 等真实资源 ID 写入 schema 或当前任务资源上下文，不回写简报；只有用户需求或已确认资源范围发生实质变化时，才重新生成简报并重跑两个 artifact owner。
+
+## 完成条件
+
+- 共享简报存在且是合法 JSON。
+- 项目名、用户、业务目标、核心功能、业务对象、页面场景和范围信息完整。
+- 没有生成或覆盖 `prd.md`、`design.md` 和页面源码。

package/yida-skills/skills-index.json

@@ -23,8 +23,8 @@
       "name": "yida-app",
       "path": "skills/yida-app/SKILL.md",
       "display_name": "宜搭完整应用开发",
-      "description": "完整搭建或补齐普通 OpenYida 应用的流程编排技能。先解析资源上下文并消费 yida-design 的 prd.md 与 design.md，再按 PRD 创建或复用应用、表单、流程和页面；表单/流程先于自定义页面；页面阶段默认使用 Canvas 发布脚手架注入 yida/utils window 桥；发布后优先按 PRD 导航顺序排序，缺少明确页面清单时自动排序兜底；最终先输出 2-3 句业务交付总结，再给一个主入口链接。",
-      "done_when": "PRD 已写入 prd/<项目名>/prd.md，design.md 已写入 prd/<项目名>/design.md；若本轮 Write/Edit 单个页面源码，必须真实执行成功 openyida publish <source> <appType> <displayPageFormUuid> 并返回当前页面 URL；其他完整应用、表单、流程、权限、主题、导航或批量资源场景返回 {base_url}/{appType}/workbench；final 先用 2-3 句业务语言总结创建/复用了哪些表单、页面和流程，以及完成了哪些功能，再给主入口链接；不默认输出表格、长列表或资源 ID；没有 publish 证据只能声明源码已修改，尚未发布。",
+      "description": "完整搭建或补齐普通 OpenYida 应用的流程编排技能。先解析资源上下文并生成共享需求简报，再并行调用 yida-prd 与 yida-design 生成 prd.md 和 design.md；由 yida-app join 通过后按 PRD 创建或复用应用、表单、流程和页面；表单/流程先于自定义页面；页面阶段默认复制 Canvas 页面基准模板并按业务改写；发布后优先按 PRD 导航顺序排序。",
+      "done_when": "共享需求简报已就绪；yida-prd 与 yida-design 两个 artifact 均结束且 join 通过；PRD 已写入 prd/<项目名>/prd.md，design.md 已写入 prd/<项目名>/design.md；若本轮 Write/Edit 单个页面源码，必须真实执行成功 openyida publish <source> <appType> <displayPageFormUuid> 并返回当前页面 URL；其他完整应用、表单、流程、权限、主题、导航或批量资源场景返回 {base_url}/{appType}/workbench 作为应用访问入口组的固定项，仅在 standalone 且 isRenderNav=false 回读通过时增加 /custom/{formUuid}，非云端 Agent 增加 /admin；final 先用 2-3 句业务语言总结创建/复用了哪些表单、页面和流程，再给主入口链接；不默认输出表格、长列表或资源 ID，也不逐项输出内部 artifact；没有 publish 证据只能声明源码已修改，尚未发布。",
       "category": "yida-skills/app",
       "tags": [
         "宜搭",
@@ -39,17 +39,42 @@
         "管理系统搭建"
       ]
     },
+    {
+      "name": "yida-requirement-analysis",
+      "path": "skills/yida-requirement-analysis/SKILL.md",
+      "display_name": "宜搭需求简报",
+      "description": "完整应用双 artifact 的共享输入 owner。分析用户需求与已确认资源上下文，生成 .cache/openyida/<项目名>/requirement-brief.json；不生成 PRD、视觉设计或页面源码。",
+      "category": "yida-skills/design",
+      "tags": ["需求分析", "共享简报", "完整应用"],
+      "aliases": ["需求简报", "需求分析"],
+      "positive_signals": ["生成需求简报", "完整应用需求分析"],
+      "negative_signals": ["写 PRD", "视觉设计", "页面实现"],
+      "command_ids": [],
+      "done_when": ".cache/openyida/<项目名>/requirement-brief.json 已写入、可解析，且没有会改变资源范围的未决问题。"
+    },
+    {
+      "name": "yida-prd",
+      "path": "skills/yida-prd/SKILL.md",
+      "display_name": "宜搭应用 PRD",
+      "description": "完整应用 Product PRD artifact 的唯一 owner。读取共享需求简报，独立输出 prd/<项目名>/prd.md；负责业务目标、资源蓝图、页面契约、三种顺序与验收，不生成 design.md 或页面源码。",
+      "category": "yida-skills/design",
+      "tags": ["PRD", "产品设计", "资源蓝图", "页面结构"],
+      "aliases": ["应用 PRD", "产品需求文档"],
+      "positive_signals": ["写 PRD", "资源蓝图", "页面结构规划", "导航顺序"],
+      "negative_signals": ["页面美化", "视觉方向", "页面源码"],
+      "command_ids": [],
+      "done_when": "prd/<项目名>/prd.md 已写入，包含资源创建顺序、页面实现交付顺序、导航顺序、页面 handoff 和验收标准。"
+    },
     {
       "name": "yida-design",
       "path": "skills/yida-design/SKILL.md",
       "display_name": "宜搭应用设计",
-      "description": "当用户要做完整应用产品设计、单页 UI 改造、主页面视觉设计、应用主题色或全局换肤时使用。本技能基于需求分析和资源上下文，输出 prd/<项目名>/prd.md 与 prd/<项目名>/design.md；prd.md 写业务目标、数据结构、页面功能、资源顺序、导航顺序和验收标准，design.md 写主题 token、布局、材质、圆角、密度、组件和状态规则。本技能不写页面源码；页面实现交给 yida-canvas-custom-page。",
+      "description": "完整应用 Visual Design artifact 的唯一 owner，也用于单页 UI 改造、主页面视觉设计、应用主题色或全局换肤。读取共享需求简报，独立输出 prd/<项目名>/design.md；PRD 由 yida-prd 并行生成。本技能不写 PRD 或页面源码。",
       "category": "yida-skills/design",
       "tags": [
         "应用设计",
         "ui_skill",
-        "产品设计",
-        "页面结构",
+        "视觉设计",
         "页面视觉",
         "主题",
         "去 AI 味"
@@ -72,8 +97,6 @@
         "去 AI 味",
         "高级感",
         "品牌化",
-        "页面结构规划",
-        "导航分组",
         "应用主题色",
         "全局换肤"
       ],
@@ -84,7 +107,7 @@
         "数据记录操作"
       ],
       "command_ids": [],
-      "done_when": "输出 prd/<项目名>/prd.md 与 prd/<项目名>/design.md；PRD 写清资源创建顺序、页面实现交付顺序、导航顺序和验收标准，design.md 写清所有页面共同遵守的视觉系统；只有走页面生成器或需要稳定交接时才派生 page-spec.json。"
+      "done_when": "输出 prd/<项目名>/design.md，写清所有页面共同遵守的主题 token、视觉 DNA、布局、材质、圆角、密度、组件、状态和响应式规则；不写 prd.md；只有走页面生成器或需要稳定交接时才派生 page-spec.json。"
     },
     {
       "name": "yida-app-permission",
@@ -247,7 +270,7 @@
         "React18",
         "runtimeCode",
         "自定义页面",
-        "Canvas 脚手架桥"
+        "Canvas 运行桥"
       ],
       "aliases": [
         "YidaCodeCanvas",
@@ -446,7 +469,7 @@
       "name": "yida-create-app",
       "path": "skills/yida-create-app/SKILL.md",
       "display_name": "创建宜搭应用",
-      "description": "仅在没有目标 app 且允许创建时创建宜搭应用并返回 appType。创建成功后把 appType 交给 yida-design 生成或更新 PRD，再继续表单、流程、页面和发布。",
+      "description": "仅在没有目标 app 且允许创建时创建宜搭应用并返回 appType。完整搭建已完成 artifact join 时，将真实 appType 写入 schema 或任务资源上下文，不回写已冻结的共享需求简报。",
       "category": "yida-skills/app",
       "tags": [
         "创建应用",
@@ -727,26 +750,6 @@
         "taskUuid 转 PRD"
       ]
     },
-    {
-      "name": "yida-form-detail",
-      "path": "skills/yida-form-detail/SKILL.md",
-      "display_name": "表单详情页美化",
-      "description": "表单页视觉引导与表单详情页 formDetail 样式优化。默认只合并 Divider 语义分组；运行容器在表单、详情页和表单 iframe 中加载同一应用级自定义主题 CSS。",
-      "category": "yida-skills/form",
-      "tags": [
-        "表单视觉引导",
-        "详情页",
-        "Divider",
-        "formDetail",
-        "CSS",
-        "表单 JS"
-      ],
-      "aliases": [
-        "详情页样式",
-        "表单视觉"
-      ],
-      "command_ids": []
-    },
     {
       "name": "yida-form-permission",
       "path": "skills/yida-form-permission/SKILL.md",
@@ -1252,16 +1255,14 @@
     {
       "name": "yida-skills/form",
       "display_name": "表单与数据采集",
-      "description": "表单字段结构、表单视觉引导、Divider 分割线分组、字段公式/校验、业务关联规则、表单详情页、自定义页面表格批量录入和表单/流程数据记录管理。",
+      "description": "表单字段结构、Divider 分割线分组、字段公式/校验、业务关联规则、自定义页面表格批量录入和表单/流程数据记录管理。",
       "signals": [
         "创建表单",
         "新增字段",
-        "表单视觉",
         "Divider",
         "公式",
         "校验",
         "业务关联规则",
-        "详情页美化",
         "批量录入",
         "数据查询",
         "造数"
@@ -1285,11 +1286,11 @@
     {
       "name": "yida-skills/page",
       "display_name": "自定义页面",
-      "description": "自定义展示页创建、自定义页面开发、Canvas 脚手架桥、平台 JSX 组件页面维护、真实数据绑定、YidaCodeCanvas 迁移、页面发布、防覆盖、页面内导航壳和 PPT 页面。",
+      "description": "自定义展示页创建、自定义页面开发、Canvas 运行桥、平台 JSX 组件页面维护、真实数据绑定、YidaCodeCanvas 迁移、页面发布、防覆盖、页面内导航壳和 PPT 页面。",
       "signals": [
         "自定义页面",
         "YidaCodeCanvas",
-        "Canvas 脚手架桥",
+        "Canvas 运行桥",
         "window.__OPENYIDA_UTILS__",
         "JSX",
         "React",

package/yida-skills/skills/yida-design/workflow/step-1-positioning.md

@@ -1,58 +0,0 @@
-# Step 1：分析需求和资源
-
-> 先明确这是一个什么宜搭应用、服务谁、解决什么核心任务。设计从业务对象出发，不从固定截图出发。
-
-## 判断应用类型
-
-| 类型 | 典型页面 | 设计重点 |
-| --- | --- | --- |
-| 企业管理类 | 工作台、列表、详情、流程表单、配置页 | 信息密度、操作效率、状态可见 |
-| 经营分析类 | 看板、排行、趋势、预警、明细下钻 | 指标口径、图表层级、异常提醒 |
-| 流程审批类 | 申请表、审批表、待办页、流程详情 | 填写路径、节点状态、处理动作 |
-| 数据采集类 | 移动录入表单、扫码登记、批量导入、提交结果页 | 快速录入、校验反馈、弱网可读 |
-| 客户服务类 | 客户列表、工单池、服务记录、回访表 | 客户上下文、处理优先级、跟进记录 |
-| 库存进销存类 | 商品管理、订单管理、库存预警、出入库明细 | 库存水位、状态流转、明细追踪 |
-| 项目协作类 | 项目看板、任务列表、里程碑、日报周报 | 进度透明、责任人、风险提醒 |
-| 资产设备类 | 设备台账、巡检记录、维修工单、资产详情 | 设备状态、位置、责任人、维修历史 |
-| 教育培训类 | 课程首页、报名表、学习记录、证书管理 | 报名转化、学习进度、结果查看 |
-| 知识内容类 | 知识库、公告、制度文档、问答入口 | 分类导航、搜索、阅读层级 |
-| 监控指挥类 | 数据大屏、告警列表、处置工作台 | 实时态势、风险层级、投屏可读性 |
-| 官网门户类 | 官网、落地页、案例、线索表单 | 首屏主张、真实素材、信任背书 |
-| 活动报名类 | 活动首页、报名表、名单管理、签到页 | 活动信息、报名入口、名单状态 |
-| 轻量工具类 | 计算器、查询页、配置工具、导入导出页 | 单任务效率、输入输出清晰、错误提示 |
-
-## 梳理用户与任务
-
-- 核心用户：角色、职业/部门、使用场景、痛点。
-- 核心功能：1-3 个最关键功能，先保证主链路可用。
-- 业务对象：客户、订单、项目、工单、商品、门店、设备、合同等。
-- 宜搭资源：需要哪些原生表单、流程表单、自定义页面、报表或权限。
-- 参考对象：有竞品/参考案例时，只提炼布局、交互、风格和优缺点，不照搬。
-
-## 列资源蓝图
-
-完整应用设计要先把“需要什么资源”说清楚，再进入视觉细化。资源蓝图使用业务语义，运行后 ID 由实现阶段记录。
-
-| 资源 | 设计口径 | 例子 |
-| --- | --- | --- |
-| 主页面 / 首页 | display 自定义页面，承担应用第一入口 | 经营工作台、CRM 首页、项目驾驶舱 |
-| 业务页面 | display 自定义页面，承担看板、列表、详情、官网或大屏 | 订单看板、客户列表、商品详情、品牌官网 |
-| 普通表单 | 原生表单，承担数据录入、编辑、校验和列表数据来源 | 商品管理、客户信息、订单管理 |
-| 流程表单 | 原生流程表单，承担审批、流转、节点处理 | 请假申请、采购审批、工单处理 |
-| 报表 | 原生报表或图表能力，承担汇总分析 | 销售报表、库存预警报表 |
-
-## 产出
-
-```markdown
-- 应用/页面类型：<企业管理/经营分析/流程审批/数据采集/客户服务/库存进销存/项目协作/资产设备/教育培训/知识内容/监控指挥/官网门户/活动报名/轻量工具>
-- 核心用户：<角色 + 使用场景>
-- 核心任务：<1-3 个>
-- 业务对象：<主要对象>
-- resourceBlueprint：<主页面、业务页面、普通表单、流程表单、报表；字段只写业务语义>
-- 设计范围：<完整应用 / 单页 / 主题色和 token>
-- 参考启发：<可选，转成具体设计变量>
-```
-
-## 下一步
-
-→ [Step 2：选择主题色和 token](step-2-theme-system.md)