clarify

概覽

clarify 技能是什麼？

clarify 技能專為 UI 與 UX 設計師、前端開發者及產品團隊打造，系統性地改善不清楚的介面文字。它著重於優化使用者體驗文案、錯誤訊息、微文案、標籤與指示，使數位產品更容易理解與使用。如果使用者對模糊的標籤、含糊的錯誤訊息或難以遵循的指示感到困惑，clarify 提供結構化的方法來識別並解決這些問題。

誰適合使用 clarify？

clarify 非常適合負責介面設計、使用者體驗文案或前端開發的人員。當你收到關於文字混淆、不清楚標籤或無效錯誤訊息的反饋，或想主動提升產品溝通的清晰度時，clarify 是理想的工具。

clarify 解決的問題

• 不清楚或模糊的介面文案
• 讓使用者困惑的專業術語
• 無法協助使用者恢復的錯誤訊息
• 難以遵循的操作指示
• 介面文字的語氣不符或缺乏上下文

使用方式

安裝步驟

1. 使用以下指令安裝 clarify：

   npx skills add https://github.com/pbakaus/impeccable --skill clarify
   

2. 首先檢視 clarify 技能目錄中的 SKILL.md 檔案。該檔案說明了工作流程、準備步驟與改善介面文案的最佳實踐。

工作流程概述

• 必要準備：

  • 呼叫 $frontend-design 以取得設計原則與上下文收集協議。
  • 若無設計上下文，請先執行 $teach-impeccable。
  • 收集目標使用者的技術程度與心理狀態資訊。

• 評估現有文案：

  • 識別清晰度問題，如術語、模糊性、被動語態、冗長、假設、缺乏上下文與語氣不符。
  • 了解上下文：目標受眾、使用者狀態、預期行動與限制條件。

• 規劃與改進：

  • 系統性地處理每個清晰度問題。
  • 以使用者視角與心理狀態重寫文案。
  • 與真實使用者或利害關係人測試修訂後的文案。

檔案結構與重要資源

• 以 SKILL.md 作為主要工作流程參考。
• 若安裝中有 README.md、AGENTS.md 及支援資料夾如 rules/、resources/ 或 references/，也可一併參考。

常見問題

什麼時候應該使用 clarify？

當你遇到混淆、模糊或無效的介面文字，或想主動提升產品溝通的清晰度與易用性時，都適合使用 clarify。

clarify 適用於哪些類型的文案？

clarify 適用於使用者體驗文案、錯誤訊息、微文案、標籤與指示——任何影響使用者理解的介面文字。

使用 clarify 前需要設計上下文嗎？

需要。clarify 的工作流程要求先收集設計上下文並了解目標受眾，才能進行修改。若缺乏上下文，請依 SKILL.md 中的準備步驟操作。

我在哪裡可以找到更多細節？

打開技能目錄的檔案標籤，瀏覽完整檔案結構，包括 SKILL.md 及任何支援腳本或參考資料。