Communitygithub.com

bbulman/labeling

當需要為區段、選單項目、標籤、類別、功能或連結命名或重新命名時使用,特別是當標籤感覺模糊、像是內部術語,或有人問「我們該叫它什麼」、「這個標籤清楚嗎」、「沒人知道『資源』是什麼意思」或「使用者看不懂這個選單」時。不適用於決定標籤背後的結構、建立標籤詞彙表,或撰寫主體內文與微文案。

labeling 是什麼?

這個技能專門處理使用者介面中的標籤命名問題,幫助從模糊的內部術語轉變為使用者能直覺理解的詞彙。它能引導你列出當前標籤及其背後的實際內容、收集使用者真正的用語(包括搜尋記錄、支援問題、卡片分類名稱等),並根據不同情境選擇最合適的標籤系統(如任務導向、對象導向、主題導向等)。支援從單一項目重新命名到整個網站或應用程式的標籤審查,並提供 `labels.csv` 和 `labels.md` 兩個主要產出檔案。適用於 Claude Code、Cursor 等 AI 代理平台,特別適合需要優化導覽選單、功能名稱或分類標籤的開發者和產品設計師。最終由人類做出決策,AI 則提供有依據的選項與建議。

相容平台✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/bbulman/information-architecture-skill/tree/HEAD/skills/labeling

在你喜歡的 AI 中提問

開啟一個已預先載入此 Agent Skill 的新對話。

說明文件

標籤命名

標籤是告訴使用者門後有什麼的文字,在他們打開門之前。這個技能負責決定每個目的地、區段或動作的名稱,以及每個層級使用何種命名系統。每個標籤的檢驗標準是:一個新進使用者能否預測它背後是什麼?

開始之前

你需要如果缺少
當前標籤,包含每個標籤背後的內容及其出現位置閱讀導覽或要求提供。如果還沒有任何內容,交付空的 labels.csv 和測試計畫。
誰在閱讀這些標籤以及他們想做什麼詢問。如果沒有回應,在文件頂部說明你的假設。
使用者自己的用語:搜尋記錄、支援問題、卡片分類群組名稱、訪談、評論從內容和類似產品的慣例中草擬,將每個標籤標記為 untested,並交付測試計畫以便後續驗證。切勿將猜測呈現為使用者的語言。

方法

  1. 在上下文中列出標籤。 記錄每個標籤的群組(一起出現的標籤)、目的地以及背後真正的內容。不考慮同一組中的其他標籤來評斷一個標籤,就會忽略重疊問題。

  2. 收集使用者的用語。 他們的用語是首要候選詞,你的內部術語則不是。

    來源提供什麼注意事項
    搜尋記錄實際輸入的詞彙,最強的觸發詞執行可尋性技能的記錄報告;切勿估算數量
    支援問題使用者如何描述需求遇到問題的人用詞不同
    卡片分類群組名稱人們如何稱呼一個群集使用他們最常見的詞彙
    訪談,5 到 10 人詞彙以及這些詞對他們的意義留意他們未經提示使用的詞
    類似產品使用者已經學會的詞彙熟悉勝過巧妙
  3. 為每個層級選擇一個標籤系統。 在同一個選單中混用不同系統,會使每個項目回答不同的問題,使用者無法相互比較。

    系統範例何時有效何時失效
    任務「追蹤訂單」使用者帶著任務來時任務重疊或列表過長
    對象「給開發者」不同群體需要不同內容,且能自行定位某人屬於多個群體,或不確定自己屬於哪個
    主題「帳單」主題符合使用者的思考方式主題是組織內部的分類,而非使用者的
    格式「影片」、「範本」使用者依格式選擇他們先關心主題
    A 到 Z詞彙表、目錄使用者知道確切名稱他們在瀏覽探索
  4. 根據以下規則撰寫候選詞。

    規則弱較強
    具體且熟悉,無謎樣內容資源、解決方案、探索指南與範本
    同層級平行結構定價、開始使用、給團隊定價、設定、團隊
    前置區分性詞彙報表設定、報表記錄設定、記錄,放在「報表」下
    一個東西,一個名稱到處一致選單中用「團隊」,頁面上用「人員」選擇一個,並在導覽、標題和麵包屑中統一使用
    門與房間一致「方案」點開是「選擇你的訂閱」連結文字與頁面標題一致
    連結文字說明你會得到什麼了解更多下載入職檢查清單
  5. 決定內部名稱的處理方式。

    名稱是這樣做
    團隊、部門或專案代號永遠不要顯示。命名為使用者原本想做的事
    使用者必須學會的功能品牌名稱在導覽中使用時,搭配一個平實的描述詞
    目標受眾真正使用的專業術語保留,即使外人不懂,並在該受眾中測試
    法律或法規術語保留確切術語,並在其旁加上平實解釋
    縮寫拼寫完整,除非目標受眾搜尋縮寫多於完整詞彙
  6. 為每個有爭議的標籤提供兩到三個選項, 說明每個選項的優點與缺點,並推薦一個。單一答案會隱藏決策過程。

  7. 強化標籤周圍的資訊線索。 簡短描述、項目數量、麵包屑和活動狀態可以承擔詞彙本身無法傳達的資訊。當標籤單獨看沒問題但使用者仍然離開時,請參閱 references/information-scent.md。

  8. 測試可預測性。 一個方向是單獨顯示標籤,詢問使用者預期背後是什麼;另一個方向是給一個目標,詢問使用者會選擇哪個標籤。作為初步檢查,你可以進行冷讀:遮住目的地,寫下你預期的內容,然後比較。將此結果報告為你自己的判斷,而非正式研究。references/predictability-test.md 包含計畫和評分方式。

  9. 檢查其他語言。 如果標籤將被翻譯,在確定之前請參閱 references/locales.md。按照意思翻譯,而非逐字翻譯,並在該市場的使用者中重新測試。

