Cài đặt & Vận hành
Tất cả trang bị cần thiết để khởi chạy một môi trường bền bỉ cho AI Agent, tham chiếu tương thích nền tảng và cách sử dụng dòng lệnh cốt lõi.
Yêu cầu Hệ thống
PARA Workspace v1.6.5 tương thích tốt với môi trường Linux và Windows (Git Bash). Dưới đây là bảng đánh giá tương thích dành cho các IDE làm việc với AI Agent trong không gian.
| Nền tảng | Điểm tích hợp | Trạng thái | Ghi chú |
|---|---|---|---|
| Google Antigravity | .agent/ (skills, workflows) | ✅ Verified | Thiết kế và test chuyên cho nền tảng này |
| Claude Code | CLAUDE.md + .agent/ | ⚪ Chưa kiểm chứng | Có thể đọc `.agent/rules/` — cần xác nhận |
| Cursor | .cursor/rules/ | ⚪ Chưa test | Lý thuyết: copy rules sang `.cursor/rules/` |
| VS Code + Copilot | .github/copilot-instructions | ⚪ Chưa test | Lý thuyết: chỉ instructions, không auto-trigger |
Các bước triển khai
Tải mã nguồn Framework
Clone hệ thống lõi vào mục Resources (đây là nơi chứa tài liệu tham khảo cốt lõi, hoàn toàn không dính líu đến source dự án).
git clone https://github.com/pageel/para-workspace.git Resources/references/para-workspace
Thiết lập phân quyền
Đảm bảo script tải CLI có quyền thực thi (Chỉ dành cho Linux/macOS).
chmod +x Resources/references/para-workspace/cli/commands/*.sh
Khởi tạo Workspace
Khởi tạo giao diện tương tác thông qua định nghĩa cấu hình Profile mà bạn làm việc.
Lựa chọn vai trò để tạo cấu trúc thư mục đặc biệt (`dev`, `marketer`, v.v) cùng với tài liệu bằng ngôn ngữ địa phương (`en`, `vi`).
Bảo trì & Vận hành
Giữ workspace đồng bộ với phiên bản framework mới nhất thông qua các lệnh CLI tích hợp sẵn cơ chế bảo vệ.
sync para update
v1.6.5 Đồng bộ kernel, rules, workflows, và skills từ repo framework về workspace. Tự động backup file hiện tại và dùng Smart Archive để lưu trữ an toàn các file lỗi thời.
./para update --dry-run /update trong chat IDE cleaning_services para cleanup
v1.6.5 Dọn dẹp các session rollback cũ, file .bak dư thừa, và sắp xếp thư mục backup. Lưu trữ mặc định 5 ngày.