# Toàn bộ quy trinh và cấu trúc để tạo bộ skill mới

## 1. Mục đích

Phần này minh họa cách xây dựng một **AI Skill chuyên biệt** để hỗ trợ phát triển và vận hành hệ thống **WSO2 Micro Integrator (WSO2 MI)**.

Skill này đóng vai trò như một **kho tri thức (Knowledge Base)** giúp AI Agent có thể:

- Hướng dẫn viết **Synapse XML**
- Áp dụng **best practices** khi xây dựng integration
- Phát hiện **anti-patterns**
- Hỗ trợ xử lý lỗi trong WSO2 MI

Toàn bộ tri thức được tổ chức trong thư mục:

```bash
.agent/skills/wso2-mi/
```

---

# 2. Cấu trúc Skill

Thư mục `wso2-mi` được tổ chức theo từng chủ đề của WSO2 MI.

```html
.agent/
├── skills/
│ └── wso2-mi/
│ ├── SKILL.md
│ ├── mediators.md
│ ├── sequences.md
│ ├── apis.md
│ ├── endpoints.md
│ ├── error-handling.md
│ ├── connectors.md
│ ├── data-services.md
│ └── references/
```

Ý nghĩa các file:

<div class="TyagGW_tableContainer" id="bkmrk-file-m%C3%B4-t%E1%BA%A3-skill.md-"><div class="group TyagGW_tableWrapper flex flex-col-reverse w-fit" tabindex="-1"><table class="w-fit min-w-(--thread-content-width)" data-end="1687" data-start="1249"><thead data-end="1265" data-start="1249"><tr data-end="1265" data-start="1249"><th class="" data-col-size="sm" data-end="1256" data-start="1249">File</th><th class="" data-col-size="sm" data-end="1265" data-start="1256">Mô tả</th></tr></thead><tbody data-end="1687" data-start="1280"><tr data-end="1326" data-start="1280"><td data-col-size="sm" data-end="1291" data-start="1280">SKILL.md</td><td data-col-size="sm" data-end="1326" data-start="1291">File điều hướng tri thức cho AI</td></tr><tr data-end="1376" data-start="1327"><td data-col-size="sm" data-end="1342" data-start="1327">mediators.md</td><td data-col-size="sm" data-end="1376" data-start="1342">Hướng dẫn sử dụng các mediator</td></tr><tr data-end="1424" data-start="1377"><td data-col-size="sm" data-end="1392" data-start="1377">sequences.md</td><td data-col-size="sm" data-end="1424" data-start="1392">Thiết kế và sử dụng sequence</td></tr><tr data-end="1461" data-start="1425"><td data-col-size="sm" data-end="1435" data-start="1425">apis.md</td><td data-col-size="sm" data-end="1461" data-start="1435">Cách xây dựng REST API</td></tr><tr data-end="1498" data-start="1462"><td data-col-size="sm" data-end="1477" data-start="1462">endpoints.md</td><td data-col-size="sm" data-end="1498" data-start="1477">Cấu hình endpoint</td></tr><tr data-end="1539" data-start="1499"><td data-col-size="sm" data-end="1519" data-start="1499">error-handling.md</td><td data-col-size="sm" data-end="1539" data-start="1519">Cơ chế xử lý lỗi</td></tr><tr data-end="1587" data-start="1540"><td data-col-size="sm" data-end="1556" data-start="1540">connectors.md</td><td data-col-size="sm" data-end="1587" data-start="1556">Hướng dẫn sử dụng connector</td></tr><tr data-end="1640" data-start="1588"><td data-col-size="sm" data-end="1607" data-start="1588">data-services.md</td><td data-col-size="sm" data-end="1640" data-start="1607">Hướng dẫn Data Service (.dbs)</td></tr><tr data-end="1687" data-start="1641"><td data-col-size="sm" data-end="1654" data-start="1641">references</td><td data-col-size="sm" data-end="1687" data-start="1654">Chứa tài liệu nghiệp vụ riêng</td></tr></tbody></table>

</div></div>---

# 3. Agent chuyên biệt cho WSO2 MI

Một AI Agent chuyên biệt được tạo để xử lý các câu hỏi liên quan đến WSO2 MI.

Vị trí file:

```markdown
.agent/agents/wso2-mi-specialist.md
```

<div class="relative w-full my-4" id="bkmrk--2"><div class=""><div class="relative"><div class="h-full min-h-0 min-w-0"><div class="h-full min-h-0 min-w-0"><div class="border border-token-border-light border-radius-3xl corner-superellipse/1.1 rounded-3xl"><div class="h-full w-full border-radius-3xl bg-token-bg-elevated-secondary corner-superellipse/1.1 overflow-clip rounded-3xl lxnfua_clipPathFallback"><div class="pt-3"><div class="relative z-0 flex max-w-full"><div class="q9tKkq_viewer cm-editor z-10 light:cm-light dark:cm-light flex h-full w-full flex-col items-stretch ͼk ͼy" dir="ltr" id="bkmrk--3"><div class="cm-scroller"></div></div></div></div></div></div></div></div><div class=""><div class=""></div></div></div></div></div>Agent này có các đặc điểm:

- Ưu tiên sử dụng **skill `wso2-mi`**
- Tập trung hỗ trợ **WSO2 Micro Integrator**
- Áp dụng các quy tắc thiết kế integration

Ví dụ quy tắc của agent:

- Ưu tiên sử dụng **XML mediator chuẩn**
- Hạn chế viết **Script hoặc Java custom**
- Thiết kế integration theo hướng **dễ bảo trì và dễ mở rộng**

---

# 4. Tích hợp vào kiến trúc hệ thống AI

Để các Agent khác trong hệ thống có thể sử dụng skill này, cần đăng ký skill trong file kiến trúc chung:

```markdown
.agent/ARCHITECTURE.md
```

Skill `wso2-mi` được thêm vào phần:

```html
Backend & API
```

Việc này cho phép:

- Các agent khác nhận biết hệ thống đã có **chuyên gia WSO2**
- **Orchestrator Agent** có thể tự động gọi agent này khi cần hỗ trợ integration.

---

# 5. Cách sử dụng Agent

Trong quá trình làm việc, khi cần hỗ trợ về WSO2 MI, có thể gọi agent chuyên biệt:

```html
@wso2-mi-specialist
```

Khi được gọi, Agent sẽ:

1. Tự động truy cập thư mục:

```html
.agent/skills/wso2-mi/
```

<div class="relative w-full my-4" id="bkmrk--6"><div class=""><div class="relative"><div class="h-full min-h-0 min-w-0"><div class="h-full min-h-0 min-w-0"><div class="border border-token-border-light border-radius-3xl corner-superellipse/1.1 rounded-3xl"><div class="h-full w-full border-radius-3xl bg-token-bg-elevated-secondary corner-superellipse/1.1 overflow-clip rounded-3xl lxnfua_clipPathFallback"><div class="pt-3"><div class="relative z-0 flex max-w-full"><div class="q9tKkq_viewer cm-editor z-10 light:cm-light dark:cm-light flex h-full w-full flex-col items-stretch ͼk ͼy" dir="ltr" id="bkmrk--7"></div></div></div></div></div></div></div><div class=""><div class="">  
</div></div></div></div></div>2. Tìm kiếm thông tin trong các tài liệu liên quan
3. Trả lời và hướng dẫn viết **Synapse XML chuẩn** cho hệ thống.

Agent này được thiết kế để hỗ trợ phát triển các integration trong dự án **TTHC\_service**.