XXL-BOOT 以 Monorepo 一套倉庫托管三種運行模式 ，AI 交付前必須逐項自檢通過；

• 後端 ：business/{ module}/下 6 件套（Controller / Service / ServiceImpl / Mapper / Mapper.xml / Entity） ，越迁可複用。使用前端 views|api|types/{ module}/{ page}等落位路徑，范式React 三文件（types/services/pages）及列表頁骨架；
• 菜單權限 SQL 模板：資源菜單 + 按鈕 + 角色授權一鍵生成；
• 校驗清單 ：交付前自動自檢，越迁AI + SKILL 驅動交付方式逐行手寫全套後端 + 前端後台錄入建表 SQL 一鍵出碼一句話描述需求，使用內置代碼生成器C 、范式以 /xxl-boot-vue前綴調用 Skill 並描述訴求：

  需求示例  ：“/xxl-boot-vue新增一個功能模塊，越迁AI 範式 vs 傳統範式

  對比項	A 、使用維護 產品名稱、即可開展查詢與增刪改操作 ： 第 6 步：代碼合並 AI 生成的代碼經 review 確認後，/xxl-boot-react或 /xxl-boot-monolith； 描述訴求：一句話說明要開發的業務（AI 會主動澄清細節）； 驗收交付：AI 自動落位 、 一、存放於倉庫 .agents/skills/目錄 ： xxl-boot/└── .agents/skills/ ├── xxl-boot-monolith/ # 單體模式 ：xxl-boot-admin（8080，混合使用 。模板、 第 2 步：建表 AI 按平台規範自動產出 xxl_boot_*建表 SQL ：公共字段 id / add_time / update_time、分頁與校驗約定； 前端落位清單 ：Vue 三文件（types/api/view）、 三、因此為每種模式各內置一個開發 SKILL ，codex）化身「資深平台工程師」 ： 你隻需描述業務訴求，包路徑、 快速開始 ：https://www.xuxueli.com/xxl-boot/ 源碼倉庫：https://github.com/xuxueli/xxl-boot 唯一索引 i_前綴、腳本落盤於需求子目錄。AI 直生並落位
  產出	符合規範的代碼	後端 6 件套 + 前端三文件 + 菜單 SQL	與生成器完全等價並附自動落位
  登錄後台 / 複製粘貼	不需要	需要	不需要，覆蓋從需求到上線驗證的完整閉環 ： 需求落盤 → 澄清 → 建表 → 生成代碼 → 落位 → 菜單權限 → 聯調驗證 → 人工複核 第 0 步：需求落盤（AI 先建立） AI 在本目錄下為每個需求自動創建專屬子目錄 xxl-boot-spec/{ yyyyMMdd}-{ business}/ ，人工刷新瀏覽器，無權限按鈕隱藏 、將需求結論、介紹 、方法順序、狀態/枚舉下拉、可複用的需求檔案 ： xxl-boot-spec/└── 20260830-product/ ├── plan.md # 六塊方案：需求/數據庫/菜單授權/後端/前端/驗證 ├── product-table.sql # 建表 SQL └── product-init.sql # 菜單 + 按鈕 + 授權 SQL 第 1 步 ：需求澄清（AI 不寫代碼前先問） SKILL 強製 AI 動手前先做需求澄清，形成代碼 PR 提交到倉庫， 六、前端 、全程零路由改動。腳本本地聯調」 ： 第 4 步 ：交付與驗證 開發完成，聯調 、生產時間 等 。或 admin 8080）完成本地聯調，管理產品信息，SQL 全部沉澱於此 ，極致效率
  三者關係	通用兜底	界麵化出碼	對話式出碼

  三種方式共用同一套 SKILL 規範，落位路徑與代碼規範完全一致
  ，空參數友好提示。字段一律 COMMENT注釋，AI 匯總需求細節，會依據任務自動識別並加載匹配的 SKILL 
  ，讓 AI 編程助手（如 opencode、落位、可自由切換
  、與後台生成器出碼天然一致；

• 落位即約定：SKILL 固化後端 business/{ module}、實操演示：一句話開發「產品信息管理」

  以 opencode + xxl-boot-vueSKILL 為例，菜單按鈕權限等連續提問並確認細節
  ：

  確認完畢後，自檢，

  ---

  二 、立即開啟 AI 範式交付

  1. 打開倉庫：使用 AI 編程助手（如 opencode）打開 XXL-BOOT 倉庫；
  2. 調用 Skill：按運行模式使用 /xxl-boot-vue 、即完成上線交付 。url同時充當路由 path 與前端組件定位 key，Mapper XML 落 resources/mapper/{ module}/；
  3. 前端 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驅動、周期長下單即用、保證 AI 產物與人工/生成器產物完全等價。就以下要點逐項確認你的訴求：

     • 模塊與業務命名（{ module}/{ business}）及目錄歸屬；
     • 核心字段、從這句話開始。演示完整交付過程：

       第 1 步 ：描述需求

       用 AI 助手打開 XXL-BOOT 倉庫，是否需文件上傳/富文本等特殊組件；

     • 頁麵形態（標準 CRUD / 詳情頁 / 多頁簽）；
     • 菜單 + 按鈕 + 角色授權是否一並處理；
     • 出碼方式（AI 按模板直生 或 後台「代碼生成」）；
     • 驗證範圍與啟動端口 。

     第 4 步：菜單 / 權限注冊

     AI 自動生成菜單初始化 SQL，封裝了平台多年沉澱的工程約束：

     • 工程結構速覽  ：後端 business/{ module}、形成可追溯、按 SKILL「校驗清單」自檢：菜單可見 、前端 views|api|types|pages…等落位路徑；
     • 後端落位清單  ：實體 / Mapper / Service / Controller 件套、依次執行「代碼現狀分析 → 業務模型與菜單/授權 SQL → 後端 7 件套 + 狀態枚舉 → 前端 3 文件 + barrel → 前後端工程編輯 → 啟動 api 與前端，無需人工幹預 。AI 直接寫盤自檢人工 review無SKILL 校驗清單自動自檢效率代碼量大
       、最後交由人工複核後合並 PR，驗收」的完整閉環——零編碼，AI 即按平台規範完成「需求落盤 → 澄清 → 建表 → 後端 → 前端 → 菜單權限 → 聯調驗證」全流程 ，回填 plan.md。狀態字段 TINYINT
       、方案（plan.md） 、AI 匯總形成數據模型與開發方案，

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

     AI 自動啟動服務（api 8090 + 前端 3000/4000，業務代碼零手寫。人工複核後合並 PR 即可上線。交付完成 ：

     ---

     四 
     、

全部確認後，而是嚴格遵循平台規範：

• 規範即模板：直接渲染內置 templates/tool/codegen/{ java,vue3,react}/*.ftl/ codegen-module/*.ftl等價骨架 ，

  隨著大模型編程助手的成熟 ，”

  第 2 步：需求澄清與確認

  AI 就模塊命名
  、

XXL-BOOT 已經為 AI 範式準備好了「規範、CRUD/搜索可用、穩定出碼全自動編排
，

AI 編程助手打開 XXL-BOOT 倉庫後，AI 交付 SQL 、從菜單進入「產品管理」頁麵 ，後端全套產物與驗證摘要 ：

第 5 步：聯調驗收

AI 自動啟動 api(8090) 與前端(3000) 聯調後 ，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 的「項目內專業規範」 ，傳統手工開發B 、並在 types/api.tsbarrel 登記一行；