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

 

1.  Cài đặt ban đầu 

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:

git clone -b be_base http://192.168.0.95/minhnd/backend_base_angular

Lệnh trên sẽ tải branch be_base  và đặt toàn bộ src spring bootboot.

kèm

git clone -b master http://192.168.0.95/minhnd/chat-gpt-agent.git .agent

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

Lưu ý:  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.

2.  Hướng dẫn cài đặt Google Antigravity

Truy cập link sau https://antigravity.google/download

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

3.  Chuẩn bị file SRS, CSDL cho agent

Để 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):

csdl.txt (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.

srs.txt (Đặ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ừ csdl.txt sang các logic nghiệp vụ trong srs.txt để tạo ra bộ mã nguồn hoàn chỉnh (từ DB lên API).

 

4.  Hướng dẫn promt cho AI để kích hoạt skill 

Để 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."

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