Báo cáo tổng hợp các tích hợp trong môi trường Antigravity - Hệ thống VinhPhatERP v3
1. Giao thức kết nối mở rộng (MCP Servers - Model Context Protocol)
Được cấu hình tại .agents/mcp_config.json:
| Tên Server |
Gói triển khai |
Vai trò & khả năng tích hợp |
| stitch |
@_davideast/stitch-mcp |
Tạo giao diện prototype từ mô tả text, quản lý màn hình (screens), đồng bộ Design System và tải assets thiết kế từ Google Stitch. |
| gdrive |
@modelcontextprotocol/server-gdrive |
Kết nối trực tiếp tài khoản Google Drive để đọc, ghi tài liệu, xuất/nhập file bảng tính và dữ liệu lưu trữ đám mây. |
2. Công cụ tích hợp sẵn (Antigravity Native Capabilities)
Các công cụ cốt lõi tích hợp sâu trong agent runtime:
| Công cụ |
Chức năng |
| Browser Automation (browser_subagent) |
Điều khiển trình duyệt ảo Chromium độc lập, click/gõ/điều hướng, chụp screenshot và ghi hình toàn bộ phiên làm việc thành video .webp. |
| Tạo hình ảnh AI (generate_image) |
Tự động sinh mockup giao diện, hình ảnh minh họa hoặc tài nguyên đồ họa qua AI. |
| Tìm kiếm & bóc tách web |
search_web (truy vấn Google thời gian thực) và read_url_content (đọc nội dung tài liệu kỹ thuật từ URL thành markdown). |
| Quản trị hệ thống & tiến trình |
run_command (chạy PowerShell cục bộ an toàn), manage_task (quản lý tiến trình chạy nền), schedule (hẹn giờ one-shot hoặc cron-job định kỳ). |
| Tương tác đa lựa chọn (ask_question) |
Hiển thị hộp thoại Modal trắc nghiệm để người dùng ra quyết định khi gặp ngã rẽ thiết kế. |
3. Hệ thống 6 quy trình tác vụ (Workflows)
Nằm trong .agents/workflows/:
| Workflow |
Mô tả |
| /browser-automation |
Quy trình 5 bước mở trình duyệt tự động kiểm thử UI & xác thực quyền Admin/Khách hàng trên Local (localhost:5173) hoặc Cloud VPS (103.213.216.31). |
| /spec-driven-workflow |
Phát triển theo đặc tả (Spec-Driven Development) với cơ chế Approval Gates (Proposal → Delta Spec → Code). |
| /6step_workflow |
Quy trình 6 bước chuẩn hóa tìm kiếm và triệt tiêu lỗi (Root Cause Debugging). |
| /git-workflow |
Quy trình Git ERP (tạo nhánh tính năng, branch guard, commit an toàn, pre-push checks). |
| /auto-save-form |
Triển khai tự động lưu nháp (draft recovery) cho các form nhập liệu phức tạp. |
| /plugin-system-refactoring |
Tái cấu trúc hệ thống plugin Level 9 & Feature Registry. |
4. Hệ thống 16 kỹ năng chuyên biệt (Skills)
Nằm trong .agents/skills/:
Nghiệp vụ ERP & dệt may
| Skill |
Mô tả |
| vinhphat-copilot |
Hiểu sâu luồng dệt sợi, nhuộm vải, tồn kho cuộn mộc/thành phẩm. |
| misa-sync-automation |
Bóc tách hóa đơn điện tử XML (Thông tư 78), đồng bộ dữ liệu MISA ASP sang ERP. |
| erp-tdd |
Viết test TDD cho các công thức tính giá dệt nhuộm, tồn kho, công nợ trước khi gắn vào UI. |
| erp-debug-guard |
Debug an toàn, chống thất thoát hoặc sai lệch số liệu kho/công nợ. |
| bigdata-perf |
Tối ưu bảng dữ liệu lớn, virtualization (TanStack Virtual), chống giật lag UI. |
Thiết kế UI/UX & thương hiệu
| Skill |
Mô tả |
| erp-uiux-pro |
Tiêu chuẩn công thái học giao diện ERP doanh nghiệp dệt may (high-density layout). |
| ui-ux-pro-max |
Kho tri thức thiết kế chuyên sâu (79 style, 192 bảng màu, 74 bộ font). |
| ui-styling |
Chuẩn hóa Shadcn/UI, Radix UI và Tailwind CSS Design Tokens. |
| design-system & design |
Quản trị token 3 tầng, xuất bản bộ nhận diện CIP, logo doanh nghiệp. |
| banner-design & slides |
Tạo slide thuyết trình HTML động và banner truyền thông. |
| brand |
Quản lý phong cách và giọng văn thương hiệu Dệt May Vĩnh Phát. |
Kiểm định chất lượng & bảo mật
| Skill |
Mô tả |
| review-guard |
Rà soát code đa trục (Correctness, Architecture, Security, Performance). |
| security-audit |
Rà soát lỗ hổng API, Multi-tenant RLS policy, chống rò rỉ secret key. |
| browser-automation |
Hướng dẫn kiểm thử thực tế trên trình duyệt thật. |
5. Cơ chế quản trị & kỷ luật kỹ thuật (AI Governance & Architecture Guard)
Hệ thống luật bắt buộc được nhúng vào lõi agent:
| Thành phần |
Nội dung |
| Hiến pháp .erp-rules.md |
22 quy tắc kỹ thuật bất biến (Multi-Tenancy tenant_id, cấm sửa schema ngoài ý muốn, cấm sửa nghiệp vụ nhạy cảm). |
| Quy trình AI_WORKFLOW.md |
5 Gate phê duyệt nghiêm ngặt (chỉ đi tiếp khi có token chuẩn như APPROVE PHASE 2). |
| ESLint |
Cấm hoàn toàn Emoji (no-emoji), cấm mã màu hardcode (no-hardcoded-colors), cấm thẻ <select> native (no-raw-select), cấm import chéo feature. |
| Stylelint |
Cấm mã màu tĩnh trong .css, bắt buộc dùng CSS Variable Semantic Tokens. |
| RPC Guard (npm run rpc:check) |
Kiểm tra đồng bộ 100% giữa hàm RPC gọi từ frontend với PostgreSQL functions. |
6. Tích hợp dịch vụ & nền tảng bên thứ ba (Hạ tầng dự án)
| Dịch vụ / Nền tảng |
Vai trò |
| Supabase Cloud/Local |
Cơ sở dữ liệu PostgreSQL, Row Level Security (RLS), Auth, Storage Buckets và RPC stored procedures. |
| Mô hình AI đa nguồn |
Tích hợp cả @google/genai (Gemini 3.6/3.8 Flash & Pro) và @anthropic-ai/sdk (Claude) trực tiếp trong source code web app. |
| Microsoft Playwright |
Bộ kiểm thử E2E tự động hóa và so sánh trực quan (Visual Regression). |
| Sentry (@sentry/react) |
Bắt và phân tích lỗi ngoại lệ người dùng trên môi trường live. |
| Cloud VPS (103.213.216.31) |
Triển khai máy chủ ứng dụng qua Nginx và Docker. |