Community程式設計與開發github.com

AndrewTaras/profpak-landing

改善現有的「ПрофПак」著陸頁 HTML 元件。當使用者要求「改善元件 X」、「重構 Y」、「美化 Z」,傳送 HTML 程式碼請求修改,或要求檢查響應式/無障礙性時使用。

profpak-landing 是什麼?

此技能專注於對現有 HTML 元件進行結構化重構與增強,主要應用於「ПрофПак」登陸頁面場景。它提供一套嚴謹的改善優先級流程:從排版強化(使用 Tailwind 類別如 `font-black tracking-tight` 和 `text-balance` 防止孤行)、微動畫添加(如滾動觸發的 `section-reveal` 類別和卡片懸停效果),到響應式檢查(支援 360px、768px、1440px 斷點)、無障礙性(語義化標籤、`aria-label`、焦點樣式)以及效能最佳化(移除未使用 Tailwind 類別、圖片延遲載入與尺寸屬性)。此技能不從零重寫,而是保留原有結構,最終產出包含更新後的 HTML 程式碼、簡潔的變更清單(3-5 項)以及必要的 CSS/JS 程式碼,並以 fenced code block 呈現方便複製。它適用於 Claude Code、Cursor 等 AI 代理開發工具,讓開發者或 AI 代理能夠快速、標準化地提升元件品質。

相容平台~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/AndrewTaras/profpak-landing/tree/HEAD/.agents/skills/refine-component

Installed? Explore more 程式設計與開發 skills: steipete/bluebubbles, steipete/eightctl, steipete/blucli · View all 6 →

在你喜歡的 AI 中提問

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

說明文件

HTML 元件重構

何時應用

  • 使用者提供現有 HTML 並要求改善。
  • 使用者要求檢查元件的響應式、無障礙性、效能。
  • 使用者要求添加動畫、更改排版、增強視覺效果。

流程

  1. 取得元件的目前 HTML。
  2. 取得使用者指定的改善清單。若無指定清單,則依下方優先級處理。
  3. 保留現有結構 — 不要從零重寫。
  4. 回傳更新後的 HTML + 必要的 CSS/JS(如有需要)。

改善優先級(依重要性)

1. 排版

  • 標題:font-heading font-black tracking-tight,尺寸 text-4xl md:text-6xl
  • 文字:leading-relaxed text-slate-600
  • 避免「孤行」— 在必要處使用 text-balance
  • 檢查對比度:深色文字在淺色背景上,淺色文字在深色背景上

2. 微動畫

  • 滾動出現:section-reveal 類別(模板中已存在)
  • 卡片懸停:hover:-translate-y-1 hover:shadow-xl transition-all
  • 按鈕懸停:hover:-translate-y-0.5 transition
  • 圖示懸停:group-hover:scale-110 transition-transform

3. 響應式

  • 檢查 360px:無水平滾動,所有元素可容納
  • 檢查 768px:網格重新排列為 2 欄
  • 檢查 1440px:內容寬度不超過 max-w-7xl
  • 必要時使用 clamp() 設定字體大小

4. 無障礙性 (a11y)

  • 使用語義化標籤而非 <div>
  • 圖示按鈕添加 aria-label
  • 焦點樣式:focus:ring-2 focus:ring-industrial-orange focus:outline-none
  • 所有圖片需有 alt,裝飾性圖示需有 aria-hidden="true"

5. 效能

  • 移除未使用的 Tailwind 類別
  • 確保所有圖片都有 loading="lazy"
  • 為圖片添加 width 和 height(防止 CLS)
  • 不重複 CSS — 使用 Tailwind 工具類別

回覆格式

按以下順序回傳:

  1. HTML 區塊 — 更新後的元件程式碼(包在 ```html 中,方便複製)
  2. 變更清單 — 簡短列出 3–5 項具體改善內容
  3. 額外的 CSS/JS — 若有添加,獨立區塊並標明放置位置

呼叫範例

使用者:

改善 Hero 元件:排版更強勢、子彈點出現動畫、360px 響應式。程式碼:[HTML]

你:

<section>...更新後的程式碼...</section>

變更內容:

  • 標題:加強為 text-5xl md:text-7xl font-black tracking-tight
  • 為子彈點添加 section-reveal,透過 style="animation-delay: Xms" 設定延遲
  • 重新設計子彈點網格為 grid-cols-1 sm:grid-cols-2 md:grid-cols-4
  • 已檢查 360px 下無滾動條
  • 為 CTA 按鈕添加 aria-label

額外 CSS(放於 src/styles/custom.css):

.hero-bullet { animation: reveal .8s ease-out both; }

Individual skills in this repo

This repo contains 1 individual skill — each has its own dedicated page.

相關技能