Community寫作與編輯github.com

wensity/wensity-ui-copy

撰寫介面中的文字:標題、按鈕、標籤、輔助文字、錯誤訊息、空白狀態、提示訊息、確認對話框、引導流程與到達頁面文案,以及逼真的範例內容。用於撰寫或修改使用者介面文字、填充新頁面或元件內容、避免文案像行銷話術或由AI生成,或當使用者要求更好的措辭、微文案、CTA文字、錯誤訊息或空白狀態。若非實際修改現有文案,則跳過此技能。

wensity-ui-copy 是什麼?

Wensity UI Copy 技能協助開發者與設計師撰寫清晰、具體且以使用者為中心的介面文案。它基於一套明確的語調與風格指南,涵蓋標題、按鈕、表單、錯誤訊息、空白狀態、載入與成功提示,以及數值與日期格式。此技能特別強調避免空洞的行銷術語與AI生成的贅詞,並提供具體範例與對比表來說明強弱文案的差異。它支援在 Claude Code、Cursor 等AI編碼工具中使用,透過提供結構化的檢查清單與可操作的原則,確保每一位使用者都能理解並採取行動,同時也考量無障礙設計,如為圖示按鈕提供 aria-label 及避免僅依賴色彩傳達訊息。使用此技能時,開發者可以直接引用其規範來審查或生成使用者介面中的任何文字片段。

相容平台~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/wensity/skills/tree/HEAD/skills/wensity-ui-copy

Installed? Explore more 寫作與編輯 skills: steipete/notion, langchain-ai/langchain, bytedance/podcast-generation · View all 6 →

在你喜歡的 AI 中提問

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

說明文件

Wensity UI Copy

文字也是設計的一部分。模糊或浮誇的文案會讓精緻的介面顯得平庸;平實、具體的文案則能讓樸素的介面變得可信。每一段文字的考驗:它是否能幫助使用者理解或採取行動?

1. 語調

  • 平實的文字。 用樂於助人的人會說出口的方式書寫。 "儲存變更",而不是"持久化修改"。"你的點數已用完",而不是"信用餘額已耗盡"。
  • 使用使用者的語言,而非系統的語言。 "通知",而不是"Webhook 發送設定"。根據人們如何使用它來命名事物。
  • 簡短。 刪掉每個不改變意思的字。然後再刪一次。
  • 全篇使用句首大寫(Sentence case): 標題、按鈕、選單項目、頁籤、標籤。 "建立新專案",而不是"建立新專案"(原文為 "Create new project" vs "Create New Project",此處差異在英文大小寫,中文無對應,保留原文範例意涵)。
  • 主動語態,並以使用者為對象。 "你對此專案沒有存取權限",而不是"對此專案的存取不被允許"。當系統發生錯誤時,坦白地說:"我們無法儲存你的檔案",而不是"該檔案無法被儲存"。
  • 冷靜。 除非是真正的慶祝,否則不要使用驚嘆號;錯誤中不要道歉;錯誤狀態中不要開玩笑。

2. 讓文案聽起來像AI生成的詞彙

避免這些詞彙,它們沒有提供讀者可以驗證的資訊:

  • 動詞:解鎖、釋放、提升、賦能、加速、革新、轉型、簡化、槓桿、駕馭、重新想像、飛躍。
  • 形容詞:無縫、毫不費力、尖端、次世代、世界級、強大、直覺、創新、一體化。
  • 片語:「在當今快速變化的世界中」、「將你的X提升到下一個層次」、「無論你是X還是Y」、「告別」、「不用再找了」。
  • 形式:連續三個形容詞(「快速。安全。簡單。」)、中間點清單(設計 · 建置 · 出貨),以及產品文字中任何地方的破折號,包括頁面 <title>、meta description 和 alt text。請使用冒號、逗號或兩個句子:「Ledgerline:任何貨幣的發票」。

用具體的事實取代每一個:它做什麼、多快、給誰、有什麼結果。「將40分鐘的報告縮短至2分鐘」勝過「加速你的工作流程」。

3. 標題

  • 標題要說出重點, 而不是主題。「發票付款速度快9天」勝過「功能」。「你的工作區是空的」勝過「工作區」。
  • 不要使用眉毛標題(eyebrows)。 不要在標題上方放置小型大寫標籤(「功能」、「定價」、「運作方式」)。寫一個能獨立存在的標題。
  • 頁面標題要命名頁面,讓使用者知道他們在哪裡:「帳單」、「團隊成員」。

4. 按鈕與連結

  • 以動詞開頭並命名結果: 「建立發票」、「發送邀請」、「匯出 CSV」。不要單獨使用「提交」、「確定」、「是」、「點擊此處」、「了解更多」。
  • 讓按鈕與下一步動作一致。 如果按鈕寫「發布」,提示訊息就寫「已發布」,頁面也顯示已發布狀態。
  • 主要與次要動作必須明顯不同: 「刪除專案」與「取消」,而不是「是」與「否」。
  • 一到三個字是理想長度。 如果加入具體益處,CTA可以到五個字(「免費開始,無需卡號」)。
  • 連結文字應能獨立理解(螢幕閱讀器會脫離上下文讀取連結):「閱讀 API 指南」,而不是「這裡」。
  • 破壞性動作要命名物件: 「刪除 3 個檔案」、「從團隊中移除 Sam」。

5. 表單

  • 標籤放在欄位上方, 且始終可見。佔位文字不是標籤;它會在開始輸入時消失。
  • 佔位文字顯示格式,而非指示: [email protected],MM / YY。當標籤已足夠時,可以省略它們。
  • 輔助文字放在欄位下方,用於提供使用者在輸入前需要的規則:「至少 12 個字元」。
  • 標記選填欄位,而非必填欄位, 當大部分欄位都是必填時:「公司 (選填)」。
  • 在失去焦點或提交時驗證, 而不是每次按鍵都驗證。將錯誤顯示在它所屬的欄位旁邊。

6. 錯誤

每個錯誤都要回答兩個問題:發生什麼事,以及現在該怎麼做。

不好的寫法更好的寫法
無效輸入請輸入今天之後的日期
發生錯誤我們無法連線到伺服器。請檢查你的連線後再試一次。
錯誤 403你對此專案沒有存取權限。請要求管理員邀請你。
上傳失敗此檔案為 24 MB。限制為 10 MB。
付款遭拒你的卡片被拒絕。請嘗試另一張卡片或聯絡你的銀行。
  • 永遠不要責怪使用者(「你輸入了無效的電子郵件」)。描述修正方式(「請輸入像 [email protected] 的電子郵件」)。
  • 不要在訊息中包含代碼和堆疊追蹤。如果支援人員需要,請在結尾加上參考 ID。
  • 保留使用者輸入的內容。絕不要因為一個欄位驗證失敗而清除整個表單。

7. 空白狀態

空白狀態是新使用者看到的第一個東西。將其視為引導流程:

  1. 說明這裡會出現什麼:「你發送的發票會顯示在這裡。」
  2. 提供一個能填滿它的動作:一個主要按鈕,「建立發票」。
  3. 可選:一個匯入連結、一個範本或一份簡短指南。

對於「無結果」的空白狀態,說明搜尋了什麼以及如何擴大範圍:「沒有『所以』的結果。請檢查拼字或清除篩選條件。」

8. 載入、成功與提示訊息

  • 載入: 當載入時間超過一秒時,說明正在發生什麼事:「正在產生報告…」。使用省略號字元。
  • 成功提示訊息: 動作的過去式,加上物件:「邀請已發送給 [email protected]」、「專案已刪除。復原」。
  • 對於可復原的動作,提供復原功能而非確認對話框。 僅在動作無法復原時才要求確認。
  • 確認對話框: 標題詢問真正的問題(「刪除『Q3 報告』?」),內文說明後果(「這會為所有人移除它。你無法復原此操作。」),按鈕命名動作(「刪除報告」/「取消」)。

9. 數字、日期與單位

  • 使用數字:「3 個檔案」,而不是「三個檔案」。
  • 根據使用者的地區設定格式化:使用 Intl.NumberFormat 和 Intl.DateTimeFormat(或 toLocaleString),而不是手動建構字串。
  • 近期事件使用相對時間(「2 分鐘前」),較舊的事件使用絕對日期(「3月4日」),並在 tooltip 中顯示完整時間戳記。
  • 正確處理複數:「1 個檔案」、「2 個檔案」、「0 個檔案」。使用 Intl.PluralRules 或輔助函式,絕不要使用「file(s)」。
  • 使用不間斷空格將數字和單位保持在一起(HTML 中使用 10&nbsp;MB,JavaScript 中使用 "10\u00A0MB"),這樣它們永遠不會分開換行。

10. 逼真的佔位內容

在沒有真實內容的情況下建置設計時,請撰寫看起來真實的內容:

  • 具體的名稱和資料: 「Maya Chen,Northwind 的產品設計師」,「$12,480.00」,「發票 INV-2041」。而不是「John Doe」、「$XX」、「Lorem ipsum」。
  • 逼真的長度, 包含一些較長的內容,以便測試版面配置:一個 40 個字元的名稱、一個 3 行的描述旁邊放一個 1 行的描述。
  • 不要編造證據。 不要使用虛構的客戶標誌、星級評分、使用者數量或推薦內容作為真實資訊。請使用標記的佔位符([客戶推薦]、[標誌])或請求使用者提供真實的。
  • 與產品的世界相符。 開發工具的範例資料是儲存庫和部署;診所應用程式的範例資料是預約和病人。

11. 文案中的無障礙設計

  • 每個只有圖示的按鈕都必須有可存取名稱:aria-label="關閉對話框"。
  • 替代文字應描述圖片所顯示的資訊性內容(「長條圖:自一月起營收成長 24%」)。裝飾性圖片設定 alt=""。
  • 不要僅依賴顏色詞(「點擊綠色按鈕」)。
  • 首次出現時請展開縮寫,除非該受眾每天使用該縮寫。

12. 完成前檢查

  • 沒有第 2 節中的填充詞彙、沒有三個形容詞的標語、介面字串中沒有 em 破折號。
  • 每個標題都說明一個重點;沒有眉毛標題。
  • 每個按鈕都以動詞開頭並命名其結果。
  • 每個錯誤都說明發生什麼事以及該怎麼做。
  • 每個空白狀態都自我解釋並提供下一步動作。
  • 全篇使用句首大寫(中文無此需求,但保持語意一致)。
  • 範例內容具體、長度多變,且不包含虛構的證據。
  • 只有圖示的控制項和有意義的圖片具有無障礙文字。

Individual skills in this repo

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

相關技能