Yida App Uiux
Designyida-app-uiuxYida 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.
宜搭多页面应用体验蓝图技能。用于从零创建完整应用、包含多个页面/角色/导航分组/门面页时,在创建页面前规划应用级信息架构、角色旅程、页面组合、导航分组、壳形态和主题策略。触发词:多页面应用、完整应用、应用整体规划、官网+看板、面向用户和经销商、应用门面、导航分组、角色路径、应用体验蓝图。
QUICK START
How to use this skill
Bring this guide into your coding agent with a prompt tailored to the tool you use.
- Open your project in Codex.
- Copy and paste the prompt below.
- Review files and risks before approving any action.
Prompt to paste
Inspect the Agent Skill at https://github.com/openyida/openyida/blob/HEAD/yida-skills/skills/yida-app-uiux/SKILL.md and all supporting files. Report provenance, permissions, scripts, dependencies, and security risks. Propose an exact installation into .agents/skills/yida-app-uiux, but wait for my approval before writing files or running scripts.
Copying this prompt does not install or run the skill. Review third-party files before use.
宜搭应用体验蓝图
核心定位
本技能在创建多个页面前使用,产出“应用级体验蓝图”。它回答的是应用如何组织,而不是某个页面如何排版。
适用输入信号:
- 从零搭建完整应用,且不止一个页面。
- 用户提到多个角色,例如消费者、经销商、运营、管理员、主管。
- 用户同时要求官网、工作台、数据看板、表单、后台配置等多种页面。
- 用户关心整体风格、导航顺序、应用首页、应用门面或宜搭应用主题风格。
输出结构
### 【应用体验蓝图】
- 应用目标:<一句话说明这个应用解决什么问题>
- 用户角色:<角色列表 + 每个角色最常进入的页面>
- 应用门面:<官网首页 / 工作台 / 经营驾驶舱 / 其他;说明原因>
- 页面组合:
- <页面名>: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>
- 数据与表单:<需要的核心表单、示例数据、看板数据来源>
- 交付顺序:<先建哪些页面,哪些表单在后>
决策规则
- 先定角色再定页面:每个核心页面都要能对应至少一个角色旅程。
- 先定门面再排导航:完整应用必须有第一入口。面向外部传播常用官网首页;内部业务系统常用工作台;管理决策系统常用经营看板。
- 平台导航优先:常规中后台应用优先使用宜搭左侧导航和分组;沉浸官网、大屏、独立分享页才考虑隐藏导航后自绘壳。
- 表单与页面分层:数据录入、审批、权限、字段结构交给原生表单/流程;自定义页面负责展示、洞察、入口、详情和胶水。
- 主题跟随运行态:用户说“宜搭应用主题风格”时默认
themeProfile.name = "yida-app-theme",不硬编码品牌色;用户明确要求全局导航/壳层一起换肤时再推断themeScope: app。 - 多页面不是平铺页面:导航分组需要体现角色路径和业务主次,不按创建顺序堆叠。
壳形态速查
| 壳形态 | 适用 | 宜搭落地 |
|---|---|---|
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 和模板消费:
{
"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”这类占位命名。
- 导航顺序能解释业务主次,门面页靠前,数据录入/配置类页面靠后。
- 官网、大屏、工作台、列表、详情等页面类型没有混用模板。
- 主题策略不把“宜搭应用主题风格”误解成固定浅色卡片。