Communitygithub.com

IA 審查

審查產品的資訊架構 — 導覽結構、內容層級、標籤命名、分組與漸進式揭露。適用於審查新畫面或流程的結構清晰度、使用者反映找不到東西、導覽標籤含糊不清、頁籤列或選單結構正在設計或重新考慮時,或質疑「為什麼使用者會迷路?」,也可在產品尚未建置前使用。

IA 審查 是什麼?

IA 審查是一項 AI 代理技能,用於審查數位產品的資訊架構,涵蓋導覽結構、內容層級、標籤命名與漸進式揭露,但不涵蓋視覺設計。它提供三種操作模式:結構設計(在產品尚未建置前,根據需求文件提出導覽模型與內容分組)、流程審查(針對現有畫面或程式碼,審查其結構與標籤是否符合資訊架構原則),以及標籤稽核(檢查導覽、標題與行動呼籲的命名一致性與清晰度)。此技能支援 Claude Code、Cursor、Codex 等開發平台,並提供詳細的審查框架與檢查清單,協助開發者在產品開發早期或迭代過程中,發現並修正導致使用者困惑的結構性問題。AI 代理會依據使用者的要求自動判斷操作模式,並參考 `references/ia-principles.md` 中的原則進行審查,最後以結構化的發現報告輸出結果。

相容平台~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 個則強迫掃視
  • 每個頂層目的地都有單一明確目的 — 沒有萬用頁籤
  • 導覽項目的範圍是平行的(不要將「首頁」與「搜尋」等動詞混用)
  • 使用者始終能清楚知道當前所在區段
  • 返回導覽不含糊 — 使用者始終知道「返回」會帶他們到哪裡

導覽擺放位置 — 每個動作都只有一個正確的歸宿:

  • 頻繁/全域動作 → 主導覽(頁籤列、底部導覽)
  • 情境動作 → 畫面層級(頁首按鈕、懸浮動作按鈕、內嵌列)
  • 罕見/帳戶層級/破壞性動作 → 設定或個人檔案畫面 — 永遠不要放在全域導覽中
  • 標記任何放在萬用選單(漢堡選單、「更多」)中,但應屬於上述類別之一的動作。常見失敗:登出放在漢堡選單導覽中 — 它應屬於帳戶/個人檔案設定。

內容層級

  • 每個畫面上最重要的資訊在標準手機視口 (375pt) 的折疊線以上
  • 次要資訊可存取,但不與主要內容競爭
  • 相關項目被分組;不相關的項目以空白或分隔線隔開 — 分組應遵循使用者的心智模型,而非後端或實作結構
  • 群組內的項目按使用者優先級排序(重要性、使用頻率、新近度) — 絕不按插入順序、API 回應順序或內部 ID 排序
  • 列表按使用者會預期的邏輯排序(新近度、頻率、字母順序、狀態) — 排序邏輯應明確且跨相似列表保持一致

資訊線索

  • 每個導覽項目都能預測其內容 — 點擊它會提供標籤所暗示的內容
  • 章節標題描述接下來的內容,而非該區段內部的稱呼
  • 空白狀態說明這裡應該有什麼以及如何新增 — 而不只是「這裡還沒有任何東西」
  • 錯誤狀態告訴使用者發生了什麼事以及下一步該怎麼做

漸進式揭露

  • 畫面有一個主要動作;次要動作被歸類為從屬或延後
  • 進階或破壞性動作需要額外一個步驟(確認、動作表單、子選單)
  • 入門的複雜度被延後 — 使用者在被要求提供輸入或權限之前先看到價值
  • 表單僅收集此步驟所需的資訊;選填欄位有明確標示

網頁 / SaaS 結構 — 僅限瀏覽器傳遞的產品;原生產品可跳過。詳情請見 references/ia-principles.md → 網頁和 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 → 標籤長度 中每個表面的字元數,而非字數 — 兩個字的標籤仍可能溢出頁籤列

一致性

  • 相同的動作/目的地在其出現的每個地方都使用相同的標籤
  • 同一層級內的標籤形式平行(全部為名詞,或全部為動詞片語 — 不要混用)
  • 大小寫一致(導覽使用 Title Case,內文使用 Sentence case — 選擇一種並套用)

不含糊性

  • 沒有兩個標籤可能被合理地混淆
  • 避免或最小化通用標籤(「更多」、「其他」、「其他雜項」)
  • 負面標籤(「不要顯示這個」)應改寫為正面動作(「隱藏」)

輸出格式

## 標籤稽核 — [範圍]

### 審查的標籤
[所有被稽核標籤的扁平清單]

### 清晰度問題
[發現或 ✅ 清晰]

### 一致性問題
[發現或 ✅ 一致]

### 不含糊性問題
[發現或 ✅ 不含糊]

### 建議修訂
| 當前 | 建議 | 原因 |
|---------|-------------|--------|

模式 3 — 結構設計 (建置階段)

給定:一份需求文件、功能列表、一組使用者任務或 ui-design-principles 步驟 1 的任務結構。目前尚未建置任何東西 — 這就是重點。 此模式會產生建置團隊接下來要實作的結構,因此美學是建立在已確定好的結構之上,而非猜測。

