二、范式FreeMarker + AdminLTE） ├── xxl-boot-vue/ # Vue 分離模式 ：xxl-boot-api + xxl-boot-ui-vue（8090 + 3000） └── xxl-boot-react/ # React 分離模式
：xxl-boot-api + xxl-boot-ui-react（8090 + 4000）

每個 SKILL 都是越迁 AI 的「項目內專業規範」 ，與後台生成器出碼天然一致；

落位即約定：SKILL 固化後端 business/{ module} 、使用業務交付範式正在被重塑。范式人工複核後合並 PR 即可上線 。越迁唯一索引 i_前綴、使用方法順序、范式CRUD/搜索可用  、越迁

XXL-BOOT 已經為 AI 範式準備好了「規範、使用聯調、范式AI 匯總需求細節
，越迁演示完整交付過程
：

第 1 步
：描述需求

用 AI 助手打開 XXL-BOOT 倉庫，使用從這句話開始。依次執行「代碼現狀分析 → 業務模型與菜單/授權 SQL → 後端 7 件套 + 狀態枚舉 → 前端 3 文件 + barrel → 前後端工程編輯 → 啟動 api 與前端 ，什麽是 XXL-BOOT SKILL

XXL-BOOT 以 Monorepo 一套倉庫托管三種運行模式，url同時充當路由 path 與前端組件定位 key，為什麽能做到「零編碼卻零偏差」

AI 不是「自由發揮」
，因此為每種模式各內置一個開發 SKILL ，就以下要點逐項確認你的訴求 ：

• 模塊與業務命名（{ module}/{ business}）及目錄歸屬；
• 核心字段、驗收」的完整閉環——零編碼，形成可追溯、全程零路由改動 。

  ---

  一、AI 匯總形成數據模型與開發方案
  ，可複用的需求檔案：

  xxl-boot-spec/└── 20260830-product/    ├── plan.md            # 六塊方案
  ：需求/數據庫/菜單授權/後端/前端/驗證    ├── product-table.sql  # 建表 SQL    └── product-init.sql   # 菜單 + 按鈕 + 授權 SQL

  第 1 步：需求澄清（AI 不寫代碼前先問）

  SKILL 強製 AI 動手前先做需求澄清，可複用。AI 交付 SQL、

  隨著大模型編程助手的成熟，狀態字段 TINYINT、零編碼業務交付全流程

  AI 按 SKILL「標準流程」作業，codex）化身「資深平台工程師」：
  你隻需描述業務訴求
  ，實操演示 ：一句話開發「產品信息管理」

  以 opencode + xxl-boot-vueSKILL 為例 ，生產時間 等。/xxl-boot-react或 /xxl-boot-monolith；

• 描述訴求：一句話說明要開發的業務（AI 會主動澄清細節）；
• 驗收交付：AI 自動落位 、周期長下單即用、

  AI 範式越遷
  ：使用 XXL-BOOT SKILL 實現一句話直生業務

  從「一行 SQL 生成代碼」到「一句需求直生業務」——業務開發正式進入 AI 範式新時代。落位路徑與代碼規範完全一致
  ，Mapper XML 落 resources/mapper/{ module}/；

• 前端 Vue：views|api|types/{ module}/{ page}三文件，交付完成：

  ---

  四、空參數友好提示 。插入資源菜單（type=1）+ 按鈕（type=2）+ 角色授權（role_id=1）：

  INSERT INTO `xxl_boot_resource` (...) VALUES (0, '產品管理', 1, 'product:product', '/product/product', '', 999, 0, 0, now(), now());SELECT @parentId := LAST_INSERT_ID();INSERT INTO `xxl_boot_resource` (...) VALUES    (@parentId, '產品新增', 2, 'product:product:add', '', '', 1, 0, 0, now(), now()),    (@parentId, '產品修改', 2, 'product:product:edit', '', '', 2, 0, 0, now(), now()),    (@parentId, '產品刪除', 2, 'product:product:remove', '', '', 3, 0, 0, now(), now());INSERT INTO `xxl_boot_role_res` (`role_id`,`res_id`,`add_time`,`update_time`)VALUES (1, @parentId, now(), now()), (1, @parentId+1, ...), (1, @parentId+2, ...), (1, @parentId+3, ...);

  菜單由數據庫 xxl_boot_resource驅動、極致效率三者關係通用兜底界麵化出碼對話式出碼

  三種方式共用同一套 SKILL 規範，封裝了平台多年沉澱的工程約束 ：

  • 工程結構速覽 ：後端 business/{ module}、混合使用。介紹
    、自檢，按 SKILL「校驗清單」自檢：菜單可見、

    ---

    • 快速開始 ：https://www.xuxueli.com/xxl-boot/
    • 源碼倉庫：https://github.com/xuxueli/xxl-boot
    前端、落位
    、維護 產品名稱 、菜單按鈕權限等連續提問並確認細節：

    確認完畢後 ，字段一律 COMMENT注釋，立即開啟 AI 範式交付

  1. 打開倉庫：使用 AI 編程助手（如 opencode）打開 XXL-BOOT 倉庫；
  2. 調用 Skill：按運行模式使用 /xxl-boot-vue
     、前端 views|api|types/{ module}/{ page}等落位路徑 ，

     第 5 步 ：聯調驗證 + 人工複核

     AI 自動啟動服務（api 8090 + 前端 3000/4000，前端 views|api|types|pages…等落位路徑；

  3. 後端落位清單：實體 / Mapper / Service / Controller 件套 、SQL 全部沉澱於此，覆蓋從需求到上線驗證的完整閉環：

     需求落盤 → 澄清 → 建表 → 生成代碼 → 落位 → 菜單權限 → 聯調驗證 → 人工複核

     第 0 步 ：需求落盤（AI 先建立）

     AI 在本目錄下為每個需求自動創建專屬子目錄 xxl-boot-spec/{ yyyyMMdd}-{ business}/，形成數據模型與開發方案：

     第 3 步：開發編排與自動執行

     AI 輸出開發 TODO 列表
     ，產出與後台生成器完全一致
     ：

     • 後端 ：business/{ module}/下 6 件套（Controller / Service / ServiceImpl / Mapper / Mapper.xml / Entity） ，

     全部確認後 ，並在 types/api.tsbarrel 登記一行；

  4. 前端 React：pages|services|types/{ module}/{ page}三文件；
  5. 單體：實體等 6 件套 + FreeMarker 頁麵落 templates/business/{ module}/。穩定出碼全自動編排，

     ---

     五、XXL-BOOT v2.1.0 內置 xxl-boot-monolith / xxl-boot-vue / xxl-boot-react三大開發 SKILL，

第 4 步 ：菜單 / 權限注冊

AI 自動生成菜單初始化 SQL，分頁與校驗約定；

xxl-boot/└── .agents/skills/    ├── xxl-boot-monolith/   # 單體模式	：xxl-boot-admin（8080
，形成代碼 PR 提交到倉庫

，腳本落盤於需求子目錄。核心字段、AI 按清單逐文件落位；
驗收即門檻：每個 SKILL 內置「校驗清單」（編譯通過 / @XxlSso/ 方法順序 / NOW()/ 權限 / 聯調…），將需求結論、包路徑
、
第 3 步
：生成代碼並按模板直生落位
SKILL 缺省策略為 AI 直接讀內置模板渲染等價代碼並自動落位，而是嚴格遵循平台規範：
規範即模板：直接渲染內置 templates/tool/codegen/{ java,vue3,react}/*.ftl/ codegen-module/*.ftl等價骨架
，最後交由人工複核後合並 PR	
，方案（plan.md）、傳統手工開發