ia · git:20261026.8d01e18 · 2026-10-26 · sha256 931c43c80b2db047

ia git:20261026.8d01e18A

Immutable. This exact content never changes and is served at /api/v1/blob/931c43c80b2db047.

No tool to install first
claude plugin marketplace add https://markdownregistry.com/mp/a/art_m3eabtuxof76k2mh/931c43c80b2db04795630ff42848ffc601cb1c3aaa1205b3e9e29cf83765b3a3.json

Then /plugin install ia@markdownregistry-m3eabtuxof76k2mh in Claude Code. It installs this exact version, the one graded A here, pinned to the commit it was graded at, and leaves it there.

---
name: ia
description: 信息架构(IA)规划与审查(skill-only):工作流正交 · 角色入口 · 分支点 · 反模式。说「信息架构」「导航迷路」「Dashboard 太乱」时用。
---

# ia · 信息架构(UX · 结构层)

**用这个**:导航迷路、角色首页、工作流分支、Dashboard 意图混杂。**不是那个**:配色/token/空态抛光 → **delivery**;类型不明 → **ux** skill 分流。

**学科位置**:**IA ⊂ UX** — 管导航、分组、角色入口、工作流分支;不管 token 配色(→ 项目设计规范 · **delivery** §1)。UX 总分流 → **ux** skill。

**普遍性原则**:`rules/execution/ia.mdc`(母版 · 跨项目)  
**项目实例文档**:`docs/design/<产品>-ia.md` 或 `docs/design/*信息架构*` / `*information-architecture*`(仓库内约定)  
**项目认知摘要**:`/learn` → `.growing/learn/`(可选)

## 何时进入

- 用户提 IA / 导航 / Dashboard / 角色入口 / 工作流分支 / onboarding 迷路
- `/plan` 含 `SPIKE-*` 导航、或 Goal 含「最短路径 / 角色体验」
- **delivery** / **review** 发现「一页多意图」「角色默认路径未对齐权限」

**不替代**:设计 token / 组件视觉规范 · **api** 契约 · 服务端 RBAC 真源

## 流程

### 1. 摸清现状(只读)

- 路由表 / 导航注册 / 默认着陆(`/`、`/dashboard`、post-login redirect)
- 权限模型(路由 guard · 按钮级 disabled)
- 是否已有 `docs/design/*ia*`
- 抱怨类型:迷路 · 拼凑 · 路径过长 · 角色交叉 · Dashboard 歧义

### 2. 划分工作流(项目定制,通常 3–5 条)

每条只回答**一个**用户问题;用**用户语言**命名,不用内部模块名。

| 示例类型 | 用户问题(换成你产品的说法) |
|----------|------------------------------|
| 观测 | 系统/业务今天状态如何? |
| 处理 | 什么待我审批/修复/回复? |
| 履约 | 这个对象下一步做到哪? |
| 治理 | 谁配置规则/集成/权限? |

电商、工单、DevOps、医疗后台等仅**映射**到上述类型,母版不固定行业名词。

### 3. 角色矩阵(逐级放权)

- **主责工作流** vs **可介入**(只读或次要)
- **默认着陆**(≠ 有权访问的全部 URL)
- **共享路由**与写操作 / 字段可见性差异
- 无角色差异的产品可跳过本步,但仍须 R1(一页一意图)

### 4. 分支点表

跨工作流只允许在**命名关口**交接。每条记录:

| 字段 | 说明 |
|------|------|
| 触发 | 用户或系统事件 |
| 从 → 到 | 工作流 / 路由 |
| 上下文 | query、实体 id、可恢复的 `from` |
| 分支 UI | 一句说明 + 单一主操作 |

示例(泛化):「待办项 → 详情履约页」「观测告警 → 处理队列」「履约完成 → 外部集成配置」。

### 5. 产出落点

| 产出 | 路径 |
|------|------|
| 讨论稿 / ASCII / 线框 | `docs/design/<产品>-ia.md` |
| 验收用例 | `.growing/learn/` 或 plan Done when |
| 实现 | 用户确认后 **`/plan`** — **ia** 默认不直接大改代码 |

## 审查清单

### 工作流正交(R1–R4)

- [ ] 主要路由/主屏可标注 `primaryWorkflow`
- [ ] 首页无多工作流**并列**主 CTA
- [ ] 跨流经分支点,上下文可恢复
- [ ] 分支态无无关工作流表单

### 角色(C1–C4)

- [ ] 无重复整页仅因角色
- [ ] 只读/读写同一壳,写操作 gated
- [ ] 默认着陆与主责工作流一致
- [ ] 高权限用户默认着陆 ≠ 被迫用最全最慢首页

### 权限 UX(P1–P2 · `ia.mdc`)

- [ ] 可见可点控件在当前角色下可用,否则隐藏/禁用+说明
- [ ] 鉴权失败不静默变空列表(显式错误态)

### 导航效率

- [ ] 多步交付类具备**实体中心工作台**(可选但推荐)
- [ ] 作业屏全局导航不抢宽度
- [ ] 卫星工作流非与主工作台平级抢首屏

### 反模式

- [ ] 无 Dashboard KPI 大杂烩
- [ ] 一级菜单非内部架构词堆砌
- [ ] 兼岗有「继续上一意图」策略(或记入开放问题)

## 与 master / plan

- 不确定 → **master** → **ia** 或 **plan** `SPIKE-*`
- 导航大改须 **`/plan`** + `PLAN_APPROVED`