Tổng quan

flowchart LR
    A["Admin<br/>/ezyai/skill-library"] -->|thêm, sửa| S["Kỹ năng<br/>(post SKILL_LIBRARY)"]
    S -->|thuộc| C["Danh mục<br/>(term SKILL_CATEGORY)"]
    S --> ST{"Trạng thái"}
    ST -->|DRAFT| D["Chỉ admin thấy"]
    ST -->|INTERNAL_PUBLISHED| I["Dùng nội bộ,<br/>không hiện trên web"]
    ST -->|PUBLISHED| P["Hiện trên web<br/>/ezyai/skill-library"]
    P --> U["Người xem:<br/>xem, sao chép Markdown,<br/>tải file .md"]

Màn hình thư viện kỹ năng

Danh sách kỹ năng

• Lọc theo Trạng thái (để trống là tất cả, trừ các kỹ năng đã vào thùng
  rác), Danh mục kỹ năng và Từ khoá (tìm theo phần đầu tiêu đề).
• Chọn Số lượng mỗi trang: 30, 50, 100, 200, 500.
• Bấm vào slug để sao chép.
• Cột hành động có xem, sửa, xuất bản, xuất bản nội bộ, huỷ xuất bản và
  xoá.

Danh mục kỹ năng

Thêm kỹ năng vào thư viện

Lỗi thường gặp khi lưu

Điều gì xảy ra khi lưu

sequenceDiagram
    participant A as Admin
    participant API as Admin API
    participant T as TermService
    participant P as PostService

    A->>API: POST /ezyai/api/v1/skill-library/add
    API->>API: Kiểm tra tiêu đề, danh mục, nội dung, trạng thái
    API->>T: Tạo danh mục SKILL_CATEGORY nếu chưa có
    T-->>API: categoryId
    API->>P: Thêm bài viết SKILL_LIBRARY<br/>(nội dung Markdown, gắn danh mục)
    P-->>API: createdId
    API-->>A: Chuyển sang trang chi tiết

Viết nội dung kỹ năng

• Bắt đầu bằng một đoạn ngắn nói kỹ năng giải quyết việc gì, dùng khi nào.
• Chia thành các mục rõ ràng: điều kiện, các bước, ví dụ, lưu ý.
• Dùng code block cho lệnh, đoạn mã, mẫu prompt để người xem sao chép đúng.
• Không đưa thông tin nhạy cảm (api key, mật khẩu, token, dữ liệu cá nhân),
  nhất là với kỹ năng sẽ xuất bản công khai.

Kỹ năng này giúp AI viết release notes từ danh sách commit.

## Khi nào dùng

Khi cần tổng hợp thay đổi của một phiên bản để gửi cho người dùng.

## Các bước

1. Nhóm commit theo loại: tính năng mới, sửa lỗi, cải tiến.
2. Viết mỗi thay đổi thành một dòng, tập trung vào lợi ích cho người dùng.
3. Bỏ qua các commit chỉ sửa nội bộ (refactor, test, CI).

## Mẫu

```text
## Phiên bản x.y.z

### Tính năng mới
- ...
```

Xem, sửa và đổi trạng thái

• Sửa: mở form /ezyai/skill-library/{skillId}/edit, các trường giống
  form thêm. Khi sửa, tiêu đề không bị kiểm tra trùng.
• Mở trình soạn thảo bài viết: mở kỹ năng trong trình soạn thảo bài
  viết của ezyarticle (/ezyarticle/posts/{skillId}/edit), dùng khi cần
  các tính năng soạn thảo đầy đủ hơn.
• Xuất bản, Xuất bản nội bộ, Huỷ xuất bản: đổi trạng thái kỹ
  năng mà không cần mở form sửa.
• Xoá: chuyển kỹ năng vào thùng rác sau khi xác nhận. Kỹ năng trong
  thùng rác không còn hiện trong danh sách mặc định và không chặn việc tạo
  kỹ năng mới cùng tiêu đề.

stateDiagram-v2
    [*] --> DRAFT: Lưu
    [*] --> INTERNAL_PUBLISHED: Xuất bản nội bộ
    [*] --> PUBLISHED: Xuất bản
    DRAFT --> PUBLISHED: Xuất bản
    DRAFT --> INTERNAL_PUBLISHED: Xuất bản nội bộ
    INTERNAL_PUBLISHED --> PUBLISHED: Xuất bản
    PUBLISHED --> INTERNAL_PUBLISHED: Xuất bản nội bộ
    PUBLISHED --> DRAFT: Huỷ xuất bản
    INTERNAL_PUBLISHED --> DRAFT: Huỷ xuất bản
    DRAFT --> TRASH: Xoá
    INTERNAL_PUBLISHED --> TRASH: Xoá
    PUBLISHED --> TRASH: Xoá

Thư viện kỹ năng trên website

• Chỉ hiển thị kỹ năng ở trạng thái PUBLISHED và danh mục đang
  ACTIVATED.
• Người xem lọc theo danh mục, tìm theo từ khoá, phân trang.
• Mở một kỹ năng để xem nội dung, Sao chép Markdown hoặc Tải về
  dưới dạng file [slug].md.
• Có thể dẫn link trực tiếp tới một danh mục hoặc kết quả tìm kiếm, ví dụ
  /ezyai/skill-library?categoryId=1&keyword=release.

API quản trị

{
  "title": "Viết release notes",
  "description": "Tổng hợp commit thành release notes cho người dùng",
  "categoryName": "Viết tài liệu",
  "content": "Kỹ năng này giúp AI viết release notes từ danh sách commit...",
  "status": "PUBLISHED"
}