# Cách dùng skill spring-boot-api-flow và genarate code trong dự án spring boot

**<span style="font-size: 16.0pt; line-height: 107%; color: #1f3864;">1.<span style="mso-spacerun: yes;"> </span>Cài đặt ban đầu </span>**

Trước khi sử dụng skill, bạn cần clone repository cấu hình về thư mục gốc của project bằng lệnh sau:

<span style="font-size: 9.0pt; line-height: 107%; font-family: 'Courier New'; mso-bidi-font-family: 'Times New Roman'; color: #c0392b;">git clone -b be\_base http://192.168.0.95/minhnd/backend\_base\_angular</span>

Lệnh trên sẽ tải branch be\_base và đặt toàn bộ src spring boot.

<span style="font-size: 9.0pt; line-height: 107%; font-family: 'Courier New'; mso-bidi-font-family: 'Times New Roman'; color: #c0392b;">git clone -b master [http://192.168.0.95/minhnd/chat-gpt-agent.git](http://192.168.0.95/minhnd/chat-gpt-agent.git) .agent</span>

Lệnh trên sẽ tải thư mục .agent về.

**Lưu ý:<span style="mso-spacerun: yes;"> </span>**Chạy lệnh này tại thư mục gốc (root) của project, không phải bên trong thư mục con nào khác.

**<span style="font-size: 16.0pt; line-height: 107%; color: #1f3864;">2.<span style="mso-spacerun: yes;"> </span>Hướng dẫn cài đặt Google Antigravity</span>**

Truy cập link sau [https://antigravity.google](https://antigravity.google)<span style="color: #4472c4; mso-themecolor: accent1;">/download</span>

[![image.png](https://docs.lifetex.vn/uploads/images/gallery/2026-03/scaled-1680-/YBkimage.png)](https://docs.lifetex.vn/uploads/images/gallery/2026-03/YBkimage.png)

<span style="mso-no-proof: yes;">  
</span>

Sau đó cài đặt như bình thường.

**<span style="font-size: 16.0pt; line-height: 107%; color: #1f3864;">3.<span style="mso-spacerun: yes;"> Chuẩn bị file SRS, CSDL cho agent</span></span>**

Để AI Skill hiểu và sinh code chính xác, bắt buộc phải cung cấp **2 file đầu vào (Context)**:

**<span class="context-scope-mention"><span class="inline-flex items-center gap-0.5 rounded-md align-middle text-sm font-medium transition-[opacity,background-color] cursor-pointer hover:bg-gray-500/20 select-text translate-y-[-1px]" draggable="true"><span class="inline-flex break-all leading-tight">csdl.txt</span></span></span> (Database Schema):** Cung cấp cấu trúc bảng, kiểu dữ liệu và các mối quan hệ (Khóa chính/Khóa ngoại). 👉 *Giúp AI định nghĩa chính xác các Entity, cấu trúc Database.*

**<span class="context-scope-mention"><span class="inline-flex items-center gap-0.5 rounded-md align-middle text-sm font-medium transition-[opacity,background-color] cursor-pointer hover:bg-gray-500/20 select-text translate-y-[-1px]" draggable="true"><span class="inline-flex break-all leading-tight">srs.txt</span></span></span> (Đặc tả nghiệp vụ):** Chứa thông tin về các Endpoint API (Mã Use Case, Method, Payload Request/Response) và các quy tắc logic (Business rules, Validation). 👉 *Giúp AI hiểu "linh hồn" của chức năng để viết Controller và tầng Service chính xác.*

**Cách AI xử lý:** AI sẽ tham chiếu chéo (Cross-reference) cấu trúc dữ liệu từ c<span class="inline-flex break-all leading-tight">sdl.txt</span> sang các logic nghiệp vụ trong <span class="context-scope-mention"><span class="inline-flex items-center gap-0.5 rounded-md align-middle text-sm font-medium transition-[opacity,background-color] cursor-pointer hover:bg-gray-500/20 select-text translate-y-[-1px]" draggable="true"><span class="inline-flex break-all leading-tight">srs.txt</span></span></span> để tạo ra bộ mã nguồn hoàn chỉnh (từ DB lên API).

[![image.png](https://docs.lifetex.vn/uploads/images/gallery/2026-03/scaled-1680-/iEkimage.png)](https://docs.lifetex.vn/uploads/images/gallery/2026-03/iEkimage.png)

**<span style="font-size: 16.0pt; line-height: 107%; color: #1f3864;">4.<span style="mso-spacerun: yes;"> </span>Hướng dẫn promt cho AI để kích hoạt skill </span>**

Để kích hoạt skill *`spring-boot-api-flow`*, bạn có thể dùng một trong **3 cách** sau. Về cơ bản, AI được cấu hình hệ thống tự động nhận diện (Intelligent Routing), nhưng bạn vẫn có thể gọi thẳng nếu muốn chắc chắn.

**1. Kích hoạt tự động (Cách tự nhiên nhất)**

Bạn chỉ cần đưa ra một yêu cầu liên quan đến việc tạo hoặc xử lý Backend Java/Spring Boot. AI (agent `backend-specialist`) sẽ tự động phân tích ngữ cảnh và áp dụng skill này.

- **Ví dụ:** *"Căn cứ vào `srs.txt` và `csdl.txt`, hãy tạo các API Spring Boot CRUD."*

*\*hoặ*

**2. Kích hoạt tường minh (Nhắc tên)**

Nếu bạn muốn ép buộc 100% AI phải nhìn vào bộ luật đó để tránh sai sót, hãy nhắc trực tiếp tên skill trong câu lệnh của bạn.

- **Ví dụ:** *"`srs.txt` và `csdl.txt` Áp dụng chuẩn của skill `spring-boot-api-flow` để viết REST API."*
- **Ví dụ:** *"Hãy dùng `spring-boot-api-flow` refactor lại file `OrderService.java` này cho tôi, nhớ áp dụng luật chia nhỏ Rule 20 dòng."*

[![image.png](https://docs.lifetex.vn/uploads/images/gallery/2026-03/scaled-1680-/4jSimage.png)](https://docs.lifetex.vn/uploads/images/gallery/2026-03/4jSimage.png)

Skill sẽ tự động đọc *`srs.txt` và `csdl.txt`* để genarate code theo chuẩn cấu trúc *`spring-boot-api-flow`*