Communitygithub.com

Argus

設計技能。用於設計、構建、重塑、打磨或審查任何框架中的網站與行動應用程式畫面——包括著陸頁、儀表板、應用畫面、元件、表單、設計系統。適用於任何需要創造或改變視覺內容的請求。

Argus 是什麼?

Argus 是一項專門為 AI 代理(如 Claude Code)設計的 UI/UX 設計技能,旨在協助開發者與設計師建立、審查與改進網頁與行動應用程式的視覺介面。它涵蓋了從細微調整(如一個元件的間距或顏色修正)到全新頁面或應用程式畫面的完整設計流程。 該技能的核心是一套結構化的工作流程,包括:先檢視現有系統(平台、表面類型、設計系統與使用者提供的素材),然後根據任務類型選擇對應的路徑(如調整、新畫面、重新設計)。對於全新工作,它會引導使用者提出關鍵問題(如目標受眾、期望的視覺風格),並透過「建立 → 檢視 → 檢查 → 使用 → 修正」的反覆運算循環來確保品質。 Argus 特別強調:不使用假文或虛假數據(測試用樣本數據除外)、不改變既有行為(如表單欄位名稱、連結、可及性屬性)、必須實作所有可能狀態(按下、停用、懸停、載入、空值、錯誤),並遵循 WCAG 最低可及性標準(如文字對比度 4.5:1、可視鍵盤焦點、觸控目標 44pt/48dp)。 此技能支援 Web、iOS 與 Android 平台,並內建多個參考文件(如 `craft.md`、`laws.md`、`slips.md`)來提供具體的設計規則、數字標準與常見錯誤檢查清單,確保輸出的品質一致性。對於大型專案,它還支援透過子代理進行獨立審查,以獲得更客觀的反饋。

相容平台✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/Hamza-Masuadi/argus-skill/tree/HEAD/skills/argus

在你喜歡的 AI 中提問

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

說明文件

Argus 是做什麼的?

你熟知設計規則。有四種常見的問題會發生,而這項技能針對每一種提供了對應的處理方式:

  1. 你看不到自己做的東西。 所以你要:建立、查看轉譯結果、修正,然後再次查看。
  2. 你的第一個點子,往往也是所有人的第一個點子。 所以你要從外部取得輸入:現有內容、使用者說的話、使用者給你的東西。
  3. 你的判斷力比你的生成力強。 所以做新東西時,先做出粗略的替代方案,然後用看的來選擇。
  4. 你會傾向於中庸與單薄。 所以新頁面要有一個核心概念、一個大膽的動作,以及一個完整的論述。

1. 查看現狀

在做任何事前,先找出並用一句話陳述:

  • 平台:網頁,或行動應用(iOS、Android、兩者)。閱讀專案文件,絕不預設。
  • 表面:說服用(行銷、著陸、櫥窗)、操作用(儀表板、工具、後台、應用畫面)或閱讀用(文件、文章)。
  • 現有系統:DESIGN.md、主題或 token 檔案、共用元件、兩三個已完成的畫面。
  • 使用者提供的素材:螢幕截圖、連結、標誌、品牌顏色、字型、照片。

使用專案既有的框架與慣例來實作。

2. 選擇唯一適合的路徑

使用第一個符合條件的那一行。只閱讀它指定的檔案。

任務要做的事閱讀的檔案
一個小調整:一個元件、間距或顏色修正直接修改並查看。不問問題,一行報告不需要,或只讀 craft.md 中相關的部分
一個具名指令(polish、audit、typeset、colorize、animate、simplify、variants)遵循該指令references/commands/<名稱>.md 及其指名的檔案
「審查這個」或「評論這個」撰寫報告,不修改任何東西review.md、laws.md、verify.md
「讓這個更好看」、「看起來很普通」,針對某個現有物件找出真正問題所在,然後在現有外觀內修正extend.md 的第三節,然後是 commands/polish.md;如果只有一個明顯弱點,則用對應的指令
在已有外觀的專案中新增畫面或元件延伸。不提供方向指引,不問問題extend.md;再加上 product.md(針對操作表面),mobile.md(針對原生應用)
新的操作表面,且沒有任何可對照的現有內容詢問簡報是否開放,然後建立ask.md、product.md、craft.md;如果是原生應用則加上 mobile.md
新的說服或閱讀表面,且沒有任何可對照的現有內容詢問簡報是否開放,然後執行完整流程ask.md、create.md(它會引入 structures.md 和 ingredients.md)、web.md 或 mobile.md;如果圖片是銷售主力或使用者有提供照片,則加上 photos.md
使用者明確要求的重新設計視為新工作,但保留內容與行為對應新工作那一行的檔案,再加上 extend.md 的第一節來盤點哪些東西必須保留

每一條會建立東西的路徑最後都要進入下面的循環,並使用 slips.md 和 verify.md。只有小調整只需要「看」一次。

改變一個既存產品的品牌識別需要明確的授權。如果沒有,那麼「讓它更突出」的意思是:在現有外觀內做得更好。

