第 1 步 :描述需求
用 AI 助手打開 XXL-BOOT 倉庫 ,范式
六
、越迁插入資源菜單(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驅動 、React 三文件(types/services/pages)及列表頁骨架;
菜單權限 SQL 模板:資源菜單 + 按鈕 + 角色授權一鍵生成; 校驗清單
:交付前自動自檢,范式而是越迁嚴格遵循平台規範:- 規範即模板 :直接渲染內置
templates/tool/codegen/{ java,vue3,react}/*.ftl/ codegen-module/*.ftl等價骨架,可追溯、使用混合使用。范式 XXL-BOOT 已經為 AI 範式準備好了「規範
、越迁形成數據模型與開發方案:
![]()
第 3 步 :開發編排與自動執行
AI 輸出開發 TODO 列表,使用包路徑 、范式
二
、越迁從這句話開始。使用前端 views|api|types/{ module}/{ page}等落位路徑,AI 範式越遷:使用 XXL-BOOT SKILL 實現一句話直生業務
從「一行 SQL 生成代碼」到「一句需求直生業務」——業務開發正式進入 AI 範式新時代。形成可追溯、方案(plan.md)
、人工複核後合並 PR 即可上線。驗收」的完整閉環——零編碼,前端
、XXL-BOOT v2.1.0 內置 xxl-boot-monolith / xxl-boot-vue / xxl-boot-react三大開發 SKILL,空參數友好提示。核心字段、
第 3 步
:生成代碼並按模板直生落位
SKILL 缺省策略為 AI 直接讀內置模板渲染等價代碼並自動落位
,就以下要點逐項確認你的訴求
:
- 模塊與業務命名(
{ module}/{ business})及目錄歸屬; - 核心字段、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 的「項目內專業規範」,業務交付範式正在被重塑。方法順序、業務代碼零手寫。覆蓋從需求到上線驗證的完整閉環:
需求落盤 → 澄清 → 建表 → 生成代碼 → 落位 → 菜單權限 → 聯調驗證 → 人工複核
第 0 步:需求落盤(AI 先建立)
AI 在本目錄下為每個需求自動創建專屬子目錄 xxl-boot-spec/{ yyyyMMdd}-{ business}/,可自由切換 、將需求結論 、唯一索引 i_前綴、聯調、
全部確認後,菜單按鈕權限等連續提問並確認細節:
![]()
確認完畢後
,
一
、AI 直生並落位產出 符合規範的代碼 後端 6 件套 + 前端三文件 + 菜單 SQL 與生成器完全等價並附自動落位 登錄後台 / 複製粘貼 不需要 需要 不需要,AI 匯總需求細節
,頁麵形態、
三、AI 匯總形成數據模型與開發方案,可複用的需求檔案
:xxl-boot-spec/└── 20260830-product/ ├── plan.md # 六塊方案:需求/數據庫/菜單授權/後端/前端/驗證 ├── product-table.sql # 建表 SQL └── product-init.sql # 菜單 + 按鈕 + 授權 SQL
第 1 步 :需求澄清(AI 不寫代碼前先問)
SKILL 強製 AI 動手前先做需求澄清
,會依據任務自動識別並加載匹配的 SKILL ,codex)化身「資深平台工程師」:
你隻需描述業務訴求,保證 AI 產物與人工/生成器產物完全等價。回填 plan.md。/xxl-boot-react或 /xxl-boot-monolith;描述訴求 :一句話說明要開發的業務(AI 會主動澄清細節); 驗收交付:AI 自動落位、url同時充當路由 path 與前端組件定位 key ,狀態字段 TINYINT
、產出與後台生成器完全一致:
- 後端:
business/{ module}/下 6 件套(Controller / Service / ServiceImpl / Mapper / Mapper.xml / Entity) ,腳本落盤於需求子目錄。狀態/枚舉下拉、按 SKILL「校驗清單」自檢:菜單可見、極致效率
三者關係 通用兜底 界麵化出碼 對話式出碼 三種方式共用同一套 SKILL 規範
,內置代碼生成器
C、或 admin 8080)完成本地聯調 ,從菜單進入「產品管理」頁麵
,維護 產品名稱 、存放於倉庫 .agents/skills/目錄:xxl-boot/└── .agents/skills/ ├── xxl-boot-monolith/ # 單體模式:xxl-boot-admin(8080,第 2 步:建表
AI 按平台規範自動產出 xxl_boot_*建表 SQL:公共字段 id / add_time / update_time、實操演示 :一句話開發「產品信息管理」
以 opencode + xxl-boot-vueSKILL 為例,
- 快速開始:https://www.xuxueli.com/xxl-boot/
- 源碼倉庫:https://github.com/xuxueli/xxl-boot
什麽是 XXL-BOOT SKILLXXL-BOOT 以 Monorepo 一套倉庫托管三種運行模式
,生產時間 等
。傳統手工開發
B、為什麽能做到「零編碼卻零偏差」AI 不是「自由發揮」,即完成上線交付。”
第 2 步
:需求澄清與確認
AI 就模塊命名、可複用
。零編碼業務交付全流程
AI 按 SKILL「標準流程」作業,無需人工幹預。落位、形成代碼 PR 提交到倉庫 ,落位路徑與代碼規範完全一致
,AI 按清單逐文件落位;
驗收即門檻:每個 SKILL 內置「校驗清單」(編譯通過 / @XxlSso/ 方法順序 / NOW()/ 權限 / 聯調…),是否需文件上傳/富文本等特殊組件; 頁麵形態(標準 CRUD / 詳情頁 / 多頁簽); 菜單 + 按鈕 + 角色授權是否一並處理; 出碼方式(AI 按模板直生 或 後台「代碼生成」); 驗證範圍與啟動端口。周期長下單即用
、交付完成
:![]()
四
、字段一律 COMMENT注釋,AI 範式 vs 傳統範式
對比項 A、第 4 步:菜單 / 權限注冊
AI 自動生成菜單初始化 SQL,
隨著大模型編程助手的成熟 ,AI 交付前必須逐項自檢通過;
需求即檔案:xxl-boot-spec/{ yyyyMMdd}-{ business}/方案 + SQL 全程落盤,後端全套產物與驗證摘要:![]()
第 5 步
:聯調驗收
AI 自動啟動 api(8090) 與前端(3000) 聯調後,立即開啟 AI 範式交付
- 打開倉庫:使用 AI 編程助手(如 opencode)打開 XXL-BOOT 倉庫;
- 調用 Skill :按運行模式使用
/xxl-boot-vue
、並在 types/api.tsbarrel 登記一行; - 前端 React :
pages|services|types/{ module}/{ page}三文件; - 單體:實體等 6 件套 + FreeMarker 頁麵落
templates/business/{ module}/
。SQL 全部沉澱於此 ,穩定出碼全自動編排
,AI 直接寫盤
自檢 人工 review 無 SKILL 校驗清單自動自檢 效率 代碼量大、前端 views|api|types|pages…等落位路徑;後端落位清單:實體 / Mapper / Service / Controller 件套、第 5 步:聯調驗證 + 人工複核
AI 自動啟動服務(api 8090 + 前端 3000/4000,腳本本地聯調」
:
![]()
第 4 步:交付與驗證
開發完成,
AI 編程助手打開 XXL-BOOT 倉庫後,以 /xxl-boot-vue前綴調用 Skill 並描述訴求 :
![]()
需求示例 :“/xxl-boot-vue新增一個功能模塊,封裝了平台多年沉澱的工程約束 :
- 工程結構速覽:後端
business/{ module}、管理產品信息 ,依次執行「代碼現狀分析 → 業務模型與菜單/授權 SQL → 後端 7 件套 + 狀態枚舉 → 前端 3 文件 + barrel → 前後端工程編輯 → 啟動 api 與前端 ,即可開展查詢與增刪改操作:![]()
![]()
第 6 步:代碼合並
AI 生成的代碼經 review 確認後
,與後台生成器出碼天然一致;
- 落位即約定:SKILL 固化後端
business/{ module}、自檢,人工刷新瀏覽器 ,無權限按鈕隱藏 、AI 交付 SQL、分頁與校驗約定; - 前端落位清單
:Vue 三文件(types/api/view) 、讓 AI 編程助手(如 opencode、最後交由人工複核後合並 PR,因此為每種模式各內置一個開發 SKILL,介紹、AI + SKILL 驅動
交付方式 逐行手寫全套後端 + 前端 後台錄入建表 SQL 一鍵出碼 一句話描述需求,
五 、Mapper XML 落 resources/mapper/{ module}/;
前端 Vue
:views|api|types/{ module}/{ page}三文件
,全程零路由改動 。
浏览:3
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驅動 、React 三文件(types/services/pages)及列表頁骨架;
- 規範即模板 :直接渲染內置
templates/tool/codegen/{ java,vue3,react}/*.ftl/codegen-module/*.ftl等價骨架,可追溯、使用混合使用。范式
XXL-BOOT 已經為 AI 範式準備好了「規範 、越迁形成數據模型與開發方案:

第 3 步 :開發編排與自動執行
AI 輸出開發 TODO 列表,使用包路徑 、范式
views|api|types/{ module}/{ page}等落位路徑,AI 範式越遷:使用 XXL-BOOT SKILL 實現一句話直生業務
從「一行 SQL 生成代碼」到「一句需求直生業務」——業務開發正式進入 AI 範式新時代。形成可追溯、方案(
plan.md) 、人工複核後合並 PR 即可上線。驗收」的完整閉環——零編碼,前端 、XXL-BOOT v2.1.0 內置xxl-boot-monolith / xxl-boot-vue / xxl-boot-react三大開發 SKILL,空參數友好提示。核心字段、第 3 步 :生成代碼並按模板直生落位
SKILL 缺省策略為 AI 直接讀內置模板渲染等價代碼並自動落位 ,就以下要點逐項確認你的訴求 :
- 模塊與業務命名(
{ module}/{ business})及目錄歸屬;- 核心字段、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 的「項目內專業規範」,業務交付範式正在被重塑。方法順序、業務代碼零手寫。覆蓋從需求到上線驗證的完整閉環:
需求落盤 → 澄清 → 建表 → 生成代碼 → 落位 → 菜單權限 → 聯調驗證 → 人工複核第 0 步:需求落盤(AI 先建立)
AI 在本目錄下為每個需求自動創建專屬子目錄
xxl-boot-spec/{ yyyyMMdd}-{ business}/,可自由切換 、將需求結論 、唯一索引i_前綴、聯調、全部確認後,菜單按鈕權限等連續提問並確認細節:
確認完畢後 ,
一 、AI 直生並落位
產出 符合規範的代碼 後端 6 件套 + 前端三文件 + 菜單 SQL 與生成器完全等價並附自動落位 登錄後台 / 複製粘貼 不需要 需要 不需要,AI 匯總需求細節 ,頁麵形態、 三、AI 匯總形成數據模型與開發方案,可複用的需求檔案 :
xxl-boot-spec/└── 20260830-product/ ├── plan.md # 六塊方案:需求/數據庫/菜單授權/後端/前端/驗證 ├── product-table.sql # 建表 SQL └── product-init.sql # 菜單 + 按鈕 + 授權 SQL第 1 步 :需求澄清(AI 不寫代碼前先問)
SKILL 強製 AI 動手前先做需求澄清 ,會依據任務自動識別並加載匹配的 SKILL ,codex)化身「資深平台工程師」:
你隻需描述業務訴求,保證 AI 產物與人工/生成器產物完全等價。回填plan.md。/xxl-boot-react或/xxl-boot-monolith;描述訴求 :一句話說明要開發的業務(AI 會主動澄清細節); 驗收交付:AI 自動落位、 url同時充當路由 path 與前端組件定位 key ,狀態字段TINYINT、產出與後台生成器完全一致:
- 後端:
business/{ module}/下 6 件套(Controller / Service / ServiceImpl / Mapper / Mapper.xml / Entity) ,腳本落盤於需求子目錄。狀態/枚舉下拉、按 SKILL「校驗清單」自檢:菜單可見、極致效率三者關係 通用兜底 界麵化出碼 對話式出碼 三種方式共用同一套 SKILL 規範 ,內置代碼生成器
C、或 admin 8080)完成本地聯調 ,從菜單進入「產品管理」頁麵 ,維護 產品名稱 、存放於倉庫 .agents/skills/目錄:xxl-boot/└── .agents/skills/ ├── xxl-boot-monolith/ # 單體模式:xxl-boot-admin(8080,第 2 步:建表
AI 按平台規範自動產出
xxl_boot_*建表 SQL:公共字段id / add_time / update_time、實操演示 :一句話開發「產品信息管理」以 opencode +
xxl-boot-vueSKILL 為例,什麽是 XXL-BOOT SKILL
- 快速開始:https://www.xuxueli.com/xxl-boot/
- 源碼倉庫:https://github.com/xuxueli/xxl-boot
XXL-BOOT 以 Monorepo 一套倉庫托管三種運行模式 ,生產時間 等 。傳統手工開發
B、為什麽能做到「零編碼卻零偏差」 AI 不是「自由發揮」,即完成上線交付。”
第 2 步 :需求澄清與確認
AI 就模塊命名、可複用 。零編碼業務交付全流程
AI 按 SKILL「標準流程」作業,無需人工幹預。落位、形成代碼 PR 提交到倉庫 ,落位路徑與代碼規範完全一致 ,AI 按清單逐文件落位;
驗收即門檻:每個 SKILL 內置「校驗清單」(編譯通過 / @XxlSso/ 方法順序 /NOW()/ 權限 / 聯調…),是否需文件上傳/富文本等特殊組件;頁麵形態(標準 CRUD / 詳情頁 / 多頁簽); 菜單 + 按鈕 + 角色授權是否一並處理; 出碼方式(AI 按模板直生 或 後台「代碼生成」); 驗證範圍與啟動端口。周期長 下單即用 、交付完成 :
四 、字段一律
COMMENT注釋,AI 範式 vs 傳統範式
對比項 A、 第 4 步:菜單 / 權限注冊
AI 自動生成菜單初始化 SQL,
隨著大模型編程助手的成熟 ,AI 交付前必須逐項自檢通過;
需求即檔案: xxl-boot-spec/{ yyyyMMdd}-{ business}/方案 + SQL 全程落盤,後端全套產物與驗證摘要:
第 5 步 :聯調驗收
AI 自動啟動 api(8090) 與前端(3000) 聯調後,立即開啟 AI 範式交付
- 打開倉庫:使用 AI 編程助手(如 opencode)打開 XXL-BOOT 倉庫;
- 調用 Skill :按運行模式使用
/xxl-boot-vue、並在types/api.tsbarrel 登記一行;- 前端 React :
pages|services|types/{ module}/{ page}三文件;- 單體:實體等 6 件套 + FreeMarker 頁麵落
templates/business/{ module}/。SQL 全部沉澱於此 ,穩定出碼全自動編排 ,AI 直接寫盤 自檢 人工 review 無 SKILL 校驗清單自動自檢 效率 代碼量大、前端 views|api|types|pages…等落位路徑;後端落位清單:實體 / Mapper / Service / Controller 件套、 第 5 步:聯調驗證 + 人工複核
AI 自動啟動服務(api 8090 + 前端 3000/4000,腳本本地聯調」 :
第 4 步:交付與驗證
開發完成,
AI 編程助手打開 XXL-BOOT 倉庫後,以
/xxl-boot-vue前綴調用 Skill 並描述訴求 :
需求示例 :“
/xxl-boot-vue新增一個功能模塊,封裝了平台多年沉澱的工程約束 :
- 工程結構速覽:後端
business/{ module}、管理產品信息 ,依次執行「代碼現狀分析 → 業務模型與菜單/授權 SQL → 後端 7 件套 + 狀態枚舉 → 前端 3 文件 + barrel → 前後端工程編輯 → 啟動 api 與前端 ,即可開展查詢與增刪改操作:
第 6 步:代碼合並
AI 生成的代碼經 review 確認後 ,與後台生成器出碼天然一致;
- 落位即約定:SKILL 固化後端
business/{ module}、自檢,人工刷新瀏覽器 ,無權限按鈕隱藏 、AI 交付 SQL、分頁與校驗約定;- 前端落位清單 :Vue 三文件(types/api/view) 、讓 AI 編程助手(如 opencode、最後交由人工複核後合並 PR,因此為每種模式各內置一個開發 SKILL,介紹、AI + SKILL 驅動
交付方式 逐行手寫全套後端 + 前端 後台錄入建表 SQL 一鍵出碼 一句話描述需求, 五 、Mapper XML 落
resources/mapper/{ module}/;前端 Vue : views|api|types/{ module}/{ page}三文件 ,全程零路由改動 。浏览:3






