{
  "status": "SUCCESS",
  "projectType": "backend",
  "framework": "Spring Boot",
  "guidelines": {
    "skill": {...},
    "documentation": {...},
    "gitignore": {...},
    "aiIgnore": {...},
    "structure": {...},
    "installation": {...},
    "validation": {...},
    "openSourceIntegration": {...}
  }
}

skills/
├── skill-name/           # 技能名称（小写连字符）
│   └── SKILL.md          # 技能定义文件（必填）

---
name: "skill-name"
description: "技能描述，简要说明技能的核心价值和用途"
trigger: "触发条件，简洁描述技能何时被触发"
disable-when: "禁用条件，描述不适合使用此技能的场景"
category: "技能分类，如：backend/frontend/database/devops/ai"
tags: ["标签1", "标签2"]
requires: ["依赖技能1", "依赖技能2"]
---
 
# 技能名称
 
## 功能描述
## 触发条件
## 何时使用
## 何时不使用
## 核心功能
## 输入参数
## 输出格式
## 使用流程
## 调用示例
## 失败案例
## 最佳实践
## 配置要求
## 扩展指南

---
name: "common-spring-boot-init"
description: "快速创建 Spring Boot 项目结构，支持多种数据库和依赖配置"
trigger: "用户请求创建新的 Spring Boot 项目时"
disable-when: "项目已存在或非 Java 技术栈项目"
category: "backend"
tags: ["spring", "java", "backend", "project-init"]
requires: ["common-db-design"]
---

## 触发条件
 
-**前置条件**：项目已初始化，具备基础目录结构
-**环境要求**：Java 21+, Maven 3.8+, Spring Boot 3.2+
-**数据准备**：配置文件 `application.yml` 已存在
-**触发方式**：API 调用 / 命令行执行 / 事件触发

## 何时不使用
 
-当项目已使用其他 ORM 框架时，不建议使用此技能
-简单的 CRUD 操作无需使用此技能
-需要复杂事务管理的场景请使用其他方案

## 失败案例
 
| 错误场景 | 错误信息 | 解决方案 |
|----------|----------|----------|
| 数据库连接失败 | `Connection refused` | 检查数据库服务是否启动 |
| 权限不足 | `Permission denied` | 确认用户有足够的文件权限 |
| 依赖缺失 | `ClassNotFoundException` | 检查 pom.xml 依赖配置 |

docs/
├── api/                  # API 文档
│   └── openapi.yaml
├── architecture/         # 架构文档
│   └── architecture.md
├── guides/               # 使用指南
│   └── getting-started.md
├── README.md             # 项目说明（根目录）
├── AGENTS.md             # 代理与技能架构（根目录）
└── SKILLS.md             # 技能清单（根目录）

# 项目名称
 
## 项目简介
## 技术栈
## 快速开始
## 项目结构
## API 接口
## 开发指南
## 部署说明
## 贡献指南
## 许可证

# 技能清单
 
## 个人定制技能
 
| 技能名称 | 描述 |
|----------|------|
| personal-backend-coding-standard | 后端编码规范技能 |
| personal-frontend-coding-standard | 前端编码规范技能 |
| personal-java-common | Java 通用工具技能 |
| personal-project-runner | 项目启动管理技能 |
| personal-doc-manager | 个人文档管理技能 |
| personal-solution-research | 方案调研技能 |
| personal-brief-style | 简洁风格技能 |
 
## 通用技能
 
| 技能名称 | 描述 |
|----------|------|
| common-project-standard | 项目规范技能 |
| common-contract-generation | 契约生成技能 |
| common-frontend-playwright-test | 前端Playwright测试技能 |
| common-backend-unit-test | 后端单元测试技能 |
| common-coding | 编码技能 |
| common-requirement-clarification | 需求澄清技能 |
| common-api-doc | API文档生成技能 |
| common-data-migration | 数据迁移技能 |
| common-db-design | 数据库设计技能 |
| common-dockerize | Docker容器化技能 |
| common-grill-me | Grill Me 深度质询技能 |
| common-spec-driven | Spec驱动规范技能 |
| common-spring-boot-init | Spring Boot项目初始化技能 |
| common-ui-design-spec | UI设计规范技能 |
| common-ui-mockup | UI原型图生成技能 |
| common-vue-init | Vue项目初始化技能 |
 
## 开源技能包装
 
| 技能名称 | 描述 | 底层实现 |
|----------|------|----------|
| os-ui-library | UI组件库技能 | 可配置（自研/Component-A/Component-B） |
| os-chat-model | 聊天模型技能 | 可配置（OpenAI/DeepSeek/Claude） |

# 代理与技能架构
 
## 概述
 
本项目使用 Trae AI 技能系统，通过技能扩展项目能力。
 
## 技能目录
 
所有技能位于 `skills/` 目录下。
 
## 技能分类
 
### 个人定制技能
-personal-backend-coding-standard - 后端编码规范
-personal-frontend-coding-standard - 前端编码规范
-personal-java-common - Java 通用工具
-personal-project-runner - 项目启动管理
-personal-doc-manager - 个人文档管理
-personal-solution-research - 方案调研
-personal-brief-style - 简洁风格
 
### 通用技能
-common-project-standard - 项目规范
-common-contract-generation - 契约生成
-common-frontend-playwright-test - 前端测试
-common-backend-unit-test - 后端测试
-common-coding - 编码规范
-common-requirement-clarification - 需求澄清
-common-api-doc - API文档生成
-common-data-migration - 数据迁移
-common-db-design - 数据库设计
-common-dockerize - Docker容器化
-common-grill-me - Grill Me 深度质询
-common-spec-driven - Spec驱动规范
-common-spring-boot-init - Spring Boot初始化
-common-ui-design-spec - UI设计规范
-common-ui-mockup - UI原型图生成
-common-vue-init - Vue项目初始化
 
## 技能使用方式
 
### 1. 安装技能
 
使用项目根目录的 `install-skills.sh` 脚本安装技能：
 

 
### 2. 注册技能
 
在 SKILLS.md 中注册技能，系统会自动加载。
 
### 3. 使用技能
 
在需要时调用相应的技能接口。
 
### 4. 验证技能规范
 

# 构建产物
target/
build/
dist/
*.class
*.jar
*.war
 
# IDE 文件
.idea/
.vscode/
.project
.classpath
.settings/
 
# 日志文件
*.log
logs/
 
# 配置文件
application-local.yml
application-local.properties
.env
 
# OS 文件
.DS_Store
Thumbs.db
 
# Maven
.mvn/
mvnw
mvnw.cmd
 
# Gradle
.gradle/
gradlew
gradlew.bat

# 数据库文件
*.db
*.sqlite
 
# JVM 相关
hs_err_pid*
replay_pid*
 
# Spring Boot
spring-shell.log

# Node.js
node_modules/
package-lock.json
yarn.lock
 
# 构建工具
.next/
.nuxt/
.svelte-kit/
 
# TypeScript
*.tsbuildinfo

# AI 模型文件
*.pt
*.pth
*.onnx
*.h5
*.bin
*.ckpt
 
# 数据集
data/
dataset/
datasets/
 
# 向量数据库
chroma/
pinecone/
qdrant/
weaviate/
 
# 缓存目录
.cache/
__pycache__/
.huggingface/
.tensorflow/
 
# 模型下载目录
models/
downloads/
checkpoints/

# API Key 文件
*.key
*.secret
api-keys.json
 
# 配置文件
config/secrets.yml
config/secrets.json
 
# 环境变量
.env.local
.env.production

# 技能缓存目录
.cache/
.skills-cache/
 
# 技能临时文件
*.tmp
*.temp
 
# 技能索引文件
skills-index.json
skills-mapping.json
 
# 日志文件
*.log
logs/
 
# 测试文件
__tests__/
*.test.js
*.spec.js
 
# 编辑器文件
.vscode/
.idea/
*.swp
*.swo
*~
 
# 系统文件
.DS_Store
Thumbs.db
 
# 技能开发文件
dev/
examples/
samples/
 
# 技能模板文件
*.template
*.stub
 
# 技能打包文件
*.zip
*.tar.gz
*.tgz
 
# 依赖目录
node_modules/
vendor/
 
# 构建产物
dist/
build/

项目根目录
├── .gitignore          # Git 版本控制忽略
├── .traeignore         # Trae 技能系统忽略
└── .trae/
    ├── skills/         # 技能目录（Git 追踪，Trae 加载）
    └── cache/          # 缓存目录（Git 忽略，Trae 忽略）

# Trae 缓存目录
.trae/cache/
.trae/.cache/
 
# Trae 临时文件
.trae/*.tmp

# 忽略技能开发目录
dev/
examples/
 
# 忽略测试文件
__tests__/
*.test.js
 
# 忽略编辑器配置
.vscode/
.idea/

# 技能内部忽略规则
node_modules/
*.log

# AI 编码助手规范（AGENTS.md）
 
## 1. 项目上下文
 
### 1.1 项目概述
{项目名称、技术栈、主要功能}
 
### 1.2 架构说明
{整体架构、模块划分、关键技术点}
 
### 1.3 代码风格
{编码规范、命名约定、格式要求}
 
## 2. 编码规则
 
### 2.1 必须遵循
-{规则1}
-{规则2}
 
### 2.2 禁止操作
-{禁止1}
-{禁止2}
 
### 2.3 最佳实践
-{实践1}
-{实践2}
 
## 3. 技能使用指引
 
### 3.1 推荐技能
-{技能名称} - {使用场景}
 
### 3.2 技能组合
-{场景} → {技能1} → {技能2}
 
## 4. 工具配置
 
### 4.1 Linter/Formatter
{ESLint、Prettier、Checkstyle等配置}
 
### 4.2 测试框架
{测试框架选择、测试覆盖率要求}
 
## 5. 安全规范
 
### 5.1 敏感信息
{API Key、密码等敏感信息处理规则}
 
### 5.2 代码审查
{PR审查要求、安全检查清单}

# AI 编码助手规范（AGENTS.md）
 
## 1. 项目上下文
 
### 1.1 项目概述
-项目名称：xx-service
-技术栈：Java 21, Spring Boot 3.2, MyBatis Plus
-主要功能：订单管理、支付处理
 
### 1.2 架构说明
-分层架构：Controller → Service → Repository
-外部调用：统一通过 infra/client 层
-配置管理：Spring Boot 配置 + 环境变量
 
### 1.3 代码风格
-命名：驼峰命名法
-格式：Google Java Style
-注释：Javadoc 风格
 
## 2. 编码规则
 
### 2.1 必须遵循
-所有外部调用必须放在 infra/client 层
-使用 @Metric 注解进行埋点
-统一使用 ThreadPoolUtils 获取线程池
-参数校验使用 @Valid + ValidateUtils
 
### 2.2 禁止操作
-禁止在 Controller 中写业务逻辑
-禁止硬编码配置值
-禁止使用 System.out.println
-禁止直接操作数据库连接
 
### 2.3 最佳实践
-优先使用枚举定义常量
-使用 DTO 进行数据传输
-异常统一处理，使用 BusinessException
-日志使用 LogUtils，分级记录
 
## 3. 技能使用指引
 
### 3.1 推荐技能
-common-coding - 编码规范指导
-common-db-design - 数据库设计
-personal-java-common - Java 通用工具
 
### 3.2 技能组合
-新建功能 → common-requirement-clarification → common-spec-driven → common-spring-boot-init
 
## 4. 工具配置
 
### 4.1 Linter/Formatter
-Checkstyle：google_checks.xml
-Spotless：Google Java Format
 
### 4.2 测试框架
-JUnit 5 + Mockito
-测试覆盖率要求：≥80%
 
## 5. 安全规范
 
### 5.1 敏感信息
-API Key 存储在环境变量
-配置文件中使用 ${ENV_VAR} 引用
-禁止提交 .env 文件
 
### 5.2 代码审查
-PR 必须通过 CI 检查
-必须有至少1个 reviewer
-安全扫描必须通过

# 构建产物
target/
build/
dist/
 
# IDE 文件
.idea/
.vscode/
 
# 日志文件
*.log
logs/
 
# 配置文件
.env
application-local.yml
 
# 系统文件
.DS_Store
Thumbs.db
 
# 依赖目录
node_modules/
 
# AI 模型文件
*.pt
*.pth
*.onnx
 
# 数据集
data/
dataset/
 
# 缓存目录
.cache/
__pycache__/

# Codeium 忽略规则
# 大文件（超过 1MB）
*.jar
*.war
*.zip
*.tar.gz
 
# 二进制文件
*.class
*.dll
*.so
 
# 日志文件
*.log
 
# 临时文件
*.tmp
*.temp
 
# 构建产物
target/
build/
dist/
 
# 依赖目录
node_modules/
 
# 缓存目录
.cache/

# Aider 忽略规则
# 大型二进制文件
*.jar
*.war
*.exe
 
# 构建目录
target/
build/
dist/
 
# 依赖目录
node_modules/
 
# 日志文件
*.log
 
# 配置文件
.env
application-local.yml
 
# IDE 文件
.idea/
.vscode/
 
# 系统文件
.DS_Store

# GitHub Copilot 忽略规则
# 敏感文件
.env
*.key
*.secret
 
# 构建产物
target/
build/
dist/
 
# 依赖目录
node_modules/
 
# 日志文件
*.log
 
# 测试报告
reports/
coverage/
 
# 临时文件
*.tmp
*.temp

项目根目录/
├── .gitignore              # Git 版本控制（最全）
├── .traeignore             # Trae 技能系统
├── .cursorignore           # Cursor AI
├── .codeiumignore          # Codeium AI
├── .aiderignore            # Aider AI
└── .copilotignore          # Copilot AI

需求澄清 → 方案设计 → 代码生成 → 规范验证 → 测试编写 → 代码审查
  ↓           ↓           ↓           ↓           ↓           ↓
grill-me   solution-    coding      code-      unit-test  code-review
           research                 review

xx-parent/                     # Maven 父模块
├── pom.xml                    # 父 POM 配置
├── xx-gateway/               # 网关模块
│   ├── pom.xml
│   └── src/main/
│       ├── java/com/bage/xx/gateway/
│       └── resources/
├── xx-biz/                   # 业务模块
│   ├── pom.xml
│   └── src/main/
│       ├── java/com/bage/xx/biz/
│       └── resources/
├── xx-infra/                 # 基础设施模块
│   ├── pom.xml
│   └── src/main/
│       ├── java/com/bage/xx/infra/
│       └── resources/
└── .trae/                    # 技能目录
    └── skills/

com/bage/xx/
├── controller/          # REST API 控制层
├── service/             # 业务逻辑层
│   └── impl/           # 服务实现
├── repository/          # 数据访问层
├── entity/              # 数据库实体
├── dto/                 # 数据传输对象
│   ├── request/        # 请求 DTO
│   └── response/       # 响应 DTO
├── config/              # 配置类
├── exception/           # 自定义异常
└── util/                # 工具类

# 从 skills 仓库安装到目标项目
bash <(curl -s https://raw.githubusercontent.com/your-repo/study-ai-skills/main/install-skills.sh) /path/to/your/project
 
# 或者克隆仓库后安装
git clone https://github.com/your-repo/study-ai-skills.git
cd study-ai-skills
./install-skills.sh /path/to/your/project

# 创建技能目录
mkdir -p /path/to/your/project/.trae/skills
 
# 复制技能（以 common-project-standard 为例）
cp -r /path/to/study-ai-skills/skills/common-project-standard /path/to/your/project/skills/

# 查看帮助
./install-skills.sh -h
 
# 列出所有可用技能
./install-skills.sh -l
 
# 安装所有技能到当前目录
./install-skills.sh .
 
# 安装所有技能到指定目录
./install-skills.sh /path/to/project
 
# 安装指定技能
./install-skills.sh -s common-coding -s personal-backend-coding-standard .
 
# 强制覆盖已存在的技能
./install-skills.sh -f -s common-project-standard .
 
# 交互式安装
./install-skills.sh -i
 
# 指定IDE安装
./install-skills.sh --ide trae .

# .trae/config.yml
skills:
  # 是否自动加载所有技能
  auto-load: true
  
  # 技能搜索路径
  paths:
    - .trae/skills
  
  # 默认启用的技能
  enabled:
    - personal-backend-coding-standard
    - personal-frontend-coding-standard
    - personal-java-common
    - personal-project-runner
    - personal-doc-manager
    - personal-solution-research
    - personal-brief-style
    - common-project-standard
    - common-coding
    - common-contract-generation
    - common-backend-unit-test
    - common-frontend-playwright-test
    - common-requirement-clarification
    - common-api-doc
    - common-data-migration
    - common-db-design
    - common-dockerize
    - common-grill-me
    - common-spec-driven
    - common-spring-boot-init
    - common-ui-design-spec
    - common-ui-mockup
    - common-vue-init

# 创建全局配置目录
mkdir -p ~/.trae
 
# 创建全局技能配置
cat > ~/.trae/skills-config.yml << 'EOF'
# 全局技能配置
skills:
  # 技能仓库位置
  repository: ~/bage/github/study/study-ai-skills/.trae/skills
  
  # 默认启用的技能
  default-enabled:
    - personal-backend-coding-standard
    - personal-frontend-coding-standard
    - common-project-standard
    - common-coding
  
  # 自动同步更新
  auto-sync: true
EOF
 
# 创建全局安装脚本链接
ln -sf ~/bage/github/study/study-ai-skills/install-skills.sh ~/.trae/install-skills.sh
 
# 添加到 PATH
echo 'export PATH="$HOME/.trae:$PATH"' >> ~/.bashrc
echo 'export PATH="$HOME/.trae:$PATH"' >> ~/.zshrc

# 验证所有技能
./validate-skills.sh
 
# 验证指定技能
./validate-skills.sh -s common-coding
 
# 列出所有技能
./validate-skills.sh -l
 
# 修复技能格式
./validate-skills.sh -f
 
# 修复指定技能
./validate-skills.sh -f -s common-coding

┌─────────────────────────────────────────────────────┐
│                    技能接口层                       │
│              (Skill Interface)                      │
│  ┌─────────────────────────────────────────────┐   │
│  │  - 统一的输入参数                            │   │
│  │  - 统一的输出格式                            │   │
│  │  - 统一的调用方式                            │   │
│  └─────────────────────────────────────────────┘   │
└─────────────────────────────────────────────────────┘
                        │
                        ▼
┌─────────────────────────────────────────────────────┐
│                    实现切换层                       │
│              (Implementation Switch)               │
│  ┌─────────────────────────────────────────────┐   │
│  │  - 配置驱动的实现选择                         │   │
│  │  - 运行时动态切换                           │   │
│  │  - 实现隔离与解耦                           │   │
│  └─────────────────────────────────────────────┘   │
└─────────────────────────────────────────────────────┘
                        │
        ┌───────────────┼───────────────┐
        ▼               ▼               ▼
┌───────────────┐ ┌───────────────┐ ┌───────────────┐
│  自研实现     │ │ 开源实现 A    │ │ 开源实现 B    │
│ (Default)    │ │ (OpenSourceA) │ │ (OpenSourceB) │
└───────────────┘ └───────────────┘ └───────────────┘

# .trae/config.yml
skills:
  open-source:
    # UI组件库实现选择: native/componenta/componentb
    os-ui-library:
      active: native
      implementations:
        - name: native
          description: 自研轻量级实现
          enabled: true
        - name: componenta
          description: 基于 Component Library A
          enabled: true
          dependencies:
            - "@componenta/core"
        - name: componentb
          description: 基于 Component Library B
          enabled: false
          dependencies:
            - "@componentb/react"
    
    # 聊天模型实现选择: openai/deepseek/claude
    os-chat-model:
      active: deepseek
      implementations:
        - name: openai
          description: OpenAI API
          enabled: true
          env:
            - OPENAI_API_KEY
        - name: deepseek
          description: DeepSeek API
          enabled: true
          env:
            - DEEPSEEK_API_KEY
        - name: claude
          description: Claude API
          enabled: true
          env:
            - CLAUDE_API_KEY

skills/
├── os-ui-library/                    # 包装技能（统一接口）
│   └── SKILL.md
├── os-ui-library-impl-native/        # 自研实现
│   └── SKILL.md
├── os-ui-library-impl-componenta/    # 组件库A实现
│   └── SKILL.md
└── os-ui-library-impl-componentb/    # 组件库B实现
    └── SKILL.md

---
name: "os-ui-library"
description: "UI组件库技能 - 支持多种实现切换"
---
 
# UI组件库技能
 
## 功能描述
 
提供统一的 UI 组件库接口，支持多种实现切换。
 
## 何时使用
 
需要使用 UI 组件时，通过配置选择不同实现。
 
## 核心功能
 
-统一的组件接口
-运行时实现切换
-多种开源组件库支持
 
## 输入参数
 
| 参数 | 类型 | 必填 | 说明 |
|------|------|------|------|
| componentType | String | 是 | 组件类型 |
| props | Object | 否 | 组件属性 |
| implementation | String | 否 | 指定实现（native/componenta/componentb） |
 
## 输出格式
 

 
## 实现配置
 
在 `.trae/config.yml` 中配置：
 

 
## 可用实现
 
| 实现名称 | 描述 | 状态 |
|----------|------|------|
| native | 自研轻量级实现 | ✅ |
| componenta | 基于 Component Library A | ✅ |
| componentb | 基于 Component Library B | ⚠️ |

# 查看当前配置
cat .trae/config.yml | grep -A 5 "os-ui-library"
 
# 切换到 Component Library A
sed -i '' 's/active: native/active: componenta/' .trae/config.yml
 
# 安装依赖（如果需要）
npm install @componenta/core
 
# 验证切换
./validate-skills.sh -s os-ui-library

project:
  name: xx
  type: backend
  modules:
    - gateway
    - biz
    - infra
 
skills:
  auto-load: true
  paths:
    - .trae/skills
  open-source:
    os-ui-library:
      active: native
    os-chat-model:
      active: deepseek

# Compiled class files
*.class
 
# Package files
*.jar
*.war
*.nar
*.ear
*.zip
*.tar.gz
*.rar
 
# Maven
target/
pom.xml.tag
pom.xml.releaseBackup
pom.xml.versionsBackup
pom.xml.next
release.properties
dependency-reduced-pom.xml
buildNumber.properties
.mvn/timing.properties
.mvn/wrapper/maven-wrapper.jar
 
# IDE
.idea/
*.iws
*.iml
*.ipr
.vscode/

# Dependencies
node_modules/
 
# Build outputs
dist/
build/
.next/
.nuxt/
 
# TypeScript
*.tsbuildinfo
*.log
 
# IDE
.vscode/
.idea/
 
# Environment
.env
.env.local
.env.*.local

# Model files
*.pt
*.pth
*.onnx
*.h5
*.bin
*.ckpt
*.joblib
*.pickle
 
# Datasets
data/
dataset/
datasets/
 
# Vector databases
chroma/
pinecone/
qdrant/
 
# Cache
.cache/
__pycache__/
.huggingface/
.tensorflow/