# agent-skills

**Repository Path**: le0zj/agent-skills

## Basic Information

- **Project Name**: agent-skills
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 1
- **Created**: 2026-03-21
- **Last Updated**: 2026-04-26

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Backend DevFlow - 后端开发AI Skill

一个标准化的后端开发工作流Skill，实现从用户故事到完整Java SpringCloud微服务代码的自动化生成。

## 核心能力

- **方案设计** - 从含PRD的用户故事中分析需求，完成模块拆分和系统设计，生成设计文档和数据库DDL
- **任务拆解** - 将设计方案转化为有序的、可验证的任务清单，明确依赖关系和验收标准
- **代码生成** - 基于模板按顺序生成Entity、Manager、Service、API、Controller、Test完整代码

## 技术栈

| 技术 | 版本 |
|------|------|
| Spring Boot | 2.7.x |
| Spring Cloud | 2021.x |
| MyBatis-Plus | 3.5.x |
| Redis/Redisson | 3.17.x |

## 工作流

```
用户故事(含PRD) → 步骤1: 方案设计(模块拆分+系统设计) → 步骤2: 任务拆解 → 步骤3: 代码实现
```

每个步骤都有**强制性人工验证检查点**，确保输出质量。

## 快速开始

### 使用方式

当用户提到以下关键词时，自动触发此Skill：
- "用户故事"
- "PQYO-xxxx"
- "后端开发"
- "Java代码实现"
- "系统设计"
- "SpringCloud代码"
- "方案设计"

### 示例

```
帮我实现 PQYO-1234 用户故事，内容是：作为学员，我可以查看我的课程学习进度
```

Skill将自动：
1. 读取 `docs/user-stories/PQYO-1234.md`
2. 生成设计文档（模块拆分 + 系统设计 + SQL）并等待验证
3. 生成任务拆解清单并等待验证
4. 按任务清单逐个生成完整Java代码

## 项目结构

```
backend-devflow/
├── SKILL.md                          # Skill主定义文件
├── references/
│   └── spring-cloud-code-rule.md     # 代码规范指南
├── tasks/
│   ├── design-task.md                # 方案设计指南
│   ├── task-breakdown-task.md        # 任务拆解指南
│   ├── implement-task.md             # 代码实现指南
│   └── deployment-task.md            # 部署配置指南
└── templates/                        # 代码生成模板
    ├── design-template.md
    ├── process-template.md
    ├── tasks-template.md
    ├── prd-template.md
    ├── modules-template.md
    ├── system-design-template.md
    ├── sql-template.md
    ├── spring-entity-template.md
    ├── spring-manage-template.md
    ├── spring-service-template.md
    ├── spring-api-template.md
    ├── spring-controller-template.md
    ├── spring-test-template.md
    ├── responsevo-template.md
    └── pager-template.md
```

## 代码规范要点

### 分层架构
```
API层 → Controller层 → Service层 → Manager层 → DAO层 → Entity层
```

### 命名规范
| 类型 | 规范 | 示例 |
|------|------|------|
| Controller | XxxController | UserController |
| Service | XxxService | UserService |
| Manager | XxxManager | UserManager |
| Entity | Xxx | User |
| DTO/VO | XxxDTO/XxxVO | UserDTO, UserVO |

### 响应规范
- 统一使用 `ResponseVO<T>` 封装响应
- 分页使用 `Pager<T>` 对象
- 业务错误码使用5位数字，前两位为模块编号

## 进度追踪

每个用户故事在 `docs/implementation/{story-id}/process.md` 维护进度：

| 标记 | 含义 |
|------|------|
| `[ ]` | 未开始 |
| `[-]` | 进行中 |
| `[*]` | 已完成，等待验证 |
| `[x]` | 已验证并批准 |
| `[!]` | 失败或需要返工 |

## 验证流程

每个步骤完成后必须等待用户验证：
- `pass` - 进行下一步
- `redo` - 返工当前步骤
- `suggestion: {详情}` - 调整并重做

## 代码生成顺序

| 顺序 | 层级 | 模板 |
|------|------|------|
| 1 | Entity | spring-entity-template.md |
| 2 | Manager | spring-manage-template.md |
| 3 | Service | spring-service-template.md |
| 4 | API | spring-api-template.md |
| 5 | Controller | spring-controller-template.md |
| 6 | Test | spring-test-template.md |

## 适用场景

- 新功能开发（从用户故事开始）
- 已有需求的代码实现
- 后端API快速原型开发
- 团队代码规范统一

## 特点

- **标准化** - 严格遵循3步骤工作流，确保输出质量
- **可验证** - 每步都有人工检查点，避免返工
- **模板化** - 丰富的代码模板，保证代码风格一致
- **可追溯** - 完整的进度追踪和文档归档