交付物

除非使用者指定其他檔案,否則撰寫以下內容。

  • labels.csv,每一列一個標籤:group,label,destination,system,was,evidence,status。evidence 說明詞彙的來源(搜尋記錄、支援、假設)。status 為 kept、renamed 或 new,加上 tested 或 untested,以分號分隔:renamed; untested。
  • labels.md,按此順序:建議(兩到三句話);每個層級選擇的系統;有爭議的標籤(選項、取捨、選擇及原因);內部名稱及其處理方式;如何測試;假設與未解決的問題。完整列表僅存在於 labels.csv 中,因此兩者不得矛盾。
任務回傳內容
重新命名一個項目三個選項及其取捨、一個建議和一個測試問題,在回覆中提供
審查一個選單labels.csv 的資料列和簡短的變更列表
整個網站或應用程式兩個檔案

更長的文件不代表更徹底。

檢查

執行機械檢查並使用其計數:

node "${CLAUDE_SKILL_DIR}/scripts/label-check.mjs" labels.csv

它會找出模糊詞彙、同一群組中的重複、以相同單詞開頭的兄弟項目、混合不同文法形式的群組、一個標籤對應多個目的地以及一個目的地對應多個標籤。格式檢查僅針對明確的模式觸發,因此你仍需自行閱讀每個群組的平行結構。然後驗證:

  • 每個群組使用一個標籤系統,且 labels.md 說明使用的是哪個。
  • 每個標籤都是 tested 或標記為 untested。單純通過腳本檢查不代表使用者理解。
  • 每個標籤的 evidence 是真實的。如果是假設,資料列中必須說明。

Claude 無法做到的事

你無法透過自己閱讀標籤來了解真實使用者的理解程度,也無法在未被告知的情況下得知組織的策略、品牌承諾或內部政治。切勿虛構使用數字、搜尋量、測試結果或引述。提出替代方案及其取捨,推薦一個並說明原因;人類擁有最終決策權,特別是當名稱涉及品牌或法律考量時。

交接位置

下一個需求技能
群組本身看起來不對card-sort, sitemaps
哪些標籤放在哪個選單navigation
標籤與篩選的詞彙taxonomies
重新命名的區段改變了地址url-structure, redirect-maps
在階層結構中測試標籤tree-tests
重新命名後仍未解決「使用者找不到」findability
先列出有哪些內容content-inventory
範本背後的欄位content-models
整個網站重組,或不確定從何開始information-architecture

Individual skills in this repo

This repo contains 4 individual skills — each has its own dedicated page.

bbulman/findability

Use when people can't find something, when site search returns nothing or the wrong thing, when someone wants a search log analysed, best bets or synonyms set up, a no-results page designed or findability measured, or when a chatbot is proposed because "nobody can find anything". Not for redrawing the whole page tree, renaming a menu on its own, or running a tree test.

bbulman/information-architecture

Use when someone wants to organize, restructure or review how a site, app, docs set, knowledge base or content library is grouped and found, and the job spans several pieces or it isn't yet clear which piece is needed, even if they never say "information architecture" or "IA". Not for a job that is clearly one piece, such as only a tree test or only a redirect map, and not for visual design.

bbulman/navigation

Use when someone wants a navigation or menu designed, audited or cut down, including a main menu, nav bar, sidebar, app switcher, mega-menu, footer, breadcrumbs, tab bar or mobile menu, or says "there are too many items in the menu", "rethink the sidebar", "our nav is a mess" or "where should settings go". Not for deciding which pages exist, for wording a single label, for fixing site search, or for running a tree test.

bbulman/sitemaps

Use when someone needs the structure of a website, app or docs set decided, asking for a sitemap, site tree, page hierarchy or list of sections, or saying "what pages do we need", "how should we organise the site", "where should this page live" or "the site is too deep". This is where the structure gets decided. Not for writing the linked sitemap file that later design stages read once the structure is settled (design-os:create-sitemap), for generating sitemap.xml, or for designing the menus.

相關技能