在此正向閱讀 references/ia-principles.md:在模式 1–2 中,它用來證明發現的合理性;在此模式中,它是設計流程。導覽模型、認知負荷預算、範圍平行性、模態與推入、分組邏輯、資訊線索、漸進式揭露和標籤標準,都是現在需要做出的決定,而不是日後要檢查的規則。

當使用者要求可重複使用的 IA 成品、要求範例,或結構符合設定、密集的操作型 SaaS 表面、內容/知識網站或代理型產品時,也請載入 references/structure-blueprints.md。其藍圖是經過驗證的可交付形式,而非導覽範本:任務清單仍必須證明每個目的地和標籤的合理性。

步驟 1:盤點任務,而非功能

用使用者的話來說,列出他們需要做什麼。功能列表是後端的觀點;任務列表是用戶的觀點。兩個功能可能是一個任務(「編輯個人檔案」+「更換照片」),一個功能可能是三個任務。將每個任務標記為頻繁 · 偶爾 · 罕見,以及主要 · 支援 · 管理 — 頻率決定顯著性,罕見決定隱藏性,而這兩者都在此決定,而非在審查中發現。

步驟 2:按使用者意圖分組,然後命名群組

根據任務背後的意圖將它們聚類,絕不依據資料模型或團隊歸屬。然後使用標籤標準(動詞 vs. 名詞、長度限制、無內部術語)為每個聚類命名。如果一個聚類無法用一兩個簡單的字詞命名,則表示分組有誤 — 命名困難本身就是診斷依據,而不是日後要解決的文案問題。

步驟 2.5:繪製代理結構 — 條件性

僅當產品的核心互動是模型產生輸出或代理代表使用者行動時才執行此步驟。 對於僅僅在內部使用了 AI 的產品則跳過,並用一句話說明跳過的原因,使省略而非沉默。詳細資訊和常見發現位於 references/ia-principles.md → 代理結構。

它位於此處,在分組之後、導覽模型之前,因為它所產生的是目的地:代理會累積使用者未建立且未曾參與的物件,而每個物件在選擇模型之前都需要一個歸宿。代理 IA 會產生使用者心智模型中未預先存在的目的地 — 例如代理完成的工作記錄、工作階段歷史記錄或模型設定 — 這些都需要由任務清單與使用者意圖來證明其合理性,並在結構中取得適當的顯著性。

步驟 3:選擇導覽模型

根據任務清單的大小、層級和使用者預期,從以下模型中選擇:頂部或底部頁籤列(適用於 3–5 個頂層目的地)、側邊欄(適用於具巢狀結構的更深度內容)、單一頁面視圖(適用於單一任務應用程式),或混合模型(例如底部導覽的其中一個頁籤會導出側邊欄)。針對每個選擇陳述理由 — 為什麼這個模型而非其他模型。

步驟 4:為每個目的地分配任務

在任務清單中,將每個任務分配到一個且僅一個目的地。如果一個任務似乎適合多個目的地,則表示結構或任務定義有問題 — 重溫步驟 2。將每個動作分配到它最明顯的歸宿。如果一個目的地累積了太少任務(〜1 個)或太多任務(〜15+ 個),則重新考慮分組。

步驟 5:套用標籤標準

根據步驟 2 的群組和步驟 4 的目的地,使用 references/ia-principles.md → 標籤長度、動詞與名詞規則 和 一致性規則 來名稱每個導覽元素。

步驟 6:設計漸進式揭露

對於每個畫面(僅限第一步 — 細節留給 UI 設計),決定:

  • 哪個動作是最重要的?這會成為主要行動呼籲。
  • 哪些資訊是必要的?這會保留在最上層。
  • 哪些是進階或罕見的?這需要額外一層深度:確認對話框、展開/折疊、次要頁籤。

步驟 7:輸出結構提案

## 結構提案 — [產品/功能名稱]

### 任務盤點
| 任務 | 頻率 | 類型 | 理由 |
|------|--------|--------|---------|
| 建立報告 | 頻繁 | 主要 | 核心使用者旅程中的第一個動作 |

### 導覽模型
[所選模型] — [為什麼]

### 結構
├── [目的地 1]
│   ├── [任務 A]
│   └── [任務 B] → [子任務]
├── [目的地 2]
└── [目的地 3]

### 揭露決策
- [畫面/目的地]:主要動作是 [X];進階動作 [Y] 被延後到 [位置]

### 未解決的決策
- 尚待決定的項目

規則

  • 始終在審查前載入 references/ia-principles.md。其中包含完整規則集、字元數限制和代理結構細節。
  • 當結構匹配任一藍圖時,載入 references/structure-blueprints.md(以產出可重複使用的成品或範例);否則跳過。
  • 按層級報告發現(層級 1 → 層級 2 → 層級 3),且僅在有清晰的可用性影響時報告。
  • 模式 1 始終包含一個導覽結構圖。模式 2 始終包含一個標籤清單。模式 3 始終包含一個結構提案。

工具參考

如需完整的 AI 代理設定、安裝指南和其他工具,請參閱 docs/ai-agent-tools.md。

有關 ui-design-principles 技能,包括修復處方,請參閱其技能檔案。

Individual skills in this repo

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

相關技能