Chuyển tới nội dung chính

Bắt đầu

Cài đặt và chạy ODC-X trong vài phút.

Yêu cầu trước​

  • Python 3.11 trở lên (được uv quản lý tự động ở bước dưới)
  • AI assistant hỗ trợ custom instructions (GitHub Copilot, Claude, Cursor, v.v.)
  • Truy cập vào ODC-X Skills feed (mạng nội bộ FPT Software hoặc VPN)

Bước 1: Cài đặt uv (một lần)​

uv là trình quản lý gói dùng để cài đặt và quản lý ODC-X CLI.

Nền tảngLệnh
macOS / Linuxcurl -LsSf https://astral.sh/uv/install.sh | sh
Windowspowershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"
Homebrewbrew install uv
wingetwinget install astral-sh.uv

Bước 2: Cài đặt ODC-X CLI​

Clone repo và cài đặt bằng make:

git clone https://fpt-digital-foundry@dev.azure.com/fpt-digital-foundry/ODCX/_git/ODCX
cd ODCX
make install

Kiểm tra cài đặt:

odcx --help

Bước 3: Cấu hình CLI​

Thêm nguồn skill của FPT Software:

odcx source add default --url https://fpt-digital-foundry@dev.azure.com/fpt-digital-foundry/ODCX/_git/ODCX-Skills

Xác thực bằng FPT PAT (Personal Access Token). Chạy trình hỗ trợ xác thực tương tác:

odcx credential

Bạn sẽ được nhắc nhập tên nguồn và PAT. Sau đó đồng bộ nguồn để tải danh sách skill:

odcx source sync --all

Bước 4: Xem các Skill có sẵn​

Liệt kê skill từ nguồn đã cấu hình:

odcx skill list

Bước 5: Cài đặt Skill đầu tiên​

Cài đặt skill review code:

odcx skill install gen-code-review

Lệnh này tải skill và đăng ký vào đường dẫn hướng dẫn của AI assistant.

Bước 6: Sử dụng Skill​

Mở dự án trong VS Code và yêu cầu AI assistant:

Hãy review các thay đổi trong src/api/skills.controller.ts sử dụng skill code review

AI sẽ áp dụng framework review của skill vào code của bạn.

Quản lý Skill​

Liệt kê Skill đã cài​

odcx skill installed

Đồng bộ / Cập nhật Skill​

odcx source sync --all

Gỡ bỏ Skill​

odcx skill uninstall gen-code-review

Truy cập giao diện Marketplace​

Giao diện web ODC-X Marketplace có tại:

Duyệt skill, đọc tài liệu và xem đánh giá từ cộng đồng.

Bước tiếp theo​