AI-Ready Sites
一個自包含的網站與介面技能。本技能所需的全部指引均已包含在此處。請勿載入其他已安裝的技能、呼叫外部設計引擎,或要求全域指令來遵循此工作流程。請使用主機提供的工具以及專案中已適當依賴的元件。可選的外部工具可增強驗證,但其缺失不會阻礙設計或實作。
從使用者的階段開始
檢查請求、適用的專案指示、技術棧、現有元件以及相關的產品/設計文件。對於變更,請檢查現有實作與可用的渲染 UI。簡短地識別出結果以及最簡單有用的路徑。使用者的簡要說明與專案慣例主導視覺選擇。缺少 DESIGN.md 不代表獲得重新設計的許可。
| 請求 | 閱讀與執行 |
|---|---|
| 規劃或討論 | 簡要與 UX,然後相關的設計指引;傳遞計畫,除非要求否則不變更專案檔案 |
| 全新網站或大幅重新設計 | 簡要與 UX → 設計 → 實作 → 瀏覽器 QA 與適用的品質 → 完成 |
| 小型元件或 UI 修正 | 檢查受影響的範圍;僅使用相關的設計/實作指引、聚焦的瀏覽器檢查與必要的專案檢查 |
| 僅稽核/審查 | 相關的設計/品質/瀏覽器指引;收集證據並報告優先排序的發現;請勿編輯受稽核的專案 |
| 動畫 | 運動、受影響的 UI 與減少動畫驗證 |
| 網站或介面文字 | 網站與介面文案 與 編輯審查;在所請求的範圍內撰寫或編輯 |
| 說明或技術文件 | 技術寫作 與編輯審查;驗證相關程序,無需建立網站 |
| 英/繁中編輯或翻譯 | 編輯審查,加上相關的文案/文件指南;保留事實、可執行文字與實際 UI 標籤 |
| 準備好發佈? | 完成、目前的瀏覽器證據與必要的專案檢查;不包含部署 |
需要時再載入參考資料,不要一次全部載入。這是能力的選擇,而非強制的順序。重複使用有效的證據;不要在名稱不同的情況下重複等效的審查。
交付有用的工作
- 對於新工作,將產品事實轉化為連貫的方向,並在擴展之前完成一個可運作的用戶旅程。對於改進,保留範圍之外的現有身份與行為。對於重新設計,在更改所請求的視覺系統時,保留產品事實與必要功能。
- 使用真實內容與可運作的控制項進行建置。標記示範資料、本地模擬與不可用的整合。請勿捏造客戶推薦、效能聲明、價格或可運作的後端。
- 在撰寫或編輯文案時,使用相關的文字指南。保留事實、條件、命令與目前的 UI 標籤。改善清晰度與實用性;不要為了最佳化作句偵測器分數而最佳化。純文字工作不會觸發設計或瀏覽器階段,除非所請求的聲明需要它們。
- 讓文字、表單、導覽與狀態在預期的螢幕上可用,並具備鍵盤與輔助技術語意。設計抱負符合表面:表現力的行銷、精確的任務 UI、可讀的編輯內容,或由工作本身主導的體驗。
- 透過在真實瀏覽器中觀察結果來確認行為。檢查螢幕截圖以驗證視覺聲明;原始碼、成功的點擊與成功的建置並不能證明渲染的結果。
- 如果工具、驗證、資產或執行時期先決條件不可用,請完成獨立工作並說明具體缺少的檢查。請勿捏造 PASS、安裝不相關的工具,或默默地替換用戶的技術棧。
- 將工作保留在授權範圍內。建立網站並不授權發佈、真實表單提交、付費服務或生產環境變更。繼續進行日常的授權工作,無需重複的批准請求。
工具與可攜帶性
相對於此 SKILL.md 解析每個參考/腳本。不需要個人路徑、特定作業系統、外部技能名稱、API 金鑰、框架或託管帳戶。瀏覽器 QA 涵蓋工具探索、無瀏覽器行為以及可選的內建輔助工具。Chrome DevTools 與 Playwright 是套件內部的說明,而非對其他技能的依賴。
包含的可選 Node 輔助工具。無需安裝任何東西,scripts/doctor.mjs 即可回報基本的本地能力;當 Playwright 與瀏覽器已存在時,scripts/browser-check.mjs 執行有限度的冒煙測試。從它們的 --help 開始。僅使用主機工具閱讀並使用此技能無需 Node 執行時期。
以證據結束
首先報告變更的表面或稽核結果,然後是實際執行的檢查、相關的產出物與限制。對於重大交付,使用專案的慣例儲存簡潔的 QA 證據。對於小型修正,最終回覆可能足夠。當檢查無法執行時,標示 NOT RUN;保留 release PASS 用於實際上已通過且無已知封鎖器的必要檢查。完成 定義了報告與驗收邊界。
歸因記錄為 THIRD_PARTY_NOTICES.md;它是來源證明,而非執行時期指示。未捆綁任何上游 CLI、二進位檔、付費服務或自動更新程式。