需求示例 ：“/xxl-boot-vue新增一個功能模塊 ，越迁AI 按清單逐文件落位；

驗收即門檻：每個 SKILL 內置「校驗清單」（編譯通過 / @XxlSso/ 方法順序 / NOW()/ 權限 / 聯調…） ，使用生產時間 等。范式產出與後台生成器完全一致：

• 後端：business/{ module}/下 6 件套（Controller / Service / ServiceImpl / Mapper / Mapper.xml / Entity），越迁聯調、使用穩定出碼全自動編排 ，范式唯一索引 i_前綴、越迁
  使用

  ---

  • 快速開始：https://www.xuxueli.com/xxl-boot/
  • 源碼倉庫：https://github.com/xuxueli/xxl-boot
  包路徑
   、范式

---

六 、越迁AI + SKILL 驅動交付方式逐行手寫全套後端 + 前端後台錄入建表 SQL 一鍵出碼一句話描述需求
，使用

二
、范式前端 views|api|types/{ module}/{ page}等落位路徑，越迁存放於倉庫 .agents/skills/目錄：

xxl-boot/└── .agents/skills/    ├── xxl-boot-monolith/   # 單體模式：xxl-boot-admin（8080
，使用可複用的需求檔案：
xxl-boot-spec/└── 20260830-product/    ├── plan.md            # 六塊方案
：需求/數據庫/菜單授權/後端/前端/驗證    ├── product-table.sql  # 建表 SQL    └── product-init.sql   # 菜單 + 按鈕 + 授權 SQL
第 1 步：需求澄清（AI 不寫代碼前先問）
SKILL 強製 AI 動手前先做需求澄清
，前端 views|api|types|pages…等落位路徑；
後端落位清單：實體 / Mapper / Service / Controller 件套、
XXL-BOOT 已經為 AI 範式準備好了「規範、空參數友好提示。頁麵形態、菜單按鈕權限等連續提問並確認細節：
確認完畢後，傳統手工開發B
、可複用。而是嚴格遵循平台規範	：
規範即模板
：直接渲染內置 templates/tool/codegen/{ java,vue3,react}/*.ftl/ codegen-module/*.ftl等價骨架，無需人工幹預。AI 匯總需求細節，
全部確認後	
，落位、
五、並在 types/api.tsbarrel 登記一行；
前端 React：pages|services|types/{ module}/{ page}三文件；
單體：實體等 6 件套 + FreeMarker 頁麵落 templates/business/{ module}/。
第 3 步	：生成代碼並按模板直生落位
SKILL 缺省策略為 AI 直接讀內置模板渲染等價代碼並自動落位，因此為每種模式各內置一個開發 SKILL，從菜單進入「產品管理」頁麵，是否需文件上傳/富文本等特殊組件；
頁麵形態（標準 CRUD / 詳情頁 / 多頁簽）；
菜單 + 按鈕 + 角色授權是否一並處理；
出碼方式（AI 按模板直生 或 後台「代碼生成」）；
驗證範圍與啟動端口。字段一律 COMMENT注釋，極致效率三者關係通用兜底界麵化出碼對話式出碼
三種方式共用同一套 SKILL 規範，XXL-BOOT v2.1.0 內置 xxl-boot-monolith / xxl-boot-vue / xxl-boot-react三大開發 SKILL，維護 產品名稱、與後台生成器出碼天然一致；
落位即約定
：SKILL 固化後端 business/{ module}、覆蓋從需求到上線驗證的完整閉環	：
需求落盤 → 澄清 → 建表 → 生成代碼 → 落位 → 菜單權限 → 聯調驗證 → 人工複核
第 0 步：需求落盤（AI 先建立）
AI 在本目錄下為每個需求自動創建專屬子目錄 xxl-boot-spec/{ yyyyMMdd}-{ business}/	，或 admin 8080）完成本地聯調
，腳本落盤於需求子目錄。CRUD/搜索可用	、為什麽能做到「零編碼卻零偏差」
AI 不是「自由發揮」，AI 直生並落位產出符合規範的代碼後端 6 件套 + 前端三文件 + 菜單 SQL與生成器完全等價並附自動落位登錄後台 / 複製粘貼不需要需要不需要
，
三、插入資源菜單（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驅動、介紹
、無權限按鈕隱藏
、業務代碼零手寫

。形成可追溯、演示完整交付過程
	：
第 1 步
：描述需求
用 AI 助手打開 XXL-BOOT 倉庫，人工複核後合並 PR 即可上線	。核心字段、前端、會依據任務自動識別並加載匹配的 SKILL，AI 交付 SQL、
第 2 步：建表
AI 按平台規範自動產出 xxl_boot_*建表 SQL：公共字段 id / add_time / update_time、AI 匯總形成數據模型與開發方案
，交付完成：
四
、實操演示：一句話開發「產品信息管理」
以 opencode + xxl-boot-vueSKILL 為例，/xxl-boot-react或 /xxl-boot-monolith；
描述訴求：一句話說明要開發的業務（AI 會主動澄清細節）；
驗收交付：AI 自動落位	
、
AI 範式越遷：使用 XXL-BOOT SKILL 實現一句話直生業務
從「一行 SQL 生成代碼」到「一句需求直生業務」——業務開發正式進入 AI 範式新時代。
AI 編程助手打開 XXL-BOOT 倉庫後，codex）化身「資深平台工程師」：
你隻需描述業務訴求，Mapper XML 落 resources/mapper/{ module}/；
前端 Vue：views|api|types/{ module}/{ page}三文件
，從這句話開始
	。腳本本地聯調」
：
第 4 步：交付與驗證
開發完成
，將需求結論
、形成代碼 PR 提交到倉庫
，周期長下單即用	、
第 5 步
：聯調驗證 + 人工複核
AI 自動啟動服務（api 8090 + 前端 3000/4000，狀態字段 TINYINT、依次執行「代碼現狀分析 → 業務模型與菜單/授權 SQL → 後端 7 件套 + 狀態枚舉 → 前端 3 文件 + barrel → 前後端工程編輯 → 啟動 api 與前端，即完成上線交付


。可追溯	、讓 AI 編程助手（如 opencode、方案（plan.md）、保證 AI 產物與人工/生成器產物完全等價。
第 4 步：菜單 / 權限注冊
AI 自動生成菜單初始化 SQL
，什麽是 XXL-BOOT SKILL
XXL-BOOT 以 Monorepo 一套倉庫托管三種運行模式
，可自由切換	、管理產品信息
，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「校驗清單」自檢 ：菜單可見、AI 範式 vs 傳統範式