Community程式設計與開發github.com

cbrock84/interface-craft

提升介面的視覺和互動品質——佈局、層級、字體、間距、密度,以及那些能區分精心設計的產品與普通產品的細節。當畫面雖然可用但看起來未完成或過於預設,當佈局顯得擁擠或隨意,當頁面缺乏明確焦點,或當介面需要顯得可信而非只是功能性時,請使用此技能。

interface-craft 是什麼?

此技能專注於透過執行細節來改善使用者介面的品質。它幫助開發人員診斷佈局問題,而不僅僅是重新設定樣式,引導他們先定義畫面的主要用途。技能強調幾個關鍵的品質因素:層級(透過大小、粗細和空間來實現,而非顏色)、間距韻律(相關元素靠近,不相關元素遠離,並使用一致的間距尺度)、字體選擇與設定(限制系列數量,並使用合理的字級與行高),以及表面元素的節制(選擇邊框、陰影或填充之一即可)。此外,它涵蓋密度選擇、狀態處理(載入、空、錯誤、溢位)、暗色模式的正確實作(非單純反白)以及無障礙設計的基本要求(如文字對比度、鍵盤導航、顏色使用限制與減少動畫偏好)。技能最後列出不應做的事項,例如不要為了修飾層級問題而增加視覺重量、不要置中內文、以及不要出貨含書籤狀態卻無對焦狀態的元素。

相容平台~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/cbrock84/headcount/tree/main/plugins/product/skills/interface-craft

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

在你喜歡的 AI 中提問

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

說明文件

介面工藝

多數介面並非敗在構想,而是敗在執行——近乎一致的間距、近乎清晰的層級、近乎正確的字體。

在重新設定樣式前先診斷

問問這個畫面是「為了什麼」。最多一個主要動作,最多一個次要動作。如果你說不出主要動作是什麼,那麼佈局問題其實是產品問題,再多樣式也無法修復。

真正能呈現品質的要素

層級。 觀看者應該在閱讀任何內容之前,就知道該看哪裡。按照大小、粗細、空間的順序來實現。顏色是最弱的層級工具,卻也是最被濫用的。

間距韻律。 相關物件比不相關物件更靠近,且間隙來自同一個尺度。不一致的間距是人們能感受到但說不出來的缺陷。讓鄰近性正確,樸素的佈局也能看起來像經過設計。

字體。 介面使用一個字體家族,頁面上最多兩個。設置一個真實的字級尺度,並使用其中的級距,而非自行發明大小。內文想要舒適的寬度——大約 60–75 個字元——以及隨著寬度增加而增大的行高。

表面元素的節制。 邊框、陰影與填充都會分隔元素。每個邊界只選一種。三者全用就是為什麼介面在正常密度下看起來雜亂的原因。

對齊。 所有東西都與某物對齊。與任何東西都未對齊的元素,即使是有意為之,也會被認為是錯誤。

密度是一項決定

資訊密集的工具與行銷頁面需要相反的處理方式。決定好這是哪一種並堅持到底——進退失據的中間地帶,例如資料表格帶有落地頁的內距,兩者都服務不好。

完成狀態

載入、空、錯誤與溢位,是讓產品感覺未完成的地方。空的狀態是設計機會;沒有上下文的載入圖示則是一種失敗。長字串、長列表以及小螢幕都必須處理,不能只憑運氣。

暗色模式是調色盤,不是反色

將淺色主題反色會產生典型的糟糕暗色模式:純黑背景、純白文字以及毫無作用的陰影。

  • 使用非常深的灰色而非純黑,以及稍微調暗的白色而非純白。兩者之間的極大對比會產生光暈,閱讀起來確實很累人。
  • 層級關係反轉:在淺色主題中,凸起的表面投射陰影;在暗色主題中,它們會變「亮」。在暗色背景上,陰影本身無法傳達任何資訊。
  • 在白色上效果良好的飽和顏色,在暗色上會振動。為暗色調色盤降低飽和度並調亮強調色,而不是直接沿用。
  • 從一開始就在 Token 層級同時定義兩個調色盤。事後補做意味著要審查每一個表面。

無障礙設計基本要求

