Communitygithub.com

IA审查

审计产品信息架构——导航结构、内容层级、标签、分组和渐进式披露。适用于审查新屏幕或流程的结构清晰度、用户反馈“找不到东西”、导航标签模糊、设计或重新考虑标签栏/菜单结构,或追问“用户为什么迷路”时。

IA审查 是什么?

该技能(ia-review)专为AI代理设计,用于系统审计或设计产品的信息架构(IA),重点关注导航结构、内容层级、标签清晰度和渐进式披露。它有效补充了ui-design-review(视觉质量)和ui-design-principles(实现指南),在工作流程的不同阶段提供关键的结构性洞察。 该技能以三种不同模式运行,覆盖产品开发全生命周期:**结构设计**(模式3)适用于构建前期——给定需求、功能列表或用户任务,从零开始设计导航模型和屏幕结构;**流程审查**(模式1)适用于审查现有界面(截图、代码或设计稿),对照全面清单检查逻辑分组、导航模型、内容层级和渐进式披露,并报告发现;**标签审计**(模式2)侧重于导航、标题和操作按钮的命名一致性与清晰度。 其核心价值在于确保在投入视觉设计或工程资源之前,先确立清晰的结构,防止用户因导航混乱而迷路。该技能可部署于Claude Code、Cursor和Codex等AI代理平台,通过结构化输出(如导航树、发现报告表)直接交付可操作的修复建议,并明确指定后续交接目标(如IA自行修复、ui-design-review、ui-design-principles或ui-design-system)。

兼容平台~Claude Code~Codex CLI~Cursor✓Antigravity
npx skills add https://github.com/stevensmith-design/aispy/tree/HEAD/skills/design-kit/ia-review

在你喜欢的 AI 中提问

打开一个已预加载此 Agent Skill 的新对话。

文档

IA审查 是做什么的?

结构清晰度技能。涵盖内容的组织方式和标签——而非外观。 关于视觉质量,请使用 ui-design-review。关于实现约束,请使用 ui-design-principles。


审查框架

每次 IA 审查都按顺序通过三个层级。

第1层——结构:组织是否合乎逻辑? 屏幕是否按用户意图分组?导航模型是否与用户对产品的认知方式一致,而非后端组织方式?此层的结构问题意味着用户无论如何都无法找到内容,与标签质量无关。

第2层——标签:名称是否清晰且一致? 导航标签、章节标题和操作按钮必须独立无歧义——无需用户解码。命名不一致(同一概念、两个名称)即使结构健全,也属于第2层失败。

第3层——披露:复杂性是否得到妥善管理? 关键信息是否立即呈现?次要复杂性是否在需要时才展开?屏幕过载和关键操作被隐藏属于第3层失败。


模式检测

读取请求并在开始前选择模式。

信号模式
需求、功能列表或用户任务,尚未构建任何内容;“应该如何组织?”;ui-design-principles 第1步交出的任务结构结构设计
“审查此屏幕/流程”,分享屏幕截图或代码流程审查
“检查标签/导航命名”,分享导航结构标签审计
模棱两可流程审查,并将标签审计作为子步骤

模式3携带一个条件步骤(第2.5步,代理结构),当模型或代理为用户执行操作时触发。模式1和2对照 references/ia-principles.md → 代理结构 审计该步骤的结果。

决定性问题是制品是否存在。 模式1和2审计已存在的事物;模式3设计它。如果你被要求检查尚未构建的结构,不要审计草图,也不要跳过步骤——运行模式3并将其确定的结构向前传递。模式3的输出就是模式1后续审计所依据的标准。


模式1 — 流程审查

给定:截图、Figma链接、屏幕名称或源文件。

第1步:绘制结构图

首先询问是否存在结构方案。 如果该产品曾运行过模式3——仓库、需求或早期会话中的结构方案——则加载它,并对照方案审计已发布的结构,而不仅仅对照清单。每个偏差本身单独作为一个发现,以方案为证据,并有其自身的严重程度:一个移动了的目标位置、一个失去单一归属的任务、一个被推翻的披露决策。明确说明偏差看起来是有意的(构建过程中有所学习)还是偶然的(未遵循方案),因为两者需要不同的应对方式。如果不存在方案,则用一句话说明,并仅对照清单进行审计——方案缺失本身不构成发现,但默默地不去查找方案正是漂移悄然发生的方式。

添加到现有站点的页面会对照其加入的所有页面进行检查:共享导航会将该页面带到所有位置(相同的项目、相同的顺序),而标签指向它的旧链接现在也指向它。然后绘制实际发布的内容。列出每个屏幕及其在导航层级中的位置。如果提供了源代码,请先搜索它(任何代码搜索工具——ripgrep、grep、编辑器搜索、IDE符号搜索)以查找路由定义、标签栏项目和屏幕名称——不要试图在内存中保留整个结构。

