前端後台架構 Skill
這個 skill 用於建立或規範化前端後台管理系統,支援:
- React + TypeScript
- Vue 3 + TypeScript
它負責選擇對應框架規範,生成目標專案的 docs/architecture.md 和 AGENTS.md,並在使用者要求時建立基礎專案骨架。
內建資源
按使用者選擇的框架讀取對應資源,不要把另一套框架內容寫入目標專案。
React:
references/react/architecture.mdassets/AGENTS.react.template.md
Vue:
references/vue/architecture.mdassets/AGENTS.vue.template.md
通用專案治理文檔:
assets/docs/ai-interaction.mdassets/docs/karpathy-guidelines.mdassets/docs/ui-style.mdassets/docs/ui-quality.mdassets/docs/design-tokens.mdassets/docs/code-style.mdassets/docs/security.mdassets/docs/comments.mdassets/docs/verification.mdassets/docs/git-commit.mdassets/docs/knowledge-capture.md
預設工作流程
第 1 步:確認範圍
如果使用者沒有提供專案路徑,先詢問專案路徑。
如果使用者沒有說明目標框架,先判斷目標路徑是否已有專案:
- 如果存在
package.json,讀取dependencies和devDependencies。 - 出現
react或react-dom時,識別為 React + TypeScript。 - 出現
vue或@vitejs/plugin-vue時,識別為 Vue 3 + TypeScript。 - 如果
package.json不存在,再查看vite.config.*中的框架插件線索。 - 如果同時出現 React 和 Vue,或無法判斷,再詢問使用者。
需要詢問時使用:
請選擇專案框架:
1. React + TypeScript
2. Vue 3 + TypeScript
如果使用者沒有說明「只生成文檔」還是「同時建立專案骨架」,用一個簡短問題確認。
如果使用者要建立或腳手架專案,必須在建立檔案、執行腳手架命令、安裝依賴前確認以下決策。除非使用者明確說「預設方案」、「按預設設定」、「不用問直接預設」或等價表達,否則不要把「新建專案」、「建立專案」、「新建在桌面」、「繼續」等表述理解為採用預設方案。
缺少系統 UI 風格、佈局風格、登入認證或依賴安裝選擇時,先停止執行並用一個簡短問題覆蓋缺少的選項。系統 UI 風格必須優先詢問一次,但允許使用者選擇「暫不指定」;使用者未選擇或未編寫自訂風格時,不要替使用者預設具體視覺風格。
- 請選擇系統 UI 風格。系統 UI 風格只描述視覺語言、資訊密度和互動氣質,不等同於佈局風格;如果使用者暫不選擇,則
docs/ui-style.md保持待補充:- 經典穩重型:淺色背景、低飽和主色、清晰表格和表單,適合通用企業後台。
- 極簡清爽型:留白更充足、邊框和陰影更克制,適合輕量 SaaS 和低複雜度管理端。
- 數據密集型:緊湊表格、高資訊密度、弱裝飾,適合營運、報表、BI、數據管理類後台。
- SaaS 工作台型:工作區感更強,強調概覽、快捷入口和多租戶/多專案切換,適合 B2B 產品。
- 科技深色型:深色背景、高對比數據狀態、適度科技感,適合監控、安全、維運和大螢幕相關系統。
- 金融嚴謹型:克制配色、強表格、明確風險和金金額狀態,適合財報、結算、風控類後台。
- 政企規範型:藍白基調、層級清晰、表單和審批鏈路規範,適合政企、OA、審批系統。
- 內容營運型:重視素材預覽、批量操作、狀態標籤和審核流,適合 CMS、內容和行銷營運後台。
- 工具效率型:強調快捷操作、分欄面板、鍵盤友善和設定效率,適合工具型或設定型後台。
- 輕量入口型:頂部導航、模組入口清晰、頁面複雜度低,適合模組較少的內部系統。
- 自訂:使用者用自然語言描述期望的視覺風格、參考產品或設計要求。
- 暫不指定:不寫入具體風格,保留
docs/ui-style.md待補充。
- 請選擇佈局風格:
- 經典後台佈局:左側選單 + 頂部欄 + 內容區 + 標籤頁。適合選單層級較多、傳統管理後台,作為預設佈局。
- 頂部導航型:頂部橫向主導航 + 內容區。適合模組較少、層級較淺、希望頁面更開闊的輕量後台。
- 混合導航型:頂部一級業務域 + 左側二級選單 + 內容區。適合多業務域後台,例如訂單、財務、系統、內容等模組並存的專案。
- 圖示窄欄型:左側窄圖示欄 + 展開選單或二級面板 + 內容區。適合工具型後台和希望節省橫向空間的現代 SaaS。
- 工作台型:頂部產品欄 + 組織/專案切換 + 左側可折疊選單 + 內容區。適合多租戶、多專案、組織切換頻繁的 B2B 系統。
- 不預設佈局:只保留基礎路由和頁面容器。適合後續由業務或設計稿決定佈局。
- 是否包含基礎登入認證。若啟用基礎登入認證,登入頁必須遵守已選擇的系統 UI 風格;若系統 UI 風格暫不指定,則使用 UI 元件庫預設中性風格。
- 是否立即安裝依賴並執行驗證。
- 是否採用預設方案:不預設系統 UI 風格 + 經典後台佈局 + 基礎登入認證 + 不立即安裝依賴。
只有當使用者明確採用預設方案時,使用這些預設值:
- 套件管理員:pnpm。
- 登入認證:預設包含基礎 token 登入骨架。
- 佈局:預設包含經典後台佈局。
- 系統 UI 風格:預設不預設;
docs/ui-style.md保持待補充,由後續業務或設計要求補齊。 - 依賴安裝:預設不執行
pnpm install、pnpm add、pnpm dev、pnpm lint、pnpm typecheck、pnpm build,只寫入依賴宣告、專案檔案和後續命令。 - React 預設棧:Vite、React、TypeScript、Ant Design、React Router、Axios、TanStack Query、Zustand。
- Vue 預設棧:Vite、Vue 3、TypeScript、Composition API、`<script setup lang=