Từ máy mới tinh đến dự án đầu tiên cùng trợ lý AI

Giới thiệu ACI Kit

Agent Code Intelligent (ACI Kit) là bộ giải pháp và tiêu chuẩn kỹ thuật toàn diện của công ty, kết hợp sức mạnh của các trợ lý AI hàng đầu (Claude Code, Google Antigravity) với quy trình kỹ thuật chuẩn mực để tạo ra phần mềm hoàn chỉnh, an toàn và sẵn sàng chạy trên máy chủ.

Hệ sinh thái công cụ

ACI Kit kết nối liền mạch giữa trợ lý AI, bộ công cụ tự động hóa nội bộ và hạ tầng máy chủ:

Ngôn ngữ lập trình & Công nghệ chuẩn

Thống kê và chuẩn hoá từ 17 dự án thực tế của công ty. Toàn bộ dự án tuân theo một bộ khung công nghệ đồng nhất:

Luồng hoạt động từ ý tưởng đến máy chủ

Quy trình khép kín 5 bước biến một ý tưởng kinh doanh thành sản phẩm thực tế hoạt động trên môi trường sản xuất:

Chọn lộ trình của bạn

Cần chuẩn bị gì trước khi cài

• Máy tính: Windows 10 (bản 1809 trở lên), Windows 11, hoặc máy Mac chạy macOS 12 trở lên. Ổ đĩa còn trống từ 10 GB.
• Quyền trên máy: bạn biết mật khẩu đăng nhập máy (với Mac), hoặc được phép bấm Yes khi Windows hỏi quyền. Máy công ty bị khóa quyền thì nhờ IT ngồi cùng.
• Tài khoản: một tài khoản Google để dùng Antigravity và một tài khoản Claude do công ty cấp.
• Bộ kit: đã bấm Tải ACI Kit và thấy file AgentCodeIntelligent.zip trong thư mục Downloads.

Trong bộ kit có gì

Cứ hình dung trợ lý AI là một lập trình viên mới vào, rất giỏi nhưng chưa biết gì về công ty. ACI Kit là bộ tài liệu nhập môn mình đưa cho người đó:

Cài tự động từng bước

1. Tải và giải nén bộ kit

   Bấm nút dưới đây để tải. Tải xong, mở thư mục Downloads, chuột phải vào AgentCodeIntelligent.zip, chọn Properties, tích ô Unblock (nếu có) rồi bấm OK. Sau đó chuột phải thêm lần nữa, chọn Extract All… rồi bấm Extract.

   Tải ACI Kit Bạn sẽ thấy thư mục AgentCodeIntelligent, bên trong có file CAI-DAT-WINDOWS.bat.

2. Bấm đúp vào CAI-DAT-WINDOWS.bat

   Nếu hiện khung màu xanh “Windows protected your PC”, bấm More info rồi Run anyway. File này do công ty phát hành, bạn cứ yên tâm.

   Bạn sẽ thấy một cửa sổ nền đen hiện dòng chữ “ACI Kit - cài đặt môi trường làm việc (Windows)”.

3. Bấm Yes mỗi khi Windows hỏi

   Hộp thoại “Do you want to allow this app to make changes to your device?” sẽ hiện vài lần, mỗi lần cài một phần mềm (Git, Node.js, Antigravity…). Lần nào cũng bấm Yes.

4. Nhập họ tên và email

   Khi được hỏi, gõ họ tên của bạn (không dấu cũng được) rồi bấm Enter, sau đó gõ email công ty rồi bấm Enter. Thông tin này dùng để ghi tên người sửa code.

5. Chờ khoảng 15–20 phút

   Đừng tắt cửa sổ. Dòng có [OK] màu xanh là đã xong, dòng [!] màu vàng là bỏ qua được.

   Cuối cùng sẽ có phần “KẾT QUẢ” và danh sách “Việc bạn cần tự làm”. Bạn nên chụp màn hình phần này lại.

6. Đóng cửa sổ và chuyển sang phần Đăng nhập

1. Tải và giải nén bộ kit

   Bấm nút dưới đây để tải. Tải xong, mở Finder, vào thư mục Downloads (Tải về) và bấm đúp vào file AgentCodeIntelligent.zip. Nếu tải bằng Safari, máy có thể đã tự giải nén sẵn.

   Tải ACI Kit Bạn sẽ thấy thư mục AgentCodeIntelligent nằm trong Downloads.

2. Mở Terminal và dán một dòng lệnh

   Bấm ⌘ + Space, gõ Terminal rồi bấm Enter. Bấm Sao chép ở khung dưới, dán vào Terminal (⌘ + V) rồi bấm Enter.

   TerminalSao chép

   bash ~/Downloads/AgentCodeIntelligent/setup/macos/setup.sh

   Bạn sẽ thấy dòng chữ “ACI Kit: cài đặt môi trường làm việc (macOS)”.

3. Nhập mật khẩu máy Mac khi được hỏi

   Khi thấy chữ Password:, gõ mật khẩu bạn vẫn dùng để mở máy rồi bấm Enter. Lúc gõ sẽ không thấy ký tự nào hiện lên, đó là bình thường.

4. Nếu hiện hộp thoại cài “Command Line Developer Tools”

   Bấm Install, rồi Agree, chờ cài xong khoảng 5–10 phút.

5. Nhập họ tên và email

   Gõ họ tên rồi bấm Enter, gõ email công ty rồi bấm Enter.

6. Chờ khoảng 15–20 phút rồi đọc phần “KẾT QUẢ”

   Dòng có dấu ✓ xanh là đã xong, dấu ! vàng là bỏ qua được. Xong thì chuyển sang phần Đăng nhập.

powershell -NoProfile -ExecutionPolicy Bypass -File "$HOME\Downloads\AgentCodeIntelligent\setup\windows\setup.ps1"

Bộ cài sẽ cài những gì

Đăng nhập (chỉ làm một lần)

• Antigravity: mở ứng dụng Antigravity, chọn Sign in with Google rồi chọn tài khoản công ty cấp.
• Claude Code: mở PowerShellTerminal, gõ claude rồi bấm Enter. Trình duyệt sẽ mở ra để bạn đăng nhập tài khoản Claude. Xong thì quay lại cửa sổ lệnh và gõ /exit.
• Plugin Antigravity (nếu bộ cài có nhắc): trong Antigravity vào Customizations, chọn Marketplace, bấm + ở ba plugin chrome-devtools-plugin, modern-web-guidance-plugin và google-antigravity-sdk.

Kiểm tra máy đã sẵn sàng

Mở Antigravity hoặc Claude Code rồi gõ:

kiểm tra môi trường giúp tôi

Hoặc tự chạy lệnh:

node "$env:USERPROFILE\.aci\tools\aci.mjs" env

node ~/.aci/tools/aci.mjs env

Nếu mọi thứ ổn, bạn sẽ thấy gần giống thế này:

Bắt buộc
✓ Node.js từ 18.17 trở lên  v24.11.0
✓ npm  11.6.1
✓ Git  git version 2.51.0
✓ Git đã có tên và email  Nguyễn Văn An <an@congty.vn>
✓ ACI Kit ở ~/.aci  v1.0.0
✓ Có ít nhất một trợ lý AI  Claude Code, Antigravity, Antigravity IDE
✓ Kỹ năng ACI cho Claude Code
✓ Kỹ năng ACI cho Antigravity

Máy đã sẵn sàng. Mở Antigravity hoặc Claude Code để bắt đầu làm việc.

• Đã thấy dòng “Máy đã sẵn sàng”.

Mở dự án

Nói thế nào cho trợ lý hiểu

• Nói mục tiêu, đừng nói cách làm. Câu “Nhân viên cần biết khách nào sắp tới hạn tái khám” tốt hơn “thêm cột ngày vào bảng”.
• Kể bối cảnh: ai sẽ dùng, dùng trên điện thoại hay máy tính, đã có sẵn dữ liệu Excel chưa.
• Mỗi lần nhờ một việc. Xong việc này, kiểm tra lại rồi hãy nhờ việc tiếp theo.
• Đọc kế hoạch trước khi đồng ý. Với việc lớn, trợ lý sẽ viết bản đặc tả hoặc kế hoạch và hỏi bạn duyệt.
• Báo lỗi kèm bằng chứng: ảnh chụp màn hình, nguyên văn thông báo lỗi, và bạn đã bấm gì thì bị lỗi.
• Không dán mật khẩu hay khóa API vào cuộc trò chuyện. Trợ lý sẽ chỉ bạn tự điền vào file cấu hình.

Câu nói mẫu

Bấm “Sao chép”, dán vào khung chat của trợ lý rồi sửa lại cho đúng việc của bạn.

Làm dự án mới từ ý tưởng: trợ lý sẽ làm gì

1. Làm rõ

   Trợ lý hỏi tối đa 5–7 câu, câu nào cũng kèm phương án gợi ý: ai dùng, cần quản lý những gì, liên lạc với khách qua kênh nào, có dùng AI không, chạy ở máy chủ nào.

2. Viết đặc tả docs/SPEC.md

   Gồm mục tiêu, vai trò, chức năng, dữ liệu, màn hình, phạm vi bản đầu tiên và rủi ro. Bạn đọc và duyệt rồi mới bắt đầu code.

3. Dựng khung

   Lệnh aci new tạo dự án có sẵn đăng nhập, quản lý người dùng, giao diện sáng tối, bảo mật, nhật ký thao tác, đường nối sẵn tới AI và tài liệu.

4. Sinh chức năng

   Mỗi đối tượng (khách hàng, lịch hẹn, đơn hàng…) chỉ cần một lệnh aci module là có bảng dữ liệu, API và màn hình có tìm kiếm, lọc, thêm, sửa, xóa.

5. Làm phần riêng và chạy thử

   Trợ lý viết phần nghiệp vụ đặc thù, chạy test, build giao diện, kiểm tra chuẩn bằng aci doctor rồi chỉ bạn cách mở thử.

10 kỹ năng của trợ lý

Trợ lý tự chọn kỹ năng dựa vào câu bạn nói. Muốn chỉ định thì gõ /aci-deploy, /aci-fix-bug… (cả Claude Code lẫn Antigravity đều hiểu).

Cấu trúc dự án chuẩn

BackEnd/                 máy chủ API: Node.js, Express, SQL Server
  app.js                 điểm khởi động
  ecosystem.config.cjs   cấu hình PM2 trên máy chủ
  config/schema.sql      toàn bộ bảng dữ liệu (chạy lại được, không xóa gì)
  src/routes/            mỗi chức năng một file API
  src/services/          phần nghiệp vụ dùng chung
  src/ai/                cổng duy nhất để gọi AI
  tests/                 kiểm thử tự động
FE/                      giao diện: React, Vite, Bootstrap
  src/config/modules.js  danh sách menu và trang (thêm chức năng là thêm 1 dòng)
  src/pages/             mỗi màn hình một file
  src/theme.css          bảng màu sáng và tối
  public/web.config      cấu hình IIS trên máy chủ Windows
docs/SPEC.md             bản đặc tả nghiệp vụ
AGENTS.md                ghi chú riêng của dự án cho mọi trợ lý AI
deploy.config.json       thông tin máy chủ để "đẩy lên server"

Đẩy lên server

Bạn chỉ cần nói “đẩy lên server”. Trợ lý sẽ:

1. Kiểm tra

   Chạy test và dò xem có mật khẩu, khóa nào lọt vào code không. Phát hiện là dừng ngay, không gửi đi.

2. Đóng gói và tải lên

   Build giao diện (số phiên bản tự tăng), nén lại, bỏ file cấu hình và bí mật ra ngoài, rồi tải lên một dịch vụ trung gian. Link tự hết hạn sau khoảng 60 phút.

3. Đưa bạn lệnh PowerShell

   Một dòng lệnh cho giao diện, một dòng cho máy chủ API. Bạn (hoặc trợ lý trên máy chủ) dán vào máy chủ Windows. Lệnh tự sao lưu bản cũ, dừng đúng ứng dụng, giải nén rồi chạy lại.

4. Kiểm tra phiên bản

   Trợ lý báo dạng Phiên bản mới: v1.0.18 (BAXDafvs). Bạn mở trang, bấm F12, vào tab Console sẽ thấy đúng số phiên bản đó.

Lỗi lúc cài đặt

Set-ExecutionPolicy -Scope CurrentUser RemoteSigned -Force

Lỗi lúc làm việc

Khi nào cần gọi kỹ thuật

Quy tắc vàng

Các lệnh aci

Câu lệnh đầy đủ: node ~/.aci/tools/aci.mjs <lệnh>node "$env:USERPROFILE\.aci\tools\aci.mjs" <lệnh>. Thường thì trợ lý tự gọi, bạn không cần nhớ.

Kit được cài vào đâu

Bộ cài chỉ thêm phần của kit (tên bắt đầu bằng aci-, hoặc nằm giữa hai dấu mốc ACI-KIT), giữ nguyên thiết lập riêng của bạn và lưu bản sao .aci-backup trước khi sửa.

Cập nhật và gỡ kit

Cập nhật: bấm Tải ACI Kit để lấy bản mới, giải nén đè lên thư mục cũ rồi chạy lại bộ cài như lần đầu. Lần này chỉ mất 1–2 phút vì phần mềm đã có sẵn.

Gỡ khỏi trợ lý AI:

bash ~/.aci/install.sh --uninstall

powershell -ExecutionPolicy Bypass -File "$env:USERPROFILE\.aci\install.ps1" --uninstall

Muốn gỡ hẳn thì xóa thêm thư mục .aci trong thư mục nhà. Các phần mềm như Git, Node.js, Antigravity gỡ như phần mềm bình thường.

Giải thích thuật ngữ

Trợ lý AI (agent)

Trợ lý AI tự làm được việc nhiều bước: đọc file, viết code, chạy lệnh, tự kiểm tra rồi báo lại.

Kỹ năng (skill)

Bản hướng dẫn quy trình mà trợ lý đọc khi gặp đúng loại việc, ví dụ quy trình sửa lỗi của công ty.

Terminal, PowerShell

Cửa sổ để gõ lệnh bằng chữ. Trên Mac gọi là Terminal, trên Windows dùng PowerShell.

Git

Công cụ ghi lại mọi thay đổi của code. Nhờ nó mà quay lại được bản cũ và nhiều người làm chung được.

Node.js

Phần mềm giúp chạy code JavaScript trên máy tính và máy chủ.

Dự án, repo

Một thư mục chứa toàn bộ code của một phần mềm.

BackEnd, FE

BackEnd là phần chạy trên máy chủ, giữ dữ liệu. FE (giao diện) là phần người dùng nhìn thấy trên trình duyệt.

API

“Cửa giao dịch” để giao diện, hoặc phần mềm khác, lấy và gửi dữ liệu tới máy chủ.

Cơ sở dữ liệu

Nơi lưu dữ liệu có cấu trúc như khách hàng, đơn hàng. Công ty dùng SQL Server.

Deploy, đẩy lên server

Đưa phiên bản mới của phần mềm lên máy chủ thật để mọi người dùng.

Máy chủ (server)

Máy tính chạy liên tục để phục vụ phần mềm cho mọi người. Công ty dùng Windows Server.

File .env

File chứa mật khẩu và khóa bí mật của dự án. Chỉ nằm trên máy, không bao giờ gửi đi đâu.

Khóa API

Chuỗi bí mật để dùng các dịch vụ trả tiền (AI, thanh toán). Lộ khóa nghĩa là người khác tiêu tiền của công ty.

Extension, plugin

Phần cài thêm để có thêm tính năng: extension cho Antigravity IDE, plugin cho ứng dụng Antigravity.

RAG

Cách cho chatbot trả lời dựa trên tài liệu của công ty thay vì tự bịa ra.

ACI Kit · đúc kết từ PanCakeChipChip, CRMGolf, QuanLyXaPhuong, PushNotify, Chip Chip Studio và các dự án nội bộ khác.