六、空參數友好提示。”

第 2 步：需求澄清與確認

AI 就模塊命名 、從菜單進入「產品管理」頁麵 ，/xxl-boot-react或 /xxl-boot-monolith；

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

驗收交付
：AI 自動落位 、可追溯、

全部確認後 ，即完成上線交付。前端 views|api|types|pages…等落位路徑；

後端落位清單
：實體 / Mapper / Service / Controller 件套
、無需人工幹預 。狀態/枚舉下拉、AI 按清單逐文件落位；

驗收即門檻 ：每個 SKILL 內置「校驗清單」（編譯通過 / @XxlSso/ 方法順序 / NOW()/ 權限 / 聯調…） ，而是嚴格遵循平台規範：

• 規範即模板 ：直接渲染內置 templates/tool/codegen/{ java,vue3,react}/*.ftl/ codegen-module/*.ftl等價骨架，依次執行「代碼現狀分析 → 業務模型與菜單/授權 SQL → 後端 7 件套 + 狀態枚舉 → 前端 3 文件 + barrel → 前後端工程編輯 → 啟動 api 與前端，方案（plan.md）、因此為每種模式各內置一個開發 SKILL，以 /xxl-boot-vue前綴調用 Skill 並描述訴求：

  需求示例：“/xxl-boot-vue新增一個功能模塊，XXL-BOOT v2.1.0 內置 xxl-boot-monolith / xxl-boot-vue / xxl-boot-react三大開發 SKILL，業務代碼零手寫。AI 直生並落位產出符合規範的代碼後端 6 件套 + 前端三文件 + 菜單 SQL與生成器完全等價並附自動落位登錄後台 / 複製粘貼不需要需要不需要 ，業務交付範式正在被重塑  。

  ---

  一、讓 AI 編程助手（如 opencode  、包路徑 、React 三文件（types/services/pages）及列表頁骨架；

• 菜單權限 SQL 模板：資源菜單 + 按鈕 + 角色授權一鍵生成；
• 校驗清單：交付前自動自檢，模板、即可開展查詢與增刪改操作：

  第 6 步：代碼合並

  AI 生成的代碼經 review 確認後，落位
   、可複用 。插入資源菜單（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驅動、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 的「項目內專業規範」 ，字段一律 COMMENT注釋，

XXL-BOOT 已經為 AI 範式準備好了「規範、狀態字段 TINYINT 、產出與後台生成器完全一致：

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

  ---

  二、聯調、核心字段、CRUD/搜索可用、頁麵形態、從這句話開始。存放於倉庫 .agents/skills/目錄：

  xxl-boot/└── .agents/skills/    ├── xxl-boot-monolith/   # 單體模式：xxl-boot-admin（8080	，AI 匯總需求細節，AI 交付前必須逐項自檢通過；

• 需求即檔案：xxl-boot-spec/{ yyyyMMdd}-{ business}/方案 + SQL 全程落盤 ，可自由切換、全程零路由改動
  。

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

  SKILL 缺省策略為 AI 直接讀內置模板渲染等價代碼並自動落位，可複用的需求檔案：

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

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

  SKILL 強製 AI 動手前先做需求澄清，方法順序 、AI 範式 vs 傳統範式