標籤命名
標籤是告訴使用者門後有什麼的文字,在他們打開門之前。這個技能負責決定每個目的地、區段或動作的名稱,以及每個層級使用何種命名系統。每個標籤的檢驗標準是:一個新進使用者能否預測它背後是什麼?
開始之前
| 你需要 | 如果缺少 |
|---|---|
| 當前標籤,包含每個標籤背後的內容及其出現位置 | 閱讀導覽或要求提供。如果還沒有任何內容,交付空的 labels.csv 和測試計畫。 |
| 誰在閱讀這些標籤以及他們想做什麼 | 詢問。如果沒有回應,在文件頂部說明你的假設。 |
| 使用者自己的用語:搜尋記錄、支援問題、卡片分類群組名稱、訪談、評論 | 從內容和類似產品的慣例中草擬,將每個標籤標記為 untested,並交付測試計畫以便後續驗證。切勿將猜測呈現為使用者的語言。 |
方法
-
在上下文中列出標籤。 記錄每個標籤的群組(一起出現的標籤)、目的地以及背後真正的內容。不考慮同一組中的其他標籤來評斷一個標籤,就會忽略重疊問題。
-
收集使用者的用語。 他們的用語是首要候選詞,你的內部術語則不是。
來源 提供什麼 注意事項 搜尋記錄 實際輸入的詞彙,最強的觸發詞 執行可尋性技能的記錄報告;切勿估算數量 支援問題 使用者如何描述需求 遇到問題的人用詞不同 卡片分類群組名稱 人們如何稱呼一個群集 使用他們最常見的詞彙 訪談,5 到 10 人 詞彙以及這些詞對他們的意義 留意他們未經提示使用的詞 類似產品 使用者已經學會的詞彙 熟悉勝過巧妙 -
為每個層級選擇一個標籤系統。 在同一個選單中混用不同系統,會使每個項目回答不同的問題,使用者無法相互比較。
系統 範例 何時有效 何時失效 任務 「追蹤訂單」 使用者帶著任務來時 任務重疊或列表過長 對象 「給開發者」 不同群體需要不同內容,且能自行定位 某人屬於多個群體,或不確定自己屬於哪個 主題 「帳單」 主題符合使用者的思考方式 主題是組織內部的分類,而非使用者的 格式 「影片」、「範本」 使用者依格式選擇 他們先關心主題 A 到 Z 詞彙表、目錄 使用者知道確切名稱 他們在瀏覽探索 -
根據以下規則撰寫候選詞。
規則 弱 較強 具體且熟悉,無謎樣內容 資源、解決方案、探索 指南與範本 同層級平行結構 定價、開始使用、給團隊 定價、設定、團隊 前置區分性詞彙 報表設定、報表記錄 設定、記錄,放在「報表」下 一個東西,一個名稱到處一致 選單中用「團隊」,頁面上用「人員」 選擇一個,並在導覽、標題和麵包屑中統一使用 門與房間一致 「方案」點開是「選擇你的訂閱」 連結文字與頁面標題一致 連結文字說明你會得到什麼 了解更多 下載入職檢查清單 -
決定內部名稱的處理方式。
名稱是 這樣做 團隊、部門或專案代號 永遠不要顯示。命名為使用者原本想做的事 使用者必須學會的功能品牌名稱 在導覽中使用時,搭配一個平實的描述詞 目標受眾真正使用的專業術語 保留,即使外人不懂,並在該受眾中測試 法律或法規術語 保留確切術語,並在其旁加上平實解釋 縮寫 拼寫完整,除非目標受眾搜尋縮寫多於完整詞彙 -
為每個有爭議的標籤提供兩到三個選項, 說明每個選項的優點與缺點,並推薦一個。單一答案會隱藏決策過程。
-
強化標籤周圍的資訊線索。 簡短描述、項目數量、麵包屑和活動狀態可以承擔詞彙本身無法傳達的資訊。當標籤單獨看沒問題但使用者仍然離開時,請參閱 references/information-scent.md。
-
測試可預測性。 一個方向是單獨顯示標籤,詢問使用者預期背後是什麼;另一個方向是給一個目標,詢問使用者會選擇哪個標籤。作為初步檢查,你可以進行冷讀:遮住目的地,寫下你預期的內容,然後比較。將此結果報告為你自己的判斷,而非正式研究。references/predictability-test.md 包含計畫和評分方式。
-
檢查其他語言。 如果標籤將被翻譯,在確定之前請參閱 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 |