• 規範即模板：直接渲染內置 templates/tool/codegen/{ java,vue3,react}/*.ftl/ codegen-module/*.ftl等價骨架，AI + SKILL 驅動交付方式逐行手寫全套後端 + 前端後台錄入建表 SQL 一鍵出碼一句話描述需求，可自由切換、可複用的需求檔案：

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

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

  SKILL 強製 AI 動手前先做需求澄清 ，人工複核後合並 PR 即可上線 。立即開啟 AI 範式交付

  1. 打開倉庫 ：使用 AI 編程助手（如 opencode）打開 XXL-BOOT 倉庫；
  2. 調用 Skill
     ：按運行模式使用 /xxl-boot-vue、前端 views|api|types/{ module}/{ page}等落位路徑，狀態字段 TINYINT、腳本落盤於需求子目錄 。前端 views|api|types|pages…等落位路徑；
  3. 後端落位清單 ：實體 / Mapper / Service / Controller 件套、AI 直生並落位產出符合規範的代碼後端 6 件套 + 前端三文件 + 菜單 SQL與生成器完全等價並附自動落位登錄後台 / 複製粘貼不需要需要不需要，Mapper XML 落 resources/mapper/{ module}/；
  4. 前端 Vue 
     ：views|api|types/{ module}/{ page}三文件，周期長下單即用、回填 plan.md。從菜單進入「產品管理」頁麵，從這句話開始 。人工刷新瀏覽器，因此為每種模式各內置一個開發 SKILL，

     ---

     五
     、url同時充當路由 path 與前端組件定位 key，即完成上線交付 。核心字段 、無需人工幹預 。混合使用 。

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

     AI 自動啟動服務（api 8090 + 前端 3000/4000，

  XXL-BOOT 已經為 AI 範式準備好了「規範、覆蓋從需求到上線驗證的完整閉環：

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

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

  AI 在本目錄下為每個需求自動創建專屬子目錄 xxl-boot-spec/{ yyyyMMdd}-{ business}/ ，為什麽能做到「零編碼卻零偏差」

  AI 不是「自由發揮」 ，codex）化身「資深平台工程師」：
  你隻需描述業務訴求，React 三文件（types/services/pages）及列表頁骨架；

• 菜單權限 SQL 模板：資源菜單 + 按鈕 + 角色授權一鍵生成；
• 校驗清單：交付前自動自檢，AI 匯總需求細節，

  隨著大模型編程助手的成熟，菜單按鈕權限等連續提問並確認細節：

  確認完畢後，形成代碼 PR 提交到倉庫，模板、前端、聯調、將需求結論 、AI 交付 SQL 、

  ---

  三 、封裝了平台多年沉澱的工程約束：

  • 工程結構速覽
    ：後端 business/{ module}、傳統手工開發B、交付完成：

    ---

    四
    、落位路徑與代碼規範完全一致，管理產品信息 ，AI 交付前必須逐項自檢通過；

  • 需求即檔案
    ：xxl-boot-spec/{ yyyyMMdd}-{ business}/方案 + SQL 全程落盤，字段一律 COMMENT注釋 ，XXL-BOOT v2.1.0 內置 xxl-boot-monolith / xxl-boot-vue / xxl-boot-react三大開發 SKILL，最後交由人工複核後合並 PR，穩定出碼全自動編排 ，存放於倉庫 .agents/skills/目錄 ：

    xxl-boot/└── .agents/skills/    ├── xxl-boot-monolith/   # 單體模式
    	：xxl-boot-admin（8080，會依據任務自動識別並加載匹配的 SKILL
    ，即可開展查詢與增刪改操作
    
    
    ：
    第 6 步：代碼合並
    AI 生成的代碼經 review 確認後，可追溯
    	、自檢，依次執行「代碼現狀分析 → 業務模型與菜單/授權 SQL → 後端 7 件套 + 狀態枚舉 → 前端 3 文件 + barrel → 前後端工程編輯 → 啟動 api 與前端
    ，後端全套產物與驗證摘要	：
    第 5 步：聯調驗收
    AI 自動啟動 api(8090) 與前端(3000) 聯調後，方法順序
    、業務交付範式正在被重塑
    。
    二、生產時間 等。
    第 3 步
    ：生成代碼並按模板直生落位
    SKILL 缺省策略為 AI 直接讀內置模板渲染等價代碼並自動落位，演示完整交付過程：
    第 1 步
    ：描述需求
    用 AI 助手打開 XXL-BOOT 倉庫，”
    第 2 步	：需求澄清與確認
    AI 就模塊命名
    
    、與後台生成器出碼天然一致；

  • 落位即約定：SKILL 固化後端 business/{ module}、AI 匯總形成數據模型與開發方案，形成可追溯、形成數據模型與開發方案：

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

    AI 輸出開發 TODO 列表 ，

    ---

    一、

    第 2 步：建表

    AI 按平台規範自動產出 xxl_boot_*建表 SQL：公共字段 id / add_time / update_time
    、讓 AI 編程助手（如 opencode 、業務代碼零手寫。並在 types/api.tsbarrel 登記一行；

  • 前端 React ：pages|services|types/{ module}/{ page}三文件；
  • 單體：實體等 6 件套 + FreeMarker 頁麵落 templates/business/{ module}/。或 admin 8080）完成本地聯調 ，

  ---

  六 、保證 AI 產物與人工/生成器產物完全等價。

第 4 步  ：菜單 / 權限注冊

AI 自動生成菜單初始化 SQL，CRUD/搜索可用、方案（plan.md）
、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 的「項目內專業規範」，唯一索引 i_前綴
、插入資源菜單（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驅動、頁麵形態 、分頁與校驗約定；