以下不是潤飾項目——低於這些標準,有些人根本無法使用介面。

  • 文字對比度符合與其實際背景的標準比率,包括圖片上的文字以及彩色按鈕內的文字。
  • 絕不單獨依靠顏色傳達意義。用紅色邊框表示錯誤時,也需要文字或圖示。
  • 每個可互動的元素都能透過鍵盤觸及,順序合理,且有可見的焦點狀態。
  • 觸控目標夠大,能可靠點擊,且相鄰目標之間有間距。
  • 尊重減少動畫偏好:無法停用的動畫會對某些使用者造成真實症狀。
  • 使用真正的語意元素——按鈕就是按鈕,標題依序排列。一個帶樣式的 div 對輔助技術是不可見的。

絕對不要

  • 為了修飾因過多同等元素造成的層級問題而增加視覺重量。應該移除元素。
  • 置中內文。
  • 出貨含有懸停狀態卻沒有對應焦點狀態的元素。

Individual skills in this repo

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

cbrock84/org-design

Designs how an organization is structured — reporting lines, team boundaries, spans and layers, role definition, and workforce planning against the strategy. Use this to structure a new team, restructure an existing one, resolve unclear ownership between teams, plan headcount, or diagnose why a team underperforms for structural rather than individual reasons.

cbrock84/portfolio-governance

Governs the portfolio of work — intake, prioritization, stage gates, resource contention, and stopping things. Use this to set up intake and prioritization, run a stage gate, decide between competing initiatives, resolve resource contention across projects, or work out why everything is in flight and nothing is finishing.

cbrock84/product-launch

Takes something built and gets it into the market — tiering the launch to match what it actually warrants, sequencing internal readiness before external announcement, preparing sales and support to answer the questions it creates, choosing the date for a reason, and measuring adoption rather than announcement reach. Use this to plan a launch, right-size one that is consuming more than it deserves, work out why a released feature nobody uses was launched loudly, or run the weeks after launch day.

cbrock84/program-management

Plans and drives cross-functional programs to delivery — scope, sequencing, dependencies, status, risk, and the escalations that keep work moving. Use this to run a multi-team initiative, recover a program that is slipping, build a delivery plan with dependencies, structure status reporting, or diagnose why cross-team work keeps missing dates.

cbrock84/project-delivery

Plans and delivers a single project — scope, estimation, scheduling, critical path, tracking, and recovering when it slips. Use this to plan a project, build or challenge a schedule, estimate credibly, track progress meaningfully, or recover a project that is late.

cbrock84/retention

Diagnoses and reduces churn — cancellation flows, save offers, failed-payment recovery, at-risk detection, and the product and service causes underneath. Use this when churn is rising or unexplained, to design a cancellation or win-back flow, to recover involuntary churn, to identify at-risk accounts before they leave, or to decide whether a retention problem is a product problem.

cbrock84/sales-enablement

Builds what a sales team needs to sell — pitch decks, one-pagers, objection handling, competitive battlecards, demo scripts, and case studies. Use this to create or fix sales collateral, prepare for a competitive deal, build a demo flow, document objection responses, or diagnose why a pitch is not converting.

cbrock84/tax

Structures the tax questions a growing business faces — corporate income, sales and use, payroll, nexus, and the obligations created by hiring or selling somewhere new. Use this to work out what a new state or country obligates you to, prepare for a tax filing or audit, understand sales tax on your product, or check what a remote hire or new market triggers.

cbrock84/unit-economics

Establishes whether the business makes money on each customer or unit — contribution margin, acquisition cost, payback period, lifetime value, and the cohort behavior underneath. Use this to assess whether growth is profitable, evaluate a channel or segment, support a pricing decision, judge how fast the business can afford to grow, or diagnose why revenue growth is not producing profit.

cbrock84/video-content

Plans and scripts short-form and long-form video, and designs the packaging — titles, thumbnails, and openings — that determines whether it gets watched. Use this to script a video, plan a series, fix retention or click-through problems, design thumbnail and title concepts, or turn written content into video. For a YouTube channel specifically — idea selection, retention teardowns, and channel-level strategy — use `youtube-producer`.

cbrock84/visual-content

Designs and directs the visual assets that carry content — carousels, infographics, quote graphics, diagrams, and social imagery — including the generation prompts where they are AI-produced. Use this to turn a written piece into a visual format, design a carousel or infographic, create social graphics, or fix visuals that are not stopping the scroll.

相關技能