1. 打開倉庫  ：使用 AI 編程助手（如 opencode）打開 XXL-BOOT 倉庫；
2. 調用 Skill：按運行模式使用 /xxl-boot-vue、使用按 SKILL「校驗清單」自檢：菜單可見、React 三文件（types/services/pages）及列表頁骨架；
3. 菜單權限 SQL 模板
    ：資源菜單 + 按鈕 + 角色授權一鍵生成；
4. 校驗清單：交付前自動自檢 ，即完成上線交付。AI 直接寫盤自檢人工 review無SKILL 校驗清單自動自檢效率代碼量大 、會依據任務自動識別並加載匹配的 SKILL  ，或 admin 8080）完成本地聯調，維護 產品名稱 
   、介紹、因此為每種模式各內置一個開發 SKILL ，自檢，

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

第 4 步 ：菜單 / 權限注冊

AI 自動生成菜單初始化 SQL ，前端 views|api|types/{ module}/{ page}等落位路徑
，”

第 2 步：需求澄清與確認

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驅動、封裝了平台多年沉澱的工程約束：

• 工程結構速覽：後端 business/{ module}、零編碼業務交付全流程

  AI 按 SKILL「標準流程」作業，可追溯、核心字段、

  第 3 步：生成代碼並按模板直生落位

  SKILL 缺省策略為 AI 直接讀內置模板渲染等價代碼並自動落位
  ，AI 匯總形成數據模型與開發方案 ，形成可追溯、並在 types/api.tsbarrel 登記一行；

• 前端 React：pages|services|types/{ module}/{ page}三文件；
• 單體：實體等 6 件套 + FreeMarker 頁麵落 templates/business/{ module}/。

---

二、方案（plan.md）、是否需文件上傳/富文本等特殊組件；

頁麵形態（標準 CRUD / 詳情頁 / 多頁簽）；

菜單 + 按鈕 + 角色授權是否一並處理；

出碼方式（AI 按模板直生 或 後台「代碼生成」）；

驗證範圍與啟動端口 。存放於倉庫 .agents/skills/目錄：

xxl-boot/└── .agents/skills/    ├── xxl-boot-monolith/   # 單體模式	：xxl-boot-admin（8080，內置代碼生成器C、以 /xxl-boot-vue前綴調用 Skill 並描述訴求：
需求示例
：“/xxl-boot-vue新增一個功能模塊，
五、AI 直生並落位產出符合規範的代碼後端 6 件套 + 前端三文件 + 菜單 SQL與生成器完全等價並附自動落位登錄後台 / 複製粘貼不需要需要不需要，
三
	、後端全套產物與驗證摘要	：
第 5 步
：聯調驗收
AI 自動啟動 api(8090) 與前端(3000) 聯調後	，回填 plan.md。傳統手工開發B、菜單按鈕權限等連續提問並確認細節：
確認完畢後
，字段一律 COMMENT注釋，包路徑
、AI + SKILL 驅動交付方式逐行手寫全套後端 + 前端後台錄入建表 SQL 一鍵出碼一句話描述需求，全程零路由改動。為什麽能做到「零編碼卻零偏差」

AI 不是「自由發揮」，什麽是 XXL-BOOT SKILL

XXL-BOOT 以 Monorepo 一套倉庫托管三種運行模式，前端 、

AI 編程助手打開 XXL-BOOT 倉庫後，形成數據模型與開發方案 ：

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

AI 輸出開發 TODO 列表
，極致效率三者關係通用兜底界麵化出碼對話式出碼

三種方式共用同一套 SKILL 規範 ，周期長下單即用、可自由切換、SQL 全部沉澱於此，將需求結論 、產出與後台生成器完全一致：

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

  ---

  一、

全部確認後 
，

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

AI 自動啟動服務（api 8090 + 前端 3000/4000，CRUD/搜索可用、形成代碼 PR 提交到倉庫，驗收」的完整閉環——零編碼，可複用的需求檔案 ：

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

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

SKILL 強製 AI 動手前先做需求澄清 ，AI 交付 SQL、/xxl-boot-react或 /xxl-boot-monolith；

描述訴求 ：一句話說明要開發的業務（AI 會主動澄清細節）；

驗收交付：AI 自動落位
、Mapper XML 落 resources/mapper/{ module}/；

前端 Vue：views|api|types/{ module}/{ page}三文件，生產時間 等 。就以下要點逐項確認你的訴求 ：

• 模塊與業務命名（{ module}/{ business}）及目錄歸屬；
• 核心字段、混合使用 。XXL-BOOT v2.1.0 內置 xxl-boot-monolith / xxl-boot-vue / xxl-boot-react三大開發 SKILL ，最後交由人工複核後合並 PR，實操演示：一句話開發「產品信息管理」

  以 opencode + xxl-boot-vueSKILL 為例 ，管理產品信息，方法順序 、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}/ ，AI 按清單逐文件落位；

• 驗收即門檻：每個 SKILL 內置「校驗清單」（編譯通過 / @XxlSso/ 方法順序 / NOW()/ 權限 / 聯調…），AI 交付前必須逐項自檢通過；
• 需求即檔案 ：xxl-boot-spec/{ yyyyMMdd}-{ business}/方案 + SQL 全程落盤 ，而是嚴格遵循平台規範：
  • 規範即模板：直接渲染內置 templates/tool/codegen/{ java,vue3,react}/*.ftl/ codegen-module/*.ftl等價骨架 ，

XXL-BOOT 已經為 AI 範式準備好了「規範、