Argus 是做什麼的?
你熟知設計規則。有四種常見的問題會發生,而這項技能針對每一種提供了對應的處理方式:
- 你看不到自己做的東西。 所以你要:建立、查看轉譯結果、修正,然後再次查看。
- 你的第一個點子,往往也是所有人的第一個點子。 所以你要從外部取得輸入:現有內容、使用者說的話、使用者給你的東西。
- 你的判斷力比你的生成力強。 所以做新東西時,先做出粗略的替代方案,然後用看的來選擇。
- 你會傾向於中庸與單薄。 所以新頁面要有一個核心概念、一個大膽的動作,以及一個完整的論述。
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. 循環
- 建立第一個真實版本。
- 查看。 將它轉譯並以 320、390 和 1440 的寬度截圖(對於原生應用,使用手機尺寸的模擬器或裝置)。在再次閱讀程式碼之前,寫下你看到的東西。
- 檢查是否符合
slips.md。執行適用的腳本(請見verify.md)。 - 使用它。 按下主要按鈕、填寫表單、用 Tab 鍵瀏覽、在手機寬度下找到導覽列。
- 修正你發現的問題,然後再次查看。最多兩輪,然後報告還有哪些問題未解決。
如果無法轉譯任何東西,請說明原因,改為檢查原始碼,並且不要將該工作標記為「已驗證」。對於大型工作(一整頁或一個畫面),如果存在子代理,請將螢幕截圖交給一位未看過你推理過程的全新審查者;該審查者的修正視為兩輪中的一輪。
永遠適用的規則
- 誰說了算:使用者的明確指令優先;其次是現有系統;再其次是使用者的回答與參考資料;接著是你寫下的方向;最後才是這項技能中的數字與列表。可及性最低標準不能被任何人的品味(包含你的或這項技能的)所覆蓋。使用者要求的事情絕不能回報為缺陷。
- 誠實的內容。 不使用假文,也不要有虛構的證明:見證、客戶、標誌、評分、使用數據。頁面所需的事實(如價格、試用條款)可以使用合理的替代值,但必須在程式碼註解中標記,並在報告中列出。在展示、型錄或儀表板中的樣本數據,只要是具體的,都很歡迎,並且必須在畫面上標示為「樣本」。
- 重新設計永遠不改變行為。 保留欄位名稱、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.md | UX 法則能做與不能做什麼;常見迷思 |
tells.md | 常見的生成式設計預設值 |
review.md、design-md.md | 評論格式;記錄決策 |
所有檔案都在 references/ 中。
這項技能中的所有路徑(references/...、scripts/...、assets/...)都是相對於包含這個檔案的資料夾,而不是使用者的專案目錄。在 Claude Code 中,該資料夾為 ${CLAUDE_SKILL_DIR}。執行腳本時,請使用完整路徑,例如 node "<此技能的資料夾>/scripts/lint.js" <目標>。