單個(gè) Skill = 一塊積木
Skill 體系 = 積木系統(tǒng)（有標(biāo)準(zhǔn)接口，可以任意組合）

┌─────────────────────────────────────┐
│      前端交互層 Skill                │
│  (API 文檔、接口測(cè)試)                │
└─────────────────────────────────────┘
           ↓
┌─────────────────────────────────────┐
│      Controller 層 Skill            │
│  (接口定義、參數(shù)校驗(yàn)、返回封裝)       │
└─────────────────────────────────────┘
           ↓
┌─────────────────────────────────────┐
│      Service 層 Skill               │
│  (業(yè)務(wù)邏輯、事務(wù)控制、流程編排)       │
└─────────────────────────────────────┘
           ↓
┌─────────────────────────────────────┐
│      Data 層 Skill                  │
│  (數(shù)據(jù)訪問、SQL 生成、實(shí)體映射)       │
└─────────────────────────────────────┘
           ↓
┌───────────────── ───────────────────┐
│      基礎(chǔ)設(shè)施 Skill                 │
│  (工具類、配置類、常量定義)           │
└─────────────────────────────────────┘

├── DTO 轉(zhuǎn)換 Skill（對(duì)象映射）
├── 異常處理 Skill（統(tǒng)一異常）
├── 日志記錄 Skill（日志模板）
├── 參數(shù)校驗(yàn) Skill（校驗(yàn)規(guī)則）
├── 分頁(yè)查詢 Skill（分頁(yè)邏輯）
└── 單元測(cè)試 Skill（測(cè)試模板）

BadSkill: 生成整個(gè)用戶管理模塊
（包含 Controller、Service、Mapper、DTO、VO...）這太大了，一個(gè)skill只負(fù)責(zé)一件事

ControllerSkill: 只生成 Controller 方法
ServiceSkill: 只生成 Service 方法
MapperSkill: 只生成 Mapper 接口
...

Controller Skill + Service Skill + Mapper Skill
= 完整的 CRUD 功能

# 標(biāo)準(zhǔn)輸入格式
skill: SkillName
version: 1.0.0
params:
  param1: value1
  param2: value2

# 標(biāo)準(zhǔn)輸出格式
result:
  code: 成功的代碼
  files: 需要?jiǎng)?chuàng)建的文件
  tips: 使用提示

# 團(tuán)隊(duì)規(guī)范配置
team_standards:
  code_style: alibaba  # 代碼風(fēng)格
  naming_convention: camelCase  # 命名規(guī)范
  return_type: Result<T>  # 返回類型
  log_framework: slf4j  # 日志框架
  doc_tool: swagger  # 文檔工具

V1.0 → V1.1 → V2.0
     ↓       ↓
   兼容    兼容（主版本可破壞）

skill: EntitySkill
params:
  table_name: user
  fields:
    - name: id
      type: Long
      primary: true
      auto_increment: true
    - name: username
      type: String
      length: 50
      nullable: false
    - name: email
      type: String
      length: 100

@Data
@TableName("user")
public class User implements Serializable {
    
    @TableId(value = "id", type = IdType.AUTO)
    private Long id;
    
    @TableField("username")
    @NotBlank(message = "用戶名不能為空")
    @Size(max = 50, message = "用戶名長(zhǎng)度不能超過50")
    private String username;
    
    @TableField("email")
    @Size(max = 100, message = "郵箱長(zhǎng)度不能超過100")
    private String email;
}

skill: MapperSkill
params:
  entity: User
  base_package: com.example.mapper
  extend: BaseMapper  # MyBatis-Plus
  methods:
    - selectByUsername
    - selectByEmail
    - updateStatusById

@Mapper
public interface UserMapper extends BaseMapper<User> {
    
    /**
     * 根據(jù)用戶名查詢
     */
    User selectByUsername(@Param("username") String username);
    
    /**
     * 根據(jù)郵箱查詢
     */
    User selectByEmail(@Param("email") String email);
    
    /**
     * 更新用戶狀態(tài)
     */
    int updateStatusById(@Param("id") Long id, @Param("status") Integer status);
}

skill: ServiceImplSkill
params:
  interface: UserService
  entity: User
  mapper: UserMapper
  methods:
    - name: createUser
      params: [UserCreateDTO]
      return: Long
      transaction: true
    - name: getUserById
      params: [Long id]
      return: UserVO
      cache: true

@Service
@Slf4j
public class UserServiceImpl implements UserService {
    
    @Autowired
    private UserMapper userMapper;
    
    @Override
    @Transactional(rollbackFor = Exception.class)
    public Long createUser(UserCreateDTO dto) {
        log.info("創(chuàng)建用戶: {}", dto);
        
        // 參數(shù)校驗(yàn)
        if (userMapper.selectByUsername(dto.getUsername()) != null) {
            throw new BusinessException("用戶名已存在");
        }
        
        // DTO轉(zhuǎn)Entity
        User user = new User();
        BeanUtils.copyProperties(dto, user);
        
        // 保存
        userMapper.insert(user);
        
        log.info("用戶創(chuàng)建成功, userId={}", user.getId());
        return user.getId();
    }
    
