# Yida App Uiux

> Yida App Uiux is an Agent Skill for design published in the openyida/openyida repository on GitHub: a SKILL.md instruction file an AI agent can load to do this task.

宜搭多页面应用体验蓝图技能。用于从零创建完整应用、包含多个页面/角色/导航分组/门面页时，在创建页面前规划应用级信息架构、角色旅程、页面组合、导航分组、壳形态和主题策略。触发词：多页面应用、完整应用、应用整体规划、官网+看板、面向用户和经销商、应用门面、导航分组、角色路径、应用体验蓝图。

- Skill name: `yida-app-uiux`
- Category: [Design](https://www.openparable.com/skill/design/1)
- Source: https://github.com/openyida/openyida/blob/HEAD/yida-skills/skills/yida-app-uiux/SKILL.md
- Repository: openyida/openyida (194 GitHub stars when collected)

## SKILL.md

# 宜搭应用体验蓝图

## 核心定位

本技能在创建多个页面前使用，产出“应用级体验蓝图”。它回答的是应用如何组织，而不是某个页面如何排版。

适用输入信号：

- 从零搭建完整应用，且不止一个页面。
- 用户提到多个角色，例如消费者、经销商、运营、管理员、主管。
- 用户同时要求官网、工作台、数据看板、表单、后台配置等多种页面。
- 用户关心整体风格、导航顺序、应用首页、应用门面或宜搭应用主题风格。

## 输出结构

```markdown
### 【应用体验蓝图】
- 应用目标：<一句话说明这个应用解决什么问题>
- 用户角色：<角色列表 + 每个角色最常进入的页面>
- 应用门面：<官网首页 / 工作台 / 经营驾驶舱 / 其他；说明原因>
- 页面组合：
  - <页面名>：scene=<landing/workbench/dashboard/screen/list/detail>，template=<模板名>，目标用户=<角色>
- 导航分组：<分组名 → 页面列表>
- 壳形态：<side_nav/top_nav/l_shaped/fullbleed-screen/split-pane/single_page>
- 主题策略：<themeProfile、themeScope、是否跟随 yida-app-theme>
- 数据与表单：<需要的核心表单、示例数据、看板数据来源>
- 交付顺序：<先建哪些页面，哪些表单在后>
```

## 决策规则

1. **先定角色再定页面**：每个核心页面都要能对应至少一个角色旅程。
2. **先定门面再排导航**：完整应用必须有第一入口。面向外部传播常用官网首页；内部业务系统常用工作台；管理决策系统常用经营看板。
3. **平台导航优先**：常规中后台应用优先使用宜搭左侧导航和分组；沉浸官网、大屏、独立分享页才考虑隐藏导航后自绘壳。
4. **表单与页面分层**：数据录入、审批、权限、字段结构交给原生表单/流程；自定义页面负责展示、洞察、入口、详情和胶水。
5. **主题跟随运行态**：用户说“宜搭应用主题风格”时默认 `themeProfile.name = "yida-app-theme"`，不硬编码品牌色；用户明确要求全局导航/壳层一起换肤时再推断 `themeScope: app`。
6. **多页面不是平铺页面**：导航分组需要体现角色路径和业务主次，不按创建顺序堆叠。

## 壳形态速查

| 壳形态 | 适用 | 宜搭落地 |
| --- | --- | --- |
| `side_nav` | 常规多页面中后台、经销商/运营系统 | 宜搭左侧导航分组 |
| `top_nav` | 官网、门户、少量同级频道 | 页面内顶部导航或平台导航少量同级页 |
| `l_shaped` | 复杂运营台、BI、跨模块工作区 | 平台导航分组 + 页面内 tab，或隐藏导航后混合壳 |
| `fullbleed-screen` | 投屏大屏、实时监控、指挥舱 | `isRenderNav=false` + `data-screen` |
| `split-pane` | 工单处理台、客户/订单主从详情 | 单页主从布局 |
| `single_page` | 简单应用或单主题页面 | 一个自定义页嵌入平台导航 |

## 页面组合建议

| 应用类型 | 推荐页面组合 |
| --- | --- |
| 品牌/招商应用 | 官网首页 + 案例/产品详情 + 线索表单 + 经销商看板 |
| 经营管理应用 | 工作台 + 经营看板 + 业务列表 + 详情页 + 基础配置表单 |
| 监控预警应用 | 数据大屏 + 告警列表 + 处置工作台 + 详情页 |
| 客户/订单系统 | 工作台 + 客户/订单列表 + 详情档案 + 数据看板 |
| 内部门户 | 工作台 + 入口分组 + 待办/动态 + 知识/制度列表 |

## 和 Page Spec 对齐

蓝图应写入 `appBlueprint`，供 `openyida generate-page --spec` 和模板消费：

```json
{
  "appBlueprint": {
    "appName": "奶茶渠道增长应用",
    "entry": "品牌官网首页",
    "shell": "side_nav",
    "roles": ["消费者", "经销商", "运营管理员"],
    "navigationGroups": [
      { "name": "品牌展示", "pages": ["品牌官网首页"] },
      { "name": "经销商经营", "pages": ["经销商数据看板"] },
      { "name": "后台数据", "pages": ["门店管理", "产品管理"] }
    ],
    "pages": [
      { "name": "品牌官网首页", "scene": "landing", "template": "official-homepage" },
      { "name": "经销商数据看板", "scene": "dashboard", "template": "dashboard-overview" }
    ]
  }
}
```

## 验收清单

- 至少列出用户角色、应用门面、页面组合、导航分组、壳形态和主题策略。
- 每个页面都有 scene/template/目标角色，不出现“页面 1/页面 2”这类占位命名。
- 导航顺序能解释业务主次，门面页靠前，数据录入/配置类页面靠后。
- 官网、大屏、工作台、列表、详情等页面类型没有混用模板。
- 主题策略不把“宜搭应用主题风格”误解成固定浅色卡片。

---

Source: https://www.openparable.com/skill/design/yida-app-uiux (OpenParable). Cite the canonical URL above.
