Communitygithub.com

728188325/frontend-admin-architecture-skill

Codex 技能,用於建立穩定的 React/Vue 前端後台管理架構專案。

frontend-admin-architecture-skill 是什麼?

此技能專為 AI 代理(如 Codex)設計,用於建立或規範化 React + TypeScript 或 Vue 3 + TypeScript 的前端後台管理系統。它能自動偵測專案框架、引導使用者選擇系統 UI 風格與佈局、並產生完整的專案文檔,包括架構文件(docs/architecture.md)與 AI 協作指南(AGENTS.md)。技能提供豐富的內建資源,包含兩種框架的參考架構和通用治理文檔,確保專案從初始化就遵循最佳實踐。工作流程分為五個步驟:確認範圍、讀取對應規範、寫入專案文檔、建立專案結構並說明使用方式。它支援多種視覺風格與佈局選項,但預設保持輕量,除非使用者明確要求,否則不會添加 RBAC、i18n、圖表等過度建設。

相容平台~Claude Code✓Codex CLI~Cursor
npx skills add 728188325/frontend-admin-architecture-skill

在你喜歡的 AI 中提問

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

說明文件

前端後台架構 Skill

這個 skill 用於建立或規範化前端後台管理系統,支援:

  • React + TypeScript
  • Vue 3 + TypeScript

它負責選擇對應框架規範,生成目標專案的 docs/architecture.md 和 AGENTS.md,並在使用者要求時建立基礎專案骨架。

內建資源

按使用者選擇的框架讀取對應資源,不要把另一套框架內容寫入目標專案。

React:

  • references/react/architecture.md
  • assets/AGENTS.react.template.md

Vue:

  • references/vue/architecture.md
  • assets/AGENTS.vue.template.md

通用專案治理文檔:

  • assets/docs/ai-interaction.md
  • assets/docs/karpathy-guidelines.md
  • assets/docs/ui-style.md
  • assets/docs/ui-quality.md
  • assets/docs/design-tokens.md
  • assets/docs/code-style.md
  • assets/docs/security.md
  • assets/docs/comments.md
  • assets/docs/verification.md
  • assets/docs/git-commit.md
  • assets/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 風格必須優先詢問一次,但允許使用者選擇「暫不指定」;使用者未選擇或未編寫自訂風格時,不要替使用者預設具體視覺風格。

  1. 請選擇系統 UI 風格。系統 UI 風格只描述視覺語言、資訊密度和互動氣質,不等同於佈局風格;如果使用者暫不選擇,則 docs/ui-style.md 保持待補充:
    • 經典穩重型:淺色背景、低飽和主色、清晰表格和表單,適合通用企業後台。
    • 極簡清爽型:留白更充足、邊框和陰影更克制,適合輕量 SaaS 和低複雜度管理端。
    • 數據密集型:緊湊表格、高資訊密度、弱裝飾,適合營運、報表、BI、數據管理類後台。
    • SaaS 工作台型:工作區感更強,強調概覽、快捷入口和多租戶/多專案切換,適合 B2B 產品。
    • 科技深色型:深色背景、高對比數據狀態、適度科技感,適合監控、安全、維運和大螢幕相關系統。
    • 金融嚴謹型:克制配色、強表格、明確風險和金金額狀態,適合財報、結算、風控類後台。
    • 政企規範型:藍白基調、層級清晰、表單和審批鏈路規範,適合政企、OA、審批系統。
    • 內容營運型:重視素材預覽、批量操作、狀態標籤和審核流,適合 CMS、內容和行銷營運後台。
    • 工具效率型:強調快捷操作、分欄面板、鍵盤友善和設定效率,適合工具型或設定型後台。
    • 輕量入口型:頂部導航、模組入口清晰、頁面複雜度低,適合模組較少的內部系統。
    • 自訂:使用者用自然語言描述期望的視覺風格、參考產品或設計要求。
    • 暫不指定:不寫入具體風格,保留 docs/ui-style.md 待補充。
  2. 請選擇佈局風格:
    • 經典後台佈局:左側選單 + 頂部欄 + 內容區 + 標籤頁。適合選單層級較多、傳統管理後台,作為預設佈局。
    • 頂部導航型:頂部橫向主導航 + 內容區。適合模組較少、層級較淺、希望頁面更開闊的輕量後台。
    • 混合導航型:頂部一級業務域 + 左側二級選單 + 內容區。適合多業務域後台,例如訂單、財務、系統、內容等模組並存的專案。
    • 圖示窄欄型:左側窄圖示欄 + 展開選單或二級面板 + 內容區。適合工具型後台和希望節省橫向空間的現代 SaaS。
    • 工作台型:頂部產品欄 + 組織/專案切換 + 左側可折疊選單 + 內容區。適合多租戶、多專案、組織切換頻繁的 B2B 系統。
    • 不預設佈局:只保留基礎路由和頁面容器。適合後續由業務或設計稿決定佈局。
  3. 是否包含基礎登入認證。若啟用基礎登入認證,登入頁必須遵守已選擇的系統 UI 風格;若系統 UI 風格暫不指定,則使用 UI 元件庫預設中性風格。
  4. 是否立即安裝依賴並執行驗證。
  5. 是否採用預設方案:不預設系統 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=

相關技能