    @Override
    @Cacheable(value = "user", key = "#id")
    public UserVO getUserById(Long id) {
        log.info("查詢用戶: id={}", id);
        
        User user = userMapper.selectById(id);
        if (user == null) {
            throw new BusinessException("用戶不存在");
        }
        
        // Entity轉(zhuǎn)VO
        UserVO vo = new UserVO();
        BeanUtils.copyProperties(user, vo);
        
        return vo;
    }
}

EntitySkill → MapperSkill → ServiceSkill → ControllerSkill

# 步驟1：生成實(shí)體
skill: EntitySkill
params:
  table: user
output: User.java

# 步驟2：生成Mapper
skill: MapperSkill
params:
  entity: User
output: UserMapper.java

# 步驟3：生成Service
skill: ServiceSkill
params:
  entity: User
  mapper: UserMapper
output: UserService.java, UserServiceImpl.java

# 步驟4：生成Controller
skill: ControllerSkill
params:
  service: UserService
output: UserController.java

        ┌─→ DTO Skill
Entity ─┼─→ VO Skill
        └─→ Query Skill

ComplexFeatureSkill {
  調(diào)用 ControllerSkill
  調(diào)用 ServiceSkill
  調(diào)用 MapperSkill
  調(diào)用 TestSkill
}

if (需要緩存) {
  調(diào)用 CacheSkill
}

if (需要分頁(yè)) {
  調(diào)用 PageSkill
}

# ===== 第一階段：基礎(chǔ)設(shè)施 =====
stage1_foundation:
  - skill: EntitySkill
    input:
      table: product
      fields: [id, name, price, stock, status]
    output: Product.java
    
  - skill: DTOSkill
    input:
      entity: Product
      dto_types: [CreateDTO, UpdateDTO, QueryDTO]
    output: 
      - ProductCreateDTO.java
      - ProductUpdateDTO.java
      - ProductQueryDTO.java
      
  - skill: VOSkill
    input:
      entity: Product
    output: ProductVO.java

# ===== 第二階段：數(shù)據(jù)訪問層 =====
stage2_data:
  - skill: MapperSkill
    input:
      entity: Product
      methods:
        - selectByName
        - selectByStatus
        - updateStock
    output: ProductMapper.java
    
  - skill: MapperXMLSkill
    input:
      mapper: ProductMapper
    output: ProductMapper.xml

# ===== 第三階段：業(yè)務(wù)邏輯層 =====
stage3_service:
  - skill: ServiceInterfaceSkill
    input:
      entity: Product
      methods: [create, update, delete, getById, list]
    output: ProductService.java
    
  - skill: ServiceImplSkill
    input:
      interface: ProductService
      mapper: ProductMapper
      with_transaction: true
      with_cache: true
    output: ProductServiceImpl.java

# ===== 第四階段：控制層 =====
stage4_controller:
  - skill: RestControllerSkill
    input:
      service: ProductService
      base_path: /api/product
      methods:
        - name: create
          path: /create
          method: POST
        - name: update
          path: /update
          method: PUT
        - name: delete
          path: /delete/{id}
          method: DELETE
        - name: getById
          path: /{id}
          method: GET
        - name: list
          path: /list
          method: GET
          with_page: true
    output: ProductController.java

# ===== 第五階段：測(cè)試代碼 =====
stage5_test:
  - skill: UnitTestSkill
    input:
      target: ProductService
    output: ProductServiceTest.java
    
  - skill: IntegrationTestSkill
    input:
      target: ProductController
    output: ProductControllerTest.java

? 生成完成！

實(shí)體層：
  ? Product.java
  ? ProductCreateDTO.java
  ? ProductUpdateDTO.java
  ? ProductQueryDTO.java
  ? ProductVO.java

數(shù)據(jù)層：
  ? ProductMapper.java
  ? ProductMapper.xml

業(yè)務(wù)層：
  ? ProductService.java
  ? ProductServiceImpl.java

控制層：
  ? ProductController.java

測(cè)試層：
  ? ProductServiceTest.java
  ? ProductControllerTest.java

# skill-config.yaml

# 項(xiàng)目基礎(chǔ)信息
project:
  name: ecommerce-platform
  base_package: com.example.ecommerce
  author: Your Name

# 代碼規(guī)范
standards:
  code_style: alibaba
  naming:
    entity_suffix: ""
    dto_suffix: "DTO"
    vo_suffix: "VO"
    service_suffix: "Service"
    controller_suffix: "Controller"
  
# 技術(shù)棧配置
tech_stack:
  framework: SpringBoot
  orm: MyBatisPlus
  validation: JSR303
  doc: Swagger3
  log: slf4j
  cache: Redis
  
# 通用配置
common:
  result_wrapper: Result<T>
  exception_handler: GlobalExceptionHandler
  id_type: Long
  id_generator: auto_increment
  
# 數(shù)據(jù)庫(kù)配置
database:
  type: MySQL
  charset: utf8mb4
  engine: InnoDB
  
