Communitygithub.com

hu-sheng-web/personal-website-skills:作品集預覽閱讀器

在現有封存預覽中,為有序長圖、文件頁面或分階段視覺模組,新增或審查一個無障礙的作品集專案預覽閱讀器,不中斷原本的瀏覽流程。

personal-website-skills:作品集預覽閱讀器 是什麼?

這個技能「作品集預覽閱讀器」專門用來在現有的封存或對話框預覽元件中,以無障礙且不中斷瀏覽流程的方式,展示經過審核的長型專案視覺素材(例如長條圖、文件頁面或階段性模組)。它適用於任何需要以訂閱順序瀏覽多頁內容的作品集網站,並支援桌面與行動裝置。實作時,技能強調必須先檢查現有封存/對話框的狀態模型、文件閱讀器路徑、專案註冊表、素材順序與行動樣式,並避免過度抽象化 — 只在確實有可重複使用的行為時才泛化,否則保持一對一的專案規則。技能還要求保留原有的關閉、ESC、焦點恢復、捲動鎖定與鍵盤行為,且只有在細節頁面可發布時才進行路由,避免暴露錯誤或語意重複的目標。驗證階段需確認所有素材載入、標籤存在、預覽開關運作正常,以及閱讀器寬度在桌面與行動裝置上無水平溢位,並通過型別檢查、程式碼品質檢查與生產建置測試。

相容平台~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/husheng-web/personal-website-skills/tree/HEAD/skills/portfolio-project-preview-reader

在你喜歡的 AI 中提問

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

說明文件

作品集專案預覽閱讀器

在現有封存預覽中,展示經過審核的長型專案視覺素材,同時不中斷周圍的瀏覽流程。

實作前

檢查封存/對話框的狀態模型、現有文件閱讀器路徑、專案註冊表、來源素材順序與行動裝置樣式。僅對確有重複行為的部分進行泛化;當無法證明可重複使用的抽象化合理時,保持一對一的專案規則。

需求

  • 保留宣告的來源順序,並為每個頁面或模組提供無障礙的在地化標籤。
  • 使用一個限制在垂直方向的閱讀表面;不得意外展開頁面或引入水平溢位。
  • 保留預覽對話框既有的關閉、Escape、焦點恢復、捲動鎖定與鍵盤行為。
  • 僅在細節頁面可發布時才路由至該頁面;不得暴露錯誤或語意重複的目標。

驗證

檢查所有素材已載入、有序標籤存在、預覽開啟/關閉功能正常,以及閱讀器寬度在桌面與行動裝置上無水平溢位。程式碼變更後,執行型別檢查、程式碼品質檢查與生產建置測試。

Individual skills in this repo

This repo contains 7 individual skills — each has its own dedicated page.

相關技能