3. 詢問(僅限新工作)

當需求說明中對於「目標對象是誰」、「應該傳達什麼感覺」或「使用者有什麼素材可以提供」留下模糊空間時,在開始設計前先發問:只有一輪,最多四個關於產品的問題,每個問題都可以跳過,且不涉及字型或顏色。如果是新頁面,還要問第一個畫面應該圍繞什麼來建立(你針對這個主題提出的三個方案),以及他們想同時看到幾個方向(1 個、3 個或 5 個,建議 3 個)。這些問題在 ask.md 中。跳過那些已在需求說明或 DESIGN.md 中回答的問題。

如果沒有人可以回答,就陳述你的每個假設,然後繼續進行。絕不要陷入等待循環。

4. 循環

  1. 建立第一個真實版本。
  2. 查看。 將它轉譯並以 320、390 和 1440 的寬度截圖(對於原生應用,使用手機尺寸的模擬器或裝置)。在再次閱讀程式碼之前,寫下你看到的東西。
  3. 檢查是否符合 slips.md。執行適用的腳本(請見 verify.md)。
  4. 使用它。 按下主要按鈕、填寫表單、用 Tab 鍵瀏覽、在手機寬度下找到導覽列。
  5. 修正你發現的問題,然後再次查看。最多兩輪,然後報告還有哪些問題未解決。

如果無法轉譯任何東西,請說明原因,改為檢查原始碼,並且不要將該工作標記為「已驗證」。對於大型工作(一整頁或一個畫面),如果存在子代理,請將螢幕截圖交給一位未看過你推理過程的全新審查者;該審查者的修正視為兩輪中的一輪。

永遠適用的規則

  • 誰說了算:使用者的明確指令優先;其次是現有系統;再其次是使用者的回答與參考資料;接著是你寫下的方向;最後才是這項技能中的數字與列表。可及性最低標準不能被任何人的品味(包含你的或這項技能的)所覆蓋。使用者要求的事情絕不能回報為缺陷。
  • 誠實的內容。 不使用假文,也不要有虛構的證明:見證、客戶、標誌、評分、使用數據。頁面所需的事實(如價格、試用條款)可以使用合理的替代值,但必須在程式碼註解中標記,並在報告中列出。在展示、型錄或儀表板中的樣本數據,只要是具體的,都很歡迎,並且必須在畫面上標示為「樣本」。
  • 重新設計永遠不改變行為。 保留欄位名稱、ID、連結、事件處理程式、表單動作、測試鉤子與可及性屬性。
  • 建立所有可能發生的狀態,而且全部都要做出來。按下與停用狀態一定要有;任何有指標或鍵盤的地方都要有懸停與鍵盤焦點狀態。在會載入真實資料、可能為空白或可能失敗的地方,都要有載入、空白與錯誤狀態。絕對不要只是為了擁有載入狀態而建立一個網路請求。
  • 可及性最低標準:文字對比度 4.5:1;可見的鍵盤焦點;控制項至少 24px,觸控螢幕上為 44pt / 48dp;提供減少動畫模式;文字放大時不遺失任何內容。craft.md 中有具體數字,laws.md 中有精確標準。
  • 驗證過意味著被看過。

報告

發現:     平台、表面、現有系統、使用者提供的素材
方向:     一句話(新工作),或哪些被重複使用、哪些是新加的(延伸工作)
查看:     轉譯了哪些東西、在哪些寬度下、用手機實際操作了哪些
修正:     循環中發現了什麼
假設:     替代事實與樣本數據,依種類列出,或寫「無」
未解決:   哪些還沒做或沒檢查,以及任何指南說要標記的事項

只保留這幾行。小調整只需要一行。

檔案

檔案內容
ask.md提問回合
create.md新的說服與閱讀工作:概念、大膽動作、粗略替代方案、方向
structures.md可供選擇的頁面結構,使替代方案在形狀上有所不同,而不僅僅是顏色
ingredients.md每個方向都要填入的 token 角色,以及顏色、字體、形狀與空間的選項
extend.md在現有外觀內工作
product.md操作表面:儀表板、工具、應用畫面
photos.md以照片為主導的頁面
web.md、mobile.md網頁頁面或手機螢幕上的東西該放哪裡
slips.md實際發生過的錯誤,按表面分類。每次查看時檢查
verify.md如何截圖、檢查與審查;輔助腳本
craft.md所有數字:字體、顏色、間距、動畫、觸控目標
laws.mdUX 法則能做與不能做什麼;常見迷思
tells.md常見的生成式設計預設值
review.md、design-md.md評論格式;記錄決策

所有檔案都在 references/ 中。

這項技能中的所有路徑(references/...、scripts/...、assets/...)都是相對於包含這個檔案的資料夾,而不是使用者的專案目錄。在 Claude Code 中,該資料夾為 ${CLAUDE_SKILL_DIR}。執行腳本時,請使用完整路徑,例如 node "<此技能的資料夾>/scripts/lint.js" <目標>。

相關技能