# Skill 加載路徑
skills:
  load_paths:
    - ./skills/foundation
    - ./skills/data
    - ./skills/service
    - ./skills/controller
    - ./skills/common
    - ./skills/test

主版本號(hào).次版本號(hào).修訂號(hào)

例如：2.1.3

skill: ServiceImplSkill
version: 2.1.0
compatibility:
  min_version: 2.0.0  # 最低兼容版本
  deprecated: false
  
changelog:
  - version: 2.1.0
    date: 2024-01-15
    changes:
      - 新增緩存支持
      - 優(yōu)化事務(wù)處理
  - version: 2.0.0
    date: 2023-12-01
    changes:
      - 重構(gòu)代碼結(jié)構(gòu)
      - 破壞性變更：修改輸入?yún)?shù)格式

# ServiceImplSkill 測(cè)試用例

test_cases:
  - name: 基礎(chǔ)功能測(cè)試
    input:
      entity: User
      methods: [create, update, delete]
    expect:
      files: [UserService.java, UserServiceImpl.java]
      compilable: true
      
  - name: 事務(wù)注解測(cè)試
    input:
      entity: Order
      methods: [create]
      with_transaction: true
    expect:
      contains: "@Transactional"

quality_check:
  - checkstyle: true  # 代碼風(fēng)格檢查
  - pmd: true  # 代碼質(zhì)量檢查
  - spotbugs: true  # Bug 檢查
  - compile: true  # 編譯檢查
  - unit_test: true  # 單元測(cè)試覆蓋率

# Skill 文檔模板

## 基本信息
- 名稱：XXXSkill
- 版本：1.0.0
- 作者：XXX
- 更新日期：2024-01-15

## 功能描述
簡(jiǎn)要描述 Skill 的功能和用途

## 輸入?yún)?shù)
詳細(xì)說明所有輸入?yún)?shù)

## 輸出結(jié)果
詳細(xì)說明輸出內(nèi)容

## 使用示例
提供完整的使用示例

## 注意事項(xiàng)
列出使用時(shí)需要注意的問題

## 依賴關(guān)系
列出依賴的其他 Skill

## 更新日志
記錄版本更新歷史

核心框架（Skill Engine）
    ↓
加載器（Skill Loader）
    ↓
Skill 倉(cāng)庫(kù)（Skill Repository）
    ↓
├── 官方 Skill
├── 團(tuán)隊(duì) Skill
└── 個(gè)人 Skill

# my-custom-skill.yaml

skill: MyCustomSkill
extends: BaseSkill  # 繼承基礎(chǔ) Skill
version: 1.0.0

# 自定義邏輯
custom_logic:
  template: |
    // 自定義代碼模板
    @Service
    public class ${className} {
        // ...
    }

時(shí)間：2-4 周

交付物：
? EntitySkill
? MapperSkill
? ServiceSkill
? ControllerSkill
? 基礎(chǔ)配置文件

時(shí)間：4-6 周

交付物：
? 完整的分層 Skill
? Skill 組合模式
? 統(tǒng)一配置管理
? 版本控制機(jī)制
? 質(zhì)量保障體系

時(shí)間：4-8 周

交付物：
? Skill 編排引擎
? 可視化配置界面
? 批量生成能力
? CI/CD 集成

時(shí)間：持續(xù)迭代

交付物：
? 智能 Skill 推薦
? 自動(dòng)化測(cè)試生成
? 代碼優(yōu)化建議
? 性能分析

skill-repository/
├── README.md
├── skills/
│   ├── foundation/
│   │   ├── EntitySkill/
│   │   │   ├── skill.yaml
│   │   │   ├── template.ftl
│   │   │   └── README.md
│   │   └── DTOSkill/
│   ├── data/
│   ├── service/
│   ├── controller/
│   └── common/
├── examples/
├── docs/
└── tests/

# 發(fā)布 Skill 到團(tuán)隊(duì)倉(cāng)庫(kù)

skill_publish:
  name: ServiceImplSkill
  version: 2.0.0
  category: service
  tags: [SpringBoot, MyBatisPlus, Transaction]
  author: zhangsan
  review: required  # 需要審核
  visibility: team  # 團(tuán)隊(duì)可見

假設(shè)一個(gè)團(tuán)隊(duì) 10 人，每人每天節(jié)省 2 小時(shí)
每月節(jié)省：10 人 × 2 小時(shí) × 22 天 = 440 小時(shí)
每年節(jié)?。?40 × 12 = 5280 小時(shí)
按年薪 30 萬計(jì)算（時(shí)薪約 150 元）：
每年節(jié)省成本：5280 × 150 = 79.2 萬元

需求 → 設(shè)計(jì) → 手寫代碼 → 調(diào)試 → 測(cè)試 → 上線
（每個(gè)環(huán)節(jié)都是手工完成）

需求 → 選擇 Skill → 配置參數(shù) → 生成代碼 → 組裝 → 上線
（核心是"組裝"，不是"手寫"）