clarify

概覽

clarify 是什麼？

clarify 技能旨在協助 UI 與 UX 團隊識別並改善不清楚或令人困惑的介面文字，包括錯誤訊息、微文案、標籤與說明，避免阻礙使用者理解。透過系統性檢視與重寫這些元素，clarify 確保您的產品能清晰且有效地與使用者溝通。

誰適合使用 clarify？

clarify 非常適合產品設計師、UX 撰稿人、UI 開發者，以及任何負責介面文字的人員。如果您的使用者常因標籤模糊、說明不明確或錯誤訊息令人困惑而苦惱，這項技能提供結構化的方法來提升清晰度與可用性。

clarify 解決的問題

• 介面文字中不清楚或過於專業的術語
• 模稜兩可或誤導性的說明
• 微文案中不一致的語氣或風格
• 令人困惑而非幫助的錯誤訊息
• 讓使用者摸不著頭緒的標籤與提示

使用說明

安裝步驟

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

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

2. 從 SKILL.md 檔案開始，了解 clarify 的工作流程與需求概覽。

3. 閱讀相關檔案如 README.md、AGENTS.md 和 metadata.json，以獲得更多背景與整合細節。

工作流程指引

• 必要準備：
  • 變更前，先執行 /frontend-design 以收集設計原則與背景資訊。如無設計背景，請先執行 /teach-impeccable。
  • 收集目標使用者的技術程度及其使用介面時的心理狀態。
• 評估現有文案：
  • 識別術語、模糊、被動語態、冗長、假設、缺乏背景或語氣不符等問題。
  • 了解使用者對每個介面元素的目標、行動與限制。
• 規劃與改進：
  • 根據對使用者的影響優先處理需修訂的文案。
  • 重新撰寫文字，使其清晰、簡潔且適合目標受眾與情境。
  • 盡可能與真實使用者測試修訂後的文案。

建議檢視的檔案

• 先從 SKILL.md 了解 clarify 的流程概述。
• 探索其他支援檔案以深入整合與最佳實踐。

常見問題

什麼時候應該使用 clarify 技能？

當您發現使用者對介面文字、錯誤訊息或說明感到困惑，或想主動提升 UX 撰寫品質時，皆可使用 clarify。

clarify 會改變程式碼還是僅修改文字？

clarify 專注於改善介面文字與微文案，不會更動後端邏輯或應用程式程式碼。

使用 clarify 前需要做哪些準備？

您必須收集設計背景並了解目標使用者。請使用 /frontend-design，如有需要，先執行 /teach-impeccable，確保具備所有必要資訊後再編輯文案。

哪裡可以找到 clarify 工作流程的詳細說明？

請參閱 clarify 技能目錄中的 SKILL.md 檔案，內含完整逐步指南。欲了解更多資源，請查閱倉庫中的相關文件與腳本。