导航结构:
├── 标签1:[标签]
│   ├── 屏幕A
│   └── 屏幕B → 屏幕C(模态)
├── 标签2:[标签]
└── 标签3:[标签]

第2步:运行 IA 清单

阅读 references/ia-principles.md 获取完整规则集。检查每个类别:

导航模型

  • 顶级目的地的数量在认知负载预算内——3–5(references/ia-principles.md → 导航模型)。低于3显得随意;超过5迫使扫描
  • 每个顶级目的地有单一明确用途——没有万能标签
  • 导航项的范围平行(不将“首页”与“搜索”等动词混合)
  • 用户始终清楚当前所在区域
  • 返回导航明确——用户始终知道“返回”会去往何处

导航放置——每个操作恰好有一个正确的归属:

  • 频繁/全局操作 → 主导航(标签栏、底部导航)
  • 上下文操作 → 屏幕级别(标题按钮、FAB、内联行)
  • 罕见/账户级/破坏性操作 → 设置或个人资料屏幕——绝不在全局导航中
  • 标记任何放在万能菜单(汉堡菜单、“更多”)中但属于上述某个类别的操作。常见失败:退出登录放在汉堡菜单中——它属于账户/个人资料设置。

内容层级

  • 每个屏幕上最重要的信息在标准手机视口(375pt)上位于首屏上方
  • 次要信息可访问但不与主要内容竞争
  • 相关内容已分组;不相关内容通过间距或分隔线分离——分组遵循用户心理模型,而非后端或实现结构
  • 分组内的项目按用户优先级(重要性、使用频率、时效性)排序——绝不按插入顺序、API响应顺序或内部ID排序
  • 列表按用户期望的逻辑排序(时效性、频率、字母顺序、状态)——排序逻辑明确且跨相似列表一致

信息线索

  • 每个导航项能预示其内容——点击它后会提供标签所暗示的内容
  • 章节标题描述接下来的内容,而非该章节的内部名称
  • 空状态说明此处应有什么以及如何添加——不仅是“这里什么都没有”
  • 错误状态告知用户发生了什么以及接下来该怎么做

渐进式披露

  • 屏幕有单一主要操作;次要操作处于从属或延迟状态
  • 高级或破坏性操作需要额外一步(确认、操作单、子菜单)
  • 引导复杂性被推迟——用户在输入信息或被要求授权前先看到价值
  • 表单仅收集本步骤所需内容;可选字段清晰标记

Web/SaaS 结构——仅限浏览器分发产品;原生应用跳过。详细信息见 references/ia-principles.md → Web 和 SaaS 结构。

  • 任何可能增长到超过一个屏幕的集合都提供专门的检索路径——搜索、筛选、排序、分组或分页——匹配用户实际的查找习惯
  • 用户始终能识别当前位置(激活的导航状态、命名内容的页面标题、二级以上的面包屑导航)
  • 对于同一目的地,导航标签、页面标题、面包屑段和浏览器 <title> 保持一致
  • 每个值得返回、链接或分享的视图都有其自己的URL——记录、筛选/排序的列表、选中的标签、向导步骤——并且筛选/排序/标签状态存在于URL中,而不仅存在于组件状态中
  • 返回、前进、刷新、深度链接和在新标签页中打开各自执行显而易见的操作且不丢失工作(持久化部分交接至 ui-design-principles → 行为、状态与恢复 → 运行时风险)

一致性

  • 同一概念在所有地方名称相同(导航标签 = 页面标题 = 操作按钮 = 文案中的任何引用)
  • 交互模式一致——如果某个列表有滑动删除,所有相似列表都应具有该功能
  • 对于相同类型的任务,模态与推送导航的使用方式一致

第3步:发现

按层级报告发现。每个发现使用相同的模式:

  • 发现:具体的结构/标签/披露问题
  • 受影响的流程/标签/屏幕:发生位置(逐字引用屏幕名称、路径或标签)
  • 证据:显示问题的内容——观察到的结构、标签文本、导航位置(非猜测)
  • 严重程度:阻塞(用户无法完成核心任务/迷路)· 主要(频繁混淆或走错路径)· 次要(摩擦或不一致)
  • 建议:具体的修复。对于在此处解决的结构性发现(IA(在此处解决)),使其达到可实施标准——在结构中命名原因、确切或有限范围的更改、受影响的屏幕/标签,以及确认更改的检查——与审查技能通过 ui-design-review/references/repair-prescriptions.md 应用的同等标准
  • 交接目标:修复实际落地之处(若非纯 IA)——视觉层级 → ui-design-review,实现 → ui-design-principles,命名/令牌一致性 → ui-design-system,或 IA(在此处解决)(当为结构性问题时)

不要报告主观偏好的内容——仅报告具有明确用户影响理由的发现。

输出格式

## IA审查 — [产品/屏幕名称]

### 导航结构
[映射的层级]

### 发现
| # | 发现 | 受影响的流程/标签 | 证据 | 严重程度 | 建议 | 交接目标 |
|---|---------|--------------------|----------|----------|----------------|----------------|
| 1 | 退出登录隐藏于汉堡菜单“更多”中 | 全局导航 → 更多 | 退出登录位于万能菜单中;账户操作属于个人资料 | 主要 | 将退出登录移至个人资料/账户设置 | IA(在此处解决) |

### 按层级
- **第1层 — 结构:** [发现或 ✅ 无结构问题]
- **第2层 — 标签:** [发现或 ✅ 标签清晰一致]
- **第3层 — 披露:** [发现或 ✅ 复杂性得到恰当管理]

### 总结
[2–3句话:哪些做得好,最高优先级的修复是什么]

模式2 — 标签审计

给定:导航标签列表、章节标题、屏幕标题或导航结构。

第1步:提取所有标签

将每个用户可见的标签收集为平面列表:标签名称、屏幕标题、章节标题、操作按钮、空状态标题。

第2步:运行标签检查

清晰度

  • 每个标签无需上下文即可理解——新用户能预测其包含的内容
  • 无内部行话、产品代号或后端术语暴露给用户
  • 动作使用动词(“保存”、“分享”),目的地使用名词(“设置”、“历史”)
  • 标签在保持含义的同时尽可能简短。绑定的限制是每个表面的字符数,见 references/ia-principles.md → 标签长度,而非单词数——两个单词的标签仍可能溢出标签栏

一致性

  • 同一动作/目的地在其出现的所有地方使用相同标签
  • 相同层级的标签形式平行(全部名词或全部动词短语——不混合)
  • 大小写一致(导航使用标题大小写,正文使用句子大小写——选定一种并贯彻执行)

歧义性

  • 没有两个标签可能被合理混淆
  • 通用标签(“更多”、“其他”、“杂项”)不存在或已最小化
  • 否定标签(“不再显示”)改写为肯定操作(“隐藏”)

输出格式

## 标签审计 — [范围]

### 已审查标签
[审计的所有标签的平面列表]

### 清晰度问题
[发现或 ✅ 清晰]

### 一致性问题
[发现或 ✅ 一致]

### 歧义性问题
[发现或 ✅ 无歧义]

### 建议修订
| 当前 | 建议 | 原因 |
|---------|-------------|--------|

模式3 — 结构设计(构建阶段)

给定:需求、功能列表、一组用户任务或 ui-design-principles 第1步的任务结构。尚未构建任何内容——这正是重点。 此模式产生构建随后实现的结构,因此美学设计的是已确定的结构而非猜测的。

在此处正向阅读 references/ia-principles.md:在模式1–2中,它用于证明发现的合理性;在此模式中,它是设计流程。导航模型、认知负载预算、范围平行性、模态vs推送、分组逻辑、信息线索、渐进式披露和标签标准都是现在要做的决定,而非之后要检查的规则。

当用户请求可重用的 IA 制品、要求提供示例,或结构匹配设置、密集的操作性 SaaS 表面、内容/知识站点或代理产品时,也加载 references/structure-blueprints.md。其蓝本是经过实践的交付物形式,而非导航模板:任务清单仍必须证明每个目的地和标签的合理性。

第1步:盘点任务,而非功能

用用户的语言列出用户需要做的事情。功能列表是后端的视图;任务列表是用户的视图。两个功能可能是一个任务(“编辑个人资料” + “更换照片”),一个功能可能是三个任务。标记每个任务为频繁 · 偶尔 · 罕见,以及主要 · 辅助 · 管理——频率决定突出程度,罕见度决定隐藏程度,这两者都在此处决定,而非在审查中发现。

第2步:按用户意图分组,然后为组命名

按意图对任务进行聚类,切勿按数据模型或团队归属。然后使用标签标准(动词vs名词、长度限制、无内部术语)命名每个聚类。如果一个聚类无法用一两个普通词汇命名,则分组是错误的——命名困难本身就是诊断依据,而非留待日后解决的文案问题。

第2.5步:映射代理结构——有条件执行

仅在产品核心交互是模型生成输出或代理代表用户执行操作时运行。 对于仅内嵌某些AI功能的产品则跳过,并用一句话说明省略,以便可见而非无声。详细信息和常见发现见 references/ia-principles.md → 代理结构。

它位于此处,在分组之后、导航模型之前,因为它产生的是目的地:代理会累积用户未创建且未在场见证的对象,每个对象在模型被选定之前就需要一个归属。**代理的 IA **

…

[翻译内容被截断]

Individual skills in this repo

This repo contains 1 individual skill — each has its own dedicated page.

相关技能