AgentSkillsCN

spring-boot-full-stack

用于构建企业级应用的完整Java Spring Boot技能集。 包括模块化架构与可选组件： - PostgreSQL数据库与JPA/Hibernate + Flyway迁移 - Redis缓存（可选） - Kafka/RabbitMQ消息（可选，二选一） - JWT + OAuth2认证（可选OAuth2） - RBAC授权（可选） - TDD与Mockito - Spec优先开发与OpenSpec

SKILL.md
--- frontmatter
name: spring-boot-full-stack
version: 1.0.0
description: |
  Complete Java Spring Boot skill set for building enterprise applications.
  Includes modular architecture with optional components:
  - PostgreSQL database with JPA/Hibernate + Flyway migration
  - Redis caching (optional)
  - Kafka/RabbitMQ messaging (optional, choose one)
  - JWT + OAuth2 authentication (optional OAuth2)
  - RBAC authorization (optional)
  - TDD with Mockito
  - Spec-First Development with OpenSpec

author: Expert Panel (AI Generated)
tags:
  - java
  - spring-boot
  - postgresql
  - redis
  - kafka
  - rabbitmq
  - authentication
  - security
  - tdd
  - openspec

triggers:
  - "spring boot project"
  - "java backend"
  - "microservice"
  - "api development"
  - "enterprise application"

dependencies: []

Spring Boot Full Stack Skill

Overview

This skill provides a complete, modular framework for building Java Spring Boot applications with enterprise-grade features.

Quick Start

bash
# Minimal setup (PostgreSQL + JWT only)
mvn clean install -Pminimal

# With Redis caching
mvn clean install -Dmodule.redis.enabled=true

# Full stack (all modules)
mvn clean install -Pfull-stack

# Run application
mvn spring-boot:run -Dspring-boot.run.profiles=local

Module Selection

ModuleDefaultEnable Flag
PostgreSQLON-Dmodule.postgresql.enabled=true
RedisOFF-Dmodule.redis.enabled=true
KafkaOFF-Dmodule.kafka.enabled=true
RabbitMQOFF-Dmodule.rabbitmq.enabled=true
OAuth2OFF-Dmodule.oauth2.enabled=true

Development Workflow

  1. •Spec First: Define specifications in openspec/specs/
  2. •TDD: Write tests first (RED)
  3. •Implement: Write minimal code (GREEN)
  4. •Refactor: Improve code quality
  5. •Archive: Update specs after implementation

Docker Options

bash
# Without Docker (services installed locally)
make dev

# With Docker infrastructure
make dev-docker

# Full Docker deployment
docker compose --profile with-app up -d

Skills Included

Core (Always enabled)

  • •spring-project-init - Project initialization
  • •spring-maven-modular - Maven profiles & BOM
  • •spring-error-handling - Global exception handling
  • •spring-validation - Request validation
  • •spring-logging - Structured logging
  • •spring-testing - Unit + Integration testing
  • •spring-tdd-mockito - TDD with Mockito
  • •spring-openspec - Spec-First Development

Optional

  • •spring-redis - Redis caching
  • •spring-kafka - Kafka messaging
  • •spring-rabbitmq - RabbitMQ messaging
  • •spring-oauth2 - OAuth2/OIDC
  • •spring-rbac - Role-based access control
  • •spring-docker - Docker containerization
  • •spring-api-docs - OpenAPI/Swagger
  • •spring-monitoring - Actuator + Prometheus

File Structure

code
src/
├── main/
│   ├── java/
│   │   └── com/company/app/
│   │       ├── config/           # Configuration classes
│   │       ├── controller/       # REST controllers
│   │       ├── service/          # Business logic
│   │       ├── repository/       # Data access
│   │       ├── domain/           # Entities
│   │       ├── dto/              # Data transfer objects
│   │       ├── exception/        # Custom exceptions
│   │       └── security/         # Security configuration
│   └── resources/
│       ├── application.yml
│       ├── application-local.yml
│       ├── application-dev.yml
│       ├── application-prod.yml
│       └── db/migration/         # Flyway migrations
├── test/
│   └── java/
│       └── com/company/app/
│           ├── unit/             # Unit tests
│           └── integration/      # Integration tests
└── openspec/
    ├── AGENTS.md
    ├── specs/                    # Feature specifications
    └── changes/                  # Proposed changes

References