UX Writing Skill

它適合什麼工作，以及為什麼是它

當問題出在產品裡面的文字時就用它：按鈕寫了等於沒寫（「送出」、「確定」）、錯誤訊息只報代碼卻不說下一步、空白狀態讓使用者盯著一片空白，或是產品的各畫面由五個不同的人寫，讀起來就像五個人寫的。

它之所以可用、而不是一篇風格論文，是因為它圍繞三件具體的東西組織：一份逐元素的模式清單（標題、按鈕、驗證與系統錯誤、成功訊息、空白狀態、表單標籤、通知）、四項用來檢查任何一句話的品質標準，以及一組針對句子與標籤長度的數字目標。它還把錯誤訊息依種類分開——欄位驗證、系統失敗、阻斷性、權限——因為每一種該寫的句子都不一樣。

它同時明確處理了多數文案指引忽略的語氣問題：把 voice（固定不變的人格）與 tone（這個人格如何調整）分開，並依使用者當下可能的情緒狀態——受挫、困惑、有信心、謹慎、成功——給出不同的語氣版本。這正是把「要親切」變成代理可以實際套用的東西。

什麼情況不該用它

它負責撰寫與審閱介面文字，不是內容策略，不是資訊架構，也不能取代「知道產品在做什麼」。如果真正的問題是某個畫面在索取產品根本用不到的資訊，把標籤寫得再完美也修不好。

它的數字目標是參考指引，不是法律，而且有幾項明確取決於讀者對象。對一般大眾的閱讀程度目標，不是專業工具的目標，而技能本身也這樣寫。把最嚴格的數字套用到所有地方，只會得到對它的讀者而言既簡單又不正確的文案。

那些基準數字應該當成作者引用的研究，而不是對你產品的量測。它們適合當作拿來比對的目標；它們不是「你的文案對你的使用者有效」的證據。只有你的使用者是那個證據。

它需要什麼，以及會產出什麼

輸入是文案本身，加上足以判斷它的脈絡：這個畫面為了什麼、誰在讀、以及使用者看到它的當下處於什麼狀態。如果只給一串沒有脈絡的字串，產出可以文法完美卻仍然錯誤，因為同一句話在某個流程裡是對的，在另一個流程裡是錯的。

回傳的是修改後的文字加上對它的檢視，而那四個階段讓修改的形狀看得出來：先問這段文字有沒有幫使用者完成事情，再問每個字有沒有存在的理由，接著問它像不像人會說的話，最後問它有沒有歧義。如果是寫錯誤訊息，模式是一句特定結構的三段話——哪裡失敗、為什麼或代表什麼、接下來該做什麼。

它附的不只是建議，還有可直接使用的素材：無障礙參考文件、語氣圖表範本、內容易用性檢查清單、延伸的模式範例、錯誤訊息與空白狀態的填空範本、新手引導框架，以及附分析的修改前後範例。這些都是專案裡的檔案；你的代理會不會打開它們，取決於它是只讀進入點檔案，還是會照著參照去讀。

工具支援、權限與相依性

進入點檔案列出了它相容的代理，並直接說明它可用於某一家廠商的命令列與編輯器產品，但不適用於該廠商的聊天產品，因為那個產品無法安裝技能。這種誠實很有用：它告訴你界線在哪，而不是含糊地說「任何 AI 工具都可以」。

權限範圍很小：它是一組指示與參考文件，沒有腳本、沒有指令、沒有網路呼叫。唯一要注意的寫入行為就是一般的寫入——它會修改你交給它的檔案或字串。這裡沒有任何東西需要碰觸你的專案以外的地方。

有一項整合值得點出來，因為它改變的是流程而不是文案：專案附了一份指引，說明如何搭配某個設計工具的連接器使用這個技能，讓字串可以在設計稿所在的地方被檢視。那是選用的，而且也是這個專案唯一涉及其他服務的部分。

和「幫我改這段文案」的提示詞相比

一般提示詞可以產出更短、更親切的字串，而對少量標籤來說這樣可能就夠了。你也可以要求它解釋取捨、遵循共同詞彙，但需要提供脈絡並檢查結果。這個技能提供可重複使用的檢視流程，處理同一概念在設定頁與錯誤訊息裡叫不同名字，或十二個確認對話框寫成十二種語氣等問題。是否確實遵循流程仍需檢查，不能保證文案一定一致。

代價是訪談本身的負擔。因為它需要脈絡、又要跑四個檢視階段，區區一個按鈕標籤也會變成一場小型對話。實務上的解法是整批處理：把一個流程裡的字串收集起來一起跑，而不是一次一個字串。

如何自己驗收成果

介面文案要用「使用介面」來檢查，而不是讀一份字串清單。下面這幾項能抓到清單看不出來的問題。

• 刻意觸發每一條錯誤路徑，並且用一個已經很煩的使用者角度去讀那則訊息。如果它沒說下一步做什麼，就是還沒寫完。
• 只看某個畫面上的按鈕，測自己能否在不讀其他文字的情況下預測每個按鈕做什麼。含糊的操作提示之所以能在改寫後存活，是因為沒有人單獨測它們。
• 在整個產品裡搜尋同一個概念，確認它在每一處、包括錯誤訊息裡，都叫同一個名字。
• 確認這些文字對回訪使用者仍然說得通，不只是對第一次來的人。為新手引導寫的說明，常常在第十次造訪時變成噪音。
• 用螢幕閱讀器讀一遍互動元素：如果一個控制項的標籤只有在視覺脈絡旁邊才說得通，那它就不無障礙，無論在畫面上看起來多好。
• 如果技能改動了確認或破壞性動作的措辭，重新確認後果仍然寫清楚。把警告改得更精簡，正是警告不再警告的方式。

來源、版本，以及實際讀過的範圍

上面這些判斷是針對本頁顯示的那個提交寫成。當已發布紀錄移到另一個提交時，這份導讀就不會顯示，因此不會變成在描述沒有人重新讀過的版本。

實際讀過的是：該提交下的專案進入點檔案，完整讀過。其中列出原則、元素模式、語氣框架、無障礙段落、基準數字、編輯階段，以及它自己的檔案清單。被引用的其他檔案與範本並未開啟，所以本導讀不評價它們的品質。沒有安裝或執行任何東西，沒有執行代理，也沒有處理任何真實產品的文案。上面提到的基準數字是作者引用的數據，在此作為可比的目標呈現，而不是本清單實測的結果。