# Frontend Logic Design

> Frontend Logic Design is an Agent Skill for design published in the taichuy/1flowbase repository on GitHub: a SKILL.md instruction file an AI agent can load to do this task.

Use when 1flowbase frontend/UI structure feels illogical, unintuitive, inconsistent, hard to navigate, or has unclear information hierarchy, entry points, drill-down paths, or same-object behavior.

- Skill name: `frontend-logic-design`
- Category: [Design](https://www.openparable.com/skill/design/1)
- Source: https://github.com/taichuy/1flowbase/blob/HEAD/.agents/skills/frontend-logic-design/SKILL.md
- Repository: taichuy/1flowbase (198 GitHub stars when collected)

## SKILL.md

# 前端逻辑化设计（Frontend Logic Design）

## Overview

当前端界面让用户感到"不对劲"时，问题往往不在视觉层，而在**信息架构层**——信息的分类、层级、下钻路径和交互行为不符合用户的心智模型。

本 Skill 提供一套系统性的诊断和修正流程，基于三大核心理论：
- **MECE 原则**（互斥且穷尽）— 保证信息分类不重不漏
- **渐进式披露**（Progressive Disclosure）— 保证信息按深度递进展示
- **施耐德曼法则**（Shneiderman's Mantra）— 概览优先，缩放筛选，按需详情

## 触发场景

当用户提出以下类型的问题时，**必须**使用本 Skill：

- "这个页面感觉没有逻辑"
- "为什么有的能点有的不能点"
- "交互不一致"
- "不知道该去哪里找信息"
- "这个功能放在这里合理吗"
- "信息层级混乱"
- "导航结构不清晰"
- "用户会困惑"
- 任何涉及信息架构、导航设计、页面层级的设计讨论

## The Iron Law

```
不要在 UI 容器维度做 MECE，要在信息深度维度做 MECE。
容器（侧栏/页面/弹窗/对话）是实现手段，不是分类维度。
```

## 诊断流程

### Phase 1：识别问题类型

首先判断问题属于哪一类（可多选）：

| 问题类型 | 症状 | 根因 |
|---------|------|------|
| **分类不互斥** | 同一信息出现在多个地方，用户不知道去哪找 | 分类维度选错，存在交叉 |
| **分类不穷尽** | 有些信息/操作无处安放，被遗漏 | 分类不完整，存在盲区 |
| **深度不一致** | 有的能点有的不能点，交互行为不统一 | 缺少统一的下钻规则 |
| **层级错位** | 复杂操作放在概览层，简单信息放在深层 | 信息深度分配不合理 |
| **入口缺失** | 用户知道信息存在但找不到入口 | 渐进式披露的"暗示"不足 |

### Phase 2：信息深度审计

用四层信息深度模型审计当前页面的每一个元素：

```
L0 概览（Overview）
  用户问题："什么情况？"
  容器：卡片 / 列表摘要 / 统计数字
  规则：直接可见，无需交互
  允许的操作：一键确定性操作（审批、标记已读等）

L1 聚焦（Focus）
  用户问题："这条具体是什么？"
  容器：侧栏抽屉（Drawer）/ 展开面板
  规则：点击任意条目触发
  关键：同一页面内，所有可点击条目的行为必须一致

L2 管理（Manage）
  用户问题："让我找/改某个东西"
  容器：独立页面（Full Page）
  规则：通过"查看全部"入口进入
  特征：全量数据 + 搜索 + 筛选 + 批量操作 + CRUD

L3 执行（Execute）
  用户问题："帮我做这件事"
  容器：对话页面 / 向导流程 / 专用操作页
  规则：通过明确的行动按钮触发
  特征：需要多步骤或AI介入的复杂操作
```

**审计方法**：列出页面上的每一个交互元素，标注它属于哪个深度层。如果发现：
- 同层元素行为不一致 → 深度不一致问题
- 某层完全缺失 → 入口缺失问题
- 元素放错层 → 层级错位问题

### Phase 3：MECE 检查

对页面的信息分类进行 MECE 检验：

#### 互斥性检查（ME）

```
对于页面上的每一个数据项：
  它只属于一个分类/一个卡片/一个Tab吗？
  如果同一数据出现在多处：
    - 是否因为呈现角度不同？（允许：D01待办 和 D10今日 可以有重叠）
    - 还是因为分类维度混乱？（不允许：同一操作在两个地方都能做）
```

#### 穷尽性检查（CE）

```
列出用户对该模块的所有可能意图：
  - 能否在当前设计中找到每个意图的入口？
  - 是否存在"用户想做某事但不知道去哪"的情况？
  - 是否存在只能通过URL直接访问的"孤岛页面"？
```

### Phase 4：一致性矩阵

构建交互一致性矩阵，确保同类元素行为统一：

```markdown
| 组件/卡片 | 条目可点击?(L1) | 查看全部?(L2) | AI执行?(L3) | L0内操作 |
|----------|---------------|-------------|------------|---------|
| 卡片A    | ?             | ?           | ?          | ?       |
| 卡片B    | ?             | ?           | ?          | ?       |
| ...      |               |             |            |         |
```

规则：
- 所有列表型组件的"条目可点击"列必须全部为 ✅（或全部为 ❌）
- 同列的交互触发方式必须一致（比如都是弹出侧栏，不能有的弹侧栏有的跳页面）

### Phase 5：生成修正方案

基于诊断结果，生成修正方案。方案必须遵循：

1. **统一下钻规则**：定义清晰的 L0→L1→L2→L3 路径，所有同类组件遵循
2. **入口暗示原则**：每个被隐藏的深层功能，在上层必须有可见的入口暗示其存在
3. **容器选择决策树**：

```
需要保持当前上下文？
  ├─ 是 → 用户需要对比/参考背景数据？
  │    ├─ 是 → Drawer（侧栏抽屉）
  │    └─ 否 → Modal（弹窗）— 仅用于简单确认
  └─ 否 → 操作复杂度？
       ├─ 高（多步骤/全量数据/批量操作）→ Page（独立页面）
       └─ 低（单步操作）→ 就地完成（inline）
```

## 输出格式

诊断完成后，输出以下结构化报告：

```markdown
## 信息架构诊断报告

### 问题清单
| # | 问题类型 | 位置 | 描述 | 严重度 |
|---|---------|------|------|--------|

### 一致性矩阵（当前状态）
| 组件 | L0 | L1 | L2 | L3 |

### 修正方案
| # | 改动 | 深度层 | 涉及文件 | 说明 |

### 一致性矩阵（修正后）
| 组件 | L0 | L1 | L2 | L3 |
```

## 理论参考

详见 references/ 目录下的理论文档：
- `mece-in-frontend.md` — MECE 原则在前端设计中的应用
- `progressive-disclosure.md` — 渐进式披露的设计模式和反模式
- `container-decision-tree.md` — Modal vs Drawer vs Page 决策树

## 示例提示词

用户可能这样描述问题，你应该立即启动诊断流程：

```
"我们看板上有的卡片能点进去看详情，有的不能，感觉逻辑不一致"
→ 诊断方向：深度不一致（Phase 1 → Phase 4 一致性矩阵）

"这个功能放在看板上有意义吗？用户根本不会在这里添加任务"
→ 诊断方向：层级错位（Phase 2 信息深度审计）

"用户说找不到某个功能，但那个页面明明存在"
→ 诊断方向：入口缺失（Phase 3 穷尽性检查）

"我们有侧栏、有独立页面、有弹窗，感觉分类很乱"
→ 诊断方向：在容器维度做了 MECE（Iron Law 违反）

"帮我审查这个新模块的信息架构是否合理"
→ 完整走一遍 Phase 1-5
```

## Anti-Patterns

### 1. 在容器维度做 MECE

```
❌ 错误：侧栏放详情、页面放管理、对话放执行 → "三者互斥"
✅ 正确：L0概览 → L1聚焦 → L2管理 → L3执行 → 信息深度互斥，容器只是实现手段
```

### 2. 每个组件自己决定交互行为

```
❌ 错误：卡片A点击弹侧栏，卡片B点击跳页面，卡片C不可点击
✅ 正确：所有列表型卡片的条目点击行为一致（统一弹侧栏或统一跳页面）
```

### 3. 概览层塞入重操作

```
❌ 错误：在看板卡片里放"快速添加任务"输入框
✅ 正确：概览层只展示信息 + 一键确定性操作，创建操作放到 L2 或 L3
```

### 4. 隐藏功能无入口暗示

```
❌ 错误：存在 /tasks 页面但看板上没有任何链接指向它
✅ 正确：每个列表型卡片底部有"查看全部 →"链接
```

### 5. 深层信息越级展示

```
❌ 错误：在概览卡片里展示任务的完整描述、所有评论、历史记录
✅ 正确：概览只展示标题+状态+一句话摘要，详情在 L1 侧栏中展示
```

---

Source: https://www.openparable.com/skill/design/frontend-logic-design (OpenParable). Cite the canonical URL above.
