Taste Engine — 風格路由器
一個通用流程,多種獨立風格 — 具備反程式碼污染、條件式公開 SEO 及可選的風格對齊動作。 Taste Engine 控制何時提問、載入哪個選定的風格套件,以及如何強制執行它。引擎本身沒有內建美學。styles/*.md 中的風格套件包含實際的設計說明。
材質保真度(選定風格)— 螢幕截圖等級合約
選定的視覺美學必須從渲染的介面中可辨識,而不僅僅在標題或 CSS 變數名稱中陳述。當選定 glassmorphism 時,載入 styles/glassmorphism.md 並套用其強制性的玻璃材質保真度閘道:真實可見的磨砂/染色面板過濾差異化的背景光、可讀的反射/邊緣,以及可存取的備援方案。扁平的海軍藍英雄區塊加上藍色 CTA 不是玻璃形態。使用 tests/glassmorphism-visual.md 進行驗收檢查,並使用 examples/glassmorphism/frosted-surfaces.css 作為起始配方。請勿將此特定於玻璃的檢查套用於其他風格;每種美學都保留其自身的要求。
玻璃形態特定的漸層例外
當選定玻璃形態時,有目的的 CSS 漸層背景、環境光場和受控的柔和色彩形狀是明確允許的,因為它們使半透明磨砂效果和深度可見。請勿移除這些以滿足一般的反漸層警告。閱讀 styles/glassmorphism.md(「明確的背景漸層例外」)並驗證第一個視口顯示一個真實的面板過濾其差異化的背景。此例外僅適用於選定的材質,且絕不覆蓋可用性、真實性、可存取性或使用者限制。
自動呼叫:零指令合約
- 這是一個任務觸發的技能,而非僅限斜線指令的工作流程。支援自主代理技能的已安裝代理應在作品集、網站、應用程式、儀表板、登陸頁面和 UI 重新設計請求上發現上述元資料 — 即使使用者從未提及「taste-engine」。
- 一旦被呼叫,在進行任何 UI 程式碼之前,套用自動呼叫合約。實際平台決定是否呼叫該技能;此文件無法建立作業系統層級的鉤子或保證在每個主機上合規。
- 隱含風格選擇:「幫我建立一個作品集網站」→ 詢問一個簡潔的風格問題,然後結束回合。切勿在同一回合中詢問使用者無關的細節。
- 明確風格選擇:「建立一個 skeumorphsm 風格的作品集網站」→ 將拼寫錯誤標準化為
skeuomorphism,閱讀styles/skeuomorphism.md,然後建立。不要執行問題選單。 - **既有專案:**經批准的專案配置或已記錄的品牌/風格對於增量工作優先於通用預設值;不要用選單打斷。
- **非前端工作:**API 實作、偵錯商業邏輯、資料庫遷移、基礎設施、純寫作任務 → 不要啟動風格選擇器。
工程伴侶 — 條件式且具框架感知能力
一旦視覺風格問題解決(或針對既有系統/非視覺工作跳過),套用工程路由器。每個網頁 UI 都會獲得通用的網頁介面品質 閘道;React/Next 在堆疊和任務合理時獲得 React 效能 和可選的 React 組合。React Native/Expo 工作獲得原生行動,而非網頁 SEO。導航動畫在相容性檢查後可使用視圖轉換,或在真正有用時使用可選的 Anime.js。文件撰寫任務獲得文件撰寫,而無需視覺風格選擇器。
這些是本地原始整合,而非匯入的 Vercel 外掛程式。它們總結了從上游研究中學到的工程實踐。切勿假設已安裝上游技能,切勿要求 React,切勿在沒有明確部署意圖的情況下部署,也不要讓技術指導覆蓋使用者的美學。核心的預檢、全螢幕英雄、SEO、反程式碼污染和風格感知動作保持不變。請參閱工程路由測試。
全螢幕英雄 — 相關時強制執行
在風格選擇之後,對於任何新的公開作品集、登陸頁面或帶有英雄區塊的首頁,載入全螢幕英雄合約。預設為一可見螢幕的頁首 + 英雄組合:使用行動裝置安全的 min-height: 100svh(附 100vh 備援)並減去實際的正常流頁首高度,或在頁首覆蓋其上時使用全高英雄。請勿盲目套用 100vh:固定高度可能會裁剪文字和工具列變更的行動視口。保持內容和 CTA 在窄/短螢幕上可用;允許在縮放/大字型時自然增長和滾動。遵循選定風格的 ## 英雄組合(完整的第一視口) 指引和共享的反程式碼污染檢查。請勿為了填滿螢幕而憑空發明圖像、徽章、虛假統計或循環動畫。
此規則不會將行銷英雄區塊強制套用於私有儀表板、表單、應用程式工作區或未建立/重新設計英雄區塊的增量編輯。使用者對緊湊英雄或無英雄的明確選擇優先。當風格已建立時,不需要額外的風格選擇問題。
Anime.js v4 動作引擎 — 可選且具風格感知能力
對於明確的 UI 微互動請求,或在建立一個確實能從額外動畫中受益的選定風格時,載入動作引擎轉接器 和所選風格的 ## 動作 指引。動作永遠不會成為新的美學選擇器,且永遠不需要第二次訪談。像 Tambahkan micro-interaction di dashboard ini 這樣的請求會保留既有專案風格,並且無需風格問題即可運作。如果專案沒有選定的設計語言,且使用者正在建立新的 UI,則原始的單一問題預檢仍然是強制性的。
不安裝自動依賴項。 首先檢查現有堆疊。對於簡單的轉場,偏好 CSS/原生瀏覽器能力;僅在 Anime.js v4 能有意義地簡化協調動作或被明確要求時才考慮它。對於 React/Next,使用 createScope() + 生命週期清理;對於偏好減少動畫的使用者,在保持互動功能性的同時停用非必要的效果。不要強制使用彈跳、循環或無意義的交錯。風格映射在 styles/motion-profiles.json 中;React 配方在 examples/react/anime-v4-press.jsx 中。非網頁/原生應用應改用其平台動作 API。
跨風格 SEO:自動且條件式
SEO 不是一種風格選擇。 對於一個新的或經過大幅重新設計的公開網站(作品集、登陸頁面、部落格、公開商業網站、公開文件或公開產品頁面),在視覺風格選擇之後載入 SEO 整合,並在需要時載入 SEO 實作配方。將技術 SEO + 反程式碼污染內容套用於每個選定的風格,無需將「你想要 SEO 嗎?」作為第二個問題來詢問。SEO 永遠不會改變選定的材質美學。
- 明確風格:「建立一個 Skeuomorphism 作品集」→ 閱讀
styles/skeuomorphism.md+references/seo.md,無需風格問題,然後實作。 - 缺少風格:「建立一個作品集網站」→ 詢問恰好一個風格問題並停止。在回答之後,載入風格 + SEO 並實作。不要僅僅為了撰寫元資料而繞過預檢。
- 純 SEO:「稽核我網站上的 SEO」/「修正標準網址和網站地圖」→ 立即閱讀 SEO 模組,無視覺風格訪談且無未經要求的重新設計。
- **私有/內部應用程式:**保持機密性和現有的可索引性;不要產生公開的網站地圖或揭露私有路由。原生行動/純後端任務不屬於一般網頁 SEO 範圍。
- **未知網域:**不要捏造即時 URL、作者身份、結構化資料、評論或頁面內容;安全地實作語意/標題並報告哪些內容仍待處理。
SEO 和風格共享 FLOOR / REFLEX / FINISH 閘道;隱私、真實內容、可存取性和功能性行為優先於美學和搜尋偏好。請參閱 SEO 驗收情境。可選的獨立 taste-seo 技能適用於僅 SEO 的安裝;路由器使用者無需單獨安裝它。
嚴格要求:在新視覺實作之前進行預檢
對於引入或大幅重新設計視覺 UI 的任務,在視覺方向解決之前,請勿撰寫 UI 程式碼、產生介面模型或更改設計權杖。
- 檢查目前使用者的請求、既有產品品牌/設計系統,以及明確批准的專案風格配置。
- 如果風格已經明確選定(例如,「野獸派儀表板」),不要再問。如果有用,用一行短文確認並載入該風格套件。
- 如果既有專案具有明確建立的風格,且使用者要求增量變更,請保留它;不要用新的選擇打斷。重新設計請求可以覆蓋已建立的風格。
- 否則,詢問恰好一個簡潔的風格選擇問題並停止。 提供 6 個對比選擇和「更多風格 / 自訂 / 發送參考」。不要默默選擇一種風格、在等待回覆時開始編碼,或詢問多問題的訪談。
- 當使用者回答時,透過註冊表解析風格 ID,閱讀僅選定的套件,推導專案特定的權杖/決策,然後執行。使用者提供的形容詞或參考可能需要解釋風格特徵,而不是強制使用預設值。
- 如果工具執行器無法暫停等待使用者輸入,請報告未解決的選擇,不要捏造同意。明確指示使用自主最佳努力預設值可能授權臨時風格;將其標記為臨時且可撤銷。
強制性的第一個問題(印尼語範例)
在我開始設計之前,您想要哪種視覺風格?
- Claymorphism — 柔和、觸感、深度柔和
- Glassmorphism — 透明、分層、現代
- Brutalism — 強烈字體、原始網格、高對比
- Neo-brutalism — 大膽色彩、邊框和硬陰影
- Minimalism — 乾淨、簡單、專注內容
- Swiss / Editorial — 精確網格、主導字體 或輸入其他、自訂,或發送參考。
適應使用者的語言。保持為單一問題;描述區別,但不要宣稱其中一個「最好」。對於長選單,先呈現六個選項,並提供查看其餘選項的方式。如果使用者想要範例,在選擇前顯示選項。如果使用者要求互動式選擇器且代理支援,則將相同選擇呈現為 UI 控制項。
可用的風格套件
在比對 ID、別名、常見拼寫錯誤和描述時,閱讀 styles/registry.json。標準化標點符號、連字號和大小寫;尊重否定的風格提及(「不要玻璃形態」)和上下文。在可用時,python3 scripts/style_probe.py --prompt "..." 可以提供確定性的風格提示;語意解釋和專案上下文仍然優先。不要按名稱呼叫獨立的風格技能:閱讀選定的本地 styles/<id>.md 檔案,這是已安裝路由器的一部分。內建套件:
| ID | 方向 | 選定後要載入的檔案 |
|---|---|---|
claymorphism | 雕刻觸感 | 風格套件 |
glassmorphism | 半透明分層 | 風格套件 |
brutalism | 原始結構化 | 風格套件 |
neo-brutalism | 俏皮大膽 | 風格套件 |
minimalism | 克制清晰 | 風格套件 |
swiss-editorial | 字體排版網格 | 風格套件 |
bento | 模組化磁貼 | 風格套件 |
skeuomorphism | 實體控制隱喻 | 風格套件 |
retro-terminal | 主控台美學 | 風格套件 |
enterprise | 工作流程/資料優先 | 風格套件 |
**自訂是一等公民:**如果所選的美學不在註冊表中,收集簡短的參考或限制,然後使用相同的維度建立一個臨時的專案特定風格定義。切勿將風格錯誤標記為不存在的套件。選擇不需要外部網際網路存取。
路由器狀態
needs-selection:新的視覺工作;未選擇/確認方向。詢問一個風格問題並停止。ready:風格或既有品牌明確建立;載入相關套件並實作。refine:既有 UI 中的小幅變更;保留風格,僅修改必要的權杖/元件。custom:使用者選擇混合、提供螢幕截圖,或要求未指定的風格;映射到相同的設計維度,並僅確認重要的歧義。non-visual:後端、測試、文件、錯誤修復,無需視覺決策;完全跳過設計選擇。
詳細路由、混合和衝突規則:風格路由器。關於自主發現、風格別名、主機限制和確切範例記錄,請參閱自動呼叫。
選擇後套用風格
- **提取需求:**產品、受眾、裝置、框架、既有品牌、明確的喜好/厭惡、可存取性、效能。
- 僅載入選定套件(以及所需的共享參考)。不要混合來自未選取套件的隨機規則。
- **風格 ≠ 結構:**從真實的使用者目標推導產品流程和頁面內容,而選定的套件決定視覺材質。在編碼之前...