# 角色：你是资深技术文档工程师# 任务：根据项目结构和核心代码，生成专业README请分析以下项目结构和关键文件，生成一份完整的README.md：## 输入1. 项目目录结构（tree命令输出）2. pom.xml / package.json / go.mod（依赖与技术栈）3. 核心入口文件（Application.java / main.py / index.ts）4. 配置文件（application.yml / .env.example）## 输出要求README需包含以下模块：- 项目名称与一句话描述- 功能特性（Features）- 技术栈（Tech Stack）- 快速开始（Quick Start）：环境要求 + 安装步骤- 项目结构说明（Structure）- API概览（核心接口列表）- 配置说明（Configuration）- 贡献指南（Contributing）- 开源协议（License）风格要求：简洁、可操作、代码块用正确的语法高亮标记。

user-service/├── src/main/java/com/example/userservice/│   ├── UserServiceApplication.java    # 启动类│   ├── controller/│   │   └── UserController.java         # REST接口│   ├── service/│   │   └── UserService.java            # 业务逻辑│   ├── repository/│   │   └── UserRepository.java         # 数据访问│   └── model/│       ├── User.java                   # 实体类│       └── dto/                        # 数据传输对象├── src/main/resources/│   └── application.yml                 # 配置文件└── pom.xml                             # Maven依赖

# README.md（AI生成）# UserService - 用户服务> 基于Spring Boot 3.2的微服务用户管理系统，> 提供用户注册、登录、信息管理等核心能力。## 功能特性- 用户注册与登录（JWT认证）- 用户信息CRUD操作- 基于角色的权限管理（RBAC）- 操作日志审计## 技术栈| 层级 | 技术选型 ||------|---------|| 框架 | Spring Boot 3.2.1 || ORM | MyBatis-Plus 3.5.5 || 数据库 | MySQL 8.0 || 缓存 | Redis 7.0 || 认证 | JWT (jjwt 0.12.3) |## 快速开始### 环境要求- JDK 17+- Maven 3.8+- MySQL 8.0+- Redis 7.0+### 安装步骤```bash# 1. 克隆仓库git clone https://github.com/example/user-service.git# 2. 配置数据库cp src/main/resources/application.yml.example application.yml# 修改数据库连接信息# 3. 启动服务mvn spring-boot:run```...（省略后续模块）

@RestController@RequestMapping("/api/users")public class UserController {    @Autowired    private UserService userService;    @GetMapping("/{id}")    public User getUser(@PathVariable Long id) {        return userService.findById(id);    }    @PostMapping    public User createUser(@RequestBody UserDTO dto) {        return userService.create(dto);    }    @PutMapping("/{id}")    public User updateUser(@PathVariable Long id,                           @RequestBody UserDTO dto) {        return userService.update(id, dto);    }    @DeleteMapping("/{id}")    public void deleteUser(@PathVariable Long id) {        userService.delete(id);    }}

# 角色：你是Swagger/OpenAPI文档专家# 任务：为Controller自动添加Swagger注解请为以下Controller代码添加完整的Swagger3注解（springdoc-openapi）：要求：1. 类级别添加 @Tag（模块名称+描述）2. 每个接口添加 @Operation（summary + description）3. 参数添加 @Parameter（name + description + required）4. 返回值添加 @ApiResponses（成功/失败场景）5. 请求体添加 @Schema 注解到DTO类6. 保持原有业务逻辑不变，只添加注解输入Controller代码：[粘贴上面的UserController代码]

@RestController@RequestMapping("/api/users")@Tag(name = "用户管理", description = "用户CRUD接口")public class UserController {    @Autowired    private UserService userService;    @GetMapping("/{id}")    @Operation(summary = "根据ID查询用户",              description = "返回指定ID的用户详细信息")    @ApiResponses({        @ApiResponse(responseCode = "200", description = "查询成功"),        @ApiResponse(responseCode = "404", description = "用户不存在")    })    public User getUser(            @Parameter(name = "id", description = "用户ID", required = true)            @PathVariable Long id) {        return userService.findById(id);    }    @PostMapping    @Operation(summary = "创建用户",              description = "根据传入的用户信息创建新用户")    @ApiResponses({        @ApiResponse(responseCode = "201", description = "创建成功"),        @ApiResponse(responseCode = "400", description = "参数校验失败")    })    public User createUser(            @Parameter(description = "用户创建信息", required = true)            @RequestBody UserDTO dto) {        return userService.create(dto);    }    @PutMapping("/{id}")    @Operation(summary = "更新用户信息",              description = "根据ID更新用户信息")    @ApiResponses({        @ApiResponse(responseCode = "200", description = "更新成功"),        @ApiResponse(responseCode = "404", description = "用户不存在")    })    public User updateUser(            @Parameter(name = "id", description = "用户ID", required = true)            @PathVariable Long id,            @Parameter(description = "用户更新信息", required = true)            @RequestBody UserDTO dto) {        return userService.update(id, dto);    }    @DeleteMapping("/{id}")    @Operation(summary = "删除用户",              description = "根据ID删除指定用户")    @ApiResponses({        @ApiResponse(responseCode = "204", description = "删除成功"),        @ApiResponse(responseCode = "404", description = "用户不存在")    })    public void deleteUser(            @Parameter(name = "id", description = "用户ID", required = true)            @PathVariable Long id) {        userService.delete(id);    }}

# 角色：你是版本管理专家# 任务：将git log转换为结构化Changelog请将以下git log转换为 Keep a Changelog 格式的CHANGELOG.md：规则：1. 按 commit type 分类：feat→Added, fix→Fixed,   perf→Changed, refactor→Changed, docs→Docs,   BREAKING CHANGE→Removed/Changed2. 合并语义相同的提交3. 过滤无意义的merge commit和chore4. 每个条目附带commit hash前8位作为引用5. 版本号从tag中提取输入git log：[粘贴 git log --oneline --pretty=format:"%h%s" 输出]

# git log输入a1b2c3d4 feat: 新增用户批量导入功能，支持Excel模板下载e5f6g7h8 fix: 修复用户登录时token过期时间计算错误i9j0k1l2 feat: 添加用户头像上传接口，限制2MBm3n4o5p6 refactor: 重构UserService，抽取公共校验逻辑q7r8s9t0 fix: 修复分页查询totalCount为0的问题u1v2w3x4 BREAKING CHANGE: 用户接口返回字段从userId改为idy5z6a7b8 docs: 更新API文档示例c9d0e1f2 perf: 优化用户列表查询，添加联合索引g3h4i5j6 chore: 升级Spring Boot到3.2.1

# CHANGELOG.md（AI生成）# ChangelogAll notable changes to this project will be documented in this file.## [v2.1.0] - 2026-09-15### Added- 新增用户批量导入功能，支持Excel模板下载 (a1b2c3d4)- 添加用户头像上传接口，限制2MB (i9j0k1l2)### Fixed- 修复用户登录时token过期时间计算错误 (e5f6g7h8)- 修复分页查询totalCount为0的问题 (q7r8s9t0)### Changed- 重构UserService，抽取公共校验逻辑 (m3n4o5p6)- 优化用户列表查询，添加联合索引 (c9d0e1f2)- ⚠️ BREAKING CHANGE: 用户接口返回字段  从 userId 改为 id (u1v2w3x4)### Docs- 更新API文档示例 (y5z6a7b8)### Internal- 升级Spring Boot到3.2.1 (g3h4i5j6)

# 角色：你是软件架构师# 任务：分析项目结构，生成Mermaid架构图请分析以下项目的模块结构和依赖关系，生成 Mermaid C4-Context 架构图：要求：1. 识别系统中的核心组件（服务、数据库、消息队列等）2. 标注组件之间的依赖关系和数据流向3. 使用C4模型的Context层次4. 添加中文标注说明输入项目结构：user-service/├── controller/   → 接收HTTP请求├── service/      → 业务逻辑，调用repository├── repository/   → 数据访问，连接MySQL├── cache/        → Redis缓存层├── mq/           → Kafka消息生产者└── config/       → 配置中心，读取Nacos

```mermaidC4Context    title 用户服务架构图 (UserService)    Person(user, "客户端", "Web/App/第三方调用方")    System(userservice, "UserService", "用户管理微服务")    System_Ext(mysql, "MySQL", "用户数据持久化")    System_Ext(redis, "Redis", "热点数据缓存")    System_Ext(kafka, "Kafka", "异步消息队列")    System_Ext(nacos, "Nacos", "配置中心")    Rel(user, userservice, "HTTP/REST API", "JSON")    Rel(userservice, mysql, "读写", "JDBC/MyBatis")    Rel(userservice, redis, "缓存读写", "Lettuce")    Rel(userservice, kafka, "发送事件", "Protobuf")    Rel(userservice, nacos, "拉取配置", "HTTP")    UpdateRelStyle(user, userservice, $offsetX="-30")    UpdateRelStyle(userservice, mysql, $offsetY="-20")```

┌──────────┐     ┌──────────────┐     ┌──────────────┐     ┌──────────────┐│  开发者   │────▶│  PR 合并到   │────▶│  AI 分析     │────▶│  自动更新    ││  提交PR   │     │  main 分支   │     │  代码 diff   │     │  文档文件    │└──────────┘     └──────────────┘     └──────────────┘     └──────┬───────┘                                                           │                     ┌──────────────┐     ┌──────────────┐  │                     │  文档随代码   │◀────│  创建文档    │◀─┘                     │  一起上线    │     │  更新 PR     │                     └──────────────┘     └──────────────┘                           ▲                           │                    ┌──────┴───────┐                    │  人工 Review  │                    │  确认无误后   │                    │  合并文档 PR  │                    └──────────────┘

# .github/workflows/doc-auto-update.ymlname: AI Doc Auto Updateon:  pull_request:    types: [closed]    branches: [main]jobs:  update-docs:    if: github.event.pull_request.merged == true    runs-on: ubuntu-latest    steps:      - name: Checkout code        uses: actions/checkout@v4        with:          fetch-depth: 0      - name: Get changed files        id: changed        run: |          git diff --name-only HEAD~1 HEAD > changed.txt          echo "files=$(cat changed.txt)" >> $GITHUB_OUTPUT      - name: AI generate docs        env:          AI_API_KEY: ${{ secrets.AI_API_KEY }}        run: |          # 分析diff，判断需要更新哪些文档          # 调用AI生成更新后的文档内容          python scripts/ai_doc_generator.py \            --diff changed.txt \            --output docs/      - name: Create doc update PR        uses: peter-evans/create-pull-request@v6        with:          title: "docs: AI自动更新文档"          body: "本PR由CI自动生成，请review文档变更"          branch: docs/auto-update          labels: documentation, auto-generated