Community寫作與編輯github.com

twltr/ux-copy

撰寫或審查任何語言的 UX 文案——包括微文案、按鈕標籤與行動呼籲(CTA)、錯誤訊息、空白狀態、確認對話框、工具提示、載入、成功與引導文字。

ux-copy 是什麼?

這個技能是專為 AI 代理(如 Claude Code、Cursor、Codex)設計的 UX 文案撰寫與審查工具,屬於設計領域的葉節點技能。它能幫助開發者和設計師撰寫或審查任何語言的介面文字,包括按鈕、錯誤訊息、空白狀態、確認對話框、工具提示、載入與成功提示等微文案。技能支援多語言,包括德文、法文等非英語介面,並提供針對不同語言的本地化指導,如稱謂形式、動詞形式、大小寫規則、排版格式和長度考量。其核心方法強調從使用者情境出發,以結果導向撰寫文案,而非使用泛泛的通用詞彙。技能通過結構化的輸出格式(如推薦文案、理由、替代選項和本地化筆記)來呈現結果,並支援以表格形式進行多字串的全面審查。

相容平台~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/twltr/skill-profile/tree/HEAD/skills/design/ux-copy

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

在你喜歡的 AI 中提問

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

說明文件

UX 文案

設計領域的葉節點技能;可透過其領域或名稱直接使用。

介面文字是在任務進行中、壓力之下被匆匆一瞥的。好的文案能讓使用者清楚知道即將發生什麼事以及接下來該做什麼;而像「提交」、「確定」或「發生錯誤」這類通用詞彙,只會讓他們猜測。請從使用者的情境與動作的實際結果出發,使用介面本身的語言來撰寫。

實例

請求(虛構產品):「使用者經常不小心刪除專案。請審查這個對話框:你確定嗎? [確定] [取消]」

刪除「Q3 發布」?

此操作將移除團隊中所有人的 14 項任務及所有檔案。
此動作無法復原。
                                   [取消]  [刪除專案]

標題說明了動作與對象,主體陳述了使其嚴重的後果,而破壞性按鈕則重複了動詞,使其能獨立閱讀。「取消」保持不變:這是熟悉的退出方式,重新命名它並無益處。

從情境出發

確定螢幕或流程、使用者當下想做的事及其可能的情緒、產品的語調與既有術語,以及字元限制、平台慣例與目標語言等限制。作為參數傳入的文案即為要審查的文字。當細節不足時,根據陳述的假設來撰寫,而不是發送問卷;僅在答案會改變文案時才提問,例如使用正式或非正式的稱謂。

標記為 ~~ 的章節命名的是工具類別,而非特定產品:例如 ~~設計工具(如 Figma)或 ~~知識庫(如 Notion)。請使用主機提供之該類別中已連接的工具;若無則跳過該步驟。

若搭配 ~~知識庫,請先閱讀品牌語調、內容風格指南與術語。若搭配 ~~設計工具,請在流程中查看該螢幕,並從佈局中取得字元限制。

其他語言的文案

使用介面的語言原生撰寫;先用英文起草再翻譯的文案會保留英文結構,讀起來像外文。請以請求的語言回覆,但以介面的語言撰寫字串——兩者可能不同,例如用英文提問關於德文應用程式的問題。以下模式適用於所有語言;這些慣例會改變其表達方式:

  • 稱謂形式。 許多語言(德文、法文、西班牙文、荷蘭文)在「你」的稱呼上分為正式與非正式。遵循產品既有的選擇;若無,請提出一個並統一應用於所有地方,包含錯誤訊息。
  • 控制項上的動詞形式。 德文、法文和西班牙文介面慣例上使用不定詞而非命令式來標示按鈕和選單項目。請遵循平台與產品的慣例。
  • 大小寫規則。 句子式大寫(Sentence case)是英文的規則。德文會在句子中的任何位置大寫名詞;切勿將英文的標題式大寫(Title case)應用於其他語言。
  • 排版與格式。 使用該語言的引號、間距(法文在 ! ? : ; 前有空格),以及數字、日期和貨幣格式。
  • 長度。 德文和法文通常比英文長三分之一,短字串更是如此;長的複合詞不易換行。請對照實際寬度檢查,並使用正確的 lang 屬性啟用斷字。

在審查時,請檢查所有字串中這些項目的一致性,而非僅限於單一字串。

模式

元素必須做到的事範例
按鈕、CTA動詞加受詞;命名結果;在流程中保持名稱一致「發布」→ 提示「已發布」
錯誤訊息說明發生什麼事及如何修復;只有在有助於修復時才說明原因;絕不責怪,絕不只有原始碼「您的銀行拒絕了這張卡。請嘗試另一張卡或聯絡您的銀行。」
欄位錯誤說明需要什麼,而非什麼錯了「請輸入今天之後的日期」
空白狀態說明此處將出現什麼以及如何開始;無結果則建議修改搜尋「尚無發票。請建立一張或從 CSV 檔案匯入。」
確認對話框命名動作與對象,說明後果,用動詞標示按鈕請見實例
工具提示補充標籤無法說明的內容;絕不重複標籤—
載入中說明正在發生什麼事;對長時間等待設定預期「正在匯入 2,400 個聯絡人。這可能需要一分鐘。」
成功訊息確認具體結果「已將發票傳送給 Dana」而非「成功!」
引導步驟每一步一個概念,與使用者正在做的事相關—

語調保持產品的風格;語氣隨情況變化。錯誤訊息冷靜且具體:同理心意味著承認影響並協助解決,而非反射性地道歉或開玩笑。成功訊息簡短,警告訊息直接。

輸出格式

對於單一元素,提供建議文案以及一句話說明為何它適合使用者的情境。僅在選擇確實開放時提供替代方案,例如語氣或長度的取捨:

## UX 文案:[情境]

**[元素]:** [文案]
[為什麼這對此時的使用者有效]

| 選項 | 文案 | 最佳用途 |
|---|---|---|
| A | [文案] | [使用時機] |

**本地化筆記:** [僅在文案被翻譯或需以多種語言發佈時:需避免的慣用語、擴展、稱謂形式、文化背景]

若要審查多個字串,請使用一個表格以便追蹤每個修改:

| 位置 | 現有文案 | 建議文案 | 原因 |
|---|---|---|---|
| 結帳流程,卡片錯誤 | 「錯誤 402」 | 「您的銀行拒絕了這張卡。請嘗試另一張卡。」 | 說明發生什麼事以及下一步

佈局、排版與視覺層次不在本方法範圍內;長篇行銷文案、文章和電子郵件亦不在此列,這些需要的是寫作方法而非微文案模式。

Individual skills in this repo

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

相關技能