Communitygithub.com

tsvetaeff-den/ai-ready-sites

設計、構建、改進或審查網站與網頁介面;撰寫或編輯網站文案、產品說明與技術文件,包括中/英翻譯。適用於登陸頁面、產品 UI、響應式元件、重新設計與就緒檢查。將範圍限於純文字工作、小型修正與審查。不適用於純後端實作或原生應用程式。

ai-ready-sites 是什麼?

這是一個自包含的網站與介面建置技能,無需依賴外部設計引擎或全域指令即可運作。它涵蓋從規劃與討論、全新網站設計、小型元件修復、稽核審查、動畫處理、文案撰寫編輯、技術文件編寫,到多語言翻譯(英文/繁體中文)等完整工作流程。技能內建詳細的參考指南(如 UX 設計、實作、瀏覽器 QA、品質、運動、文案、技術寫作與完成標準),並支援透過真實瀏覽器驗證行為、使用可選的 Node.js 輔助腳本進行環境檢查。其核心設計哲學是提供實際、有範圍、以事實為基礎的工作成果,不允許無中生有(如假造客戶推薦、效能數據或後端),並要求在每次交付時附上具體的變更清單與驗證證據。此技能可攜帶至任何具備基本工具的主機環境,不綁定特定作業系統、框架或 API 金鑰。

相容平台✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/tsvetaeff-den/ai-ready-sites/tree/HEAD/skills/ai-ready-sites

在你喜歡的 AI 中提問

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

說明文件

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、二進位檔、付費服務或自動更新程式。

相關技能