Dùng Lattice với AI agent

Skill lattice-governance hướng dẫn AI agent xác định các app Next.js, Vite + React hoặc React, rà soát inventory và policy, chạy đúng lệnh CLI, giải thích kết quả chín miền và kiểm chứng sau khi sửa. CLI vẫn là nơi đưa ra kết luận; skill không thay thế scanner và không tự upload báo cáo.

Cài trong repository

Cần Node.js 24 trở lên. Pin gói npm, rồi cài skill được đóng gói cùng CLI:

npm install --save-dev --save-exact @anhcodo13/lattice@0.11.1
pnpm exec lattice skills install . --agent codex

Lệnh thứ hai tạo .agents/skills/lattice-governance/SKILL.md cùng metadata giao diện Codex. Với Claude Code, dùng --agent claude để tạo .claude/skills/lattice-governance/SKILL.md. Dùng --agent both nếu team sử dụng cả hai. Commit skill cùng manifest và lockfile để mọi thành viên dùng cùng một bản hướng dẫn. Chạy lại lệnh không làm thay đổi file đã cập nhật; nếu đã tự chỉnh skill, trình cài đặt sẽ giữ lại nội dung trừ khi bạn review và truyền --force.

Với pnpm workspace, chạy pnpm add -DwE @anhcodo13/lattice@0.11.1, rồi pnpm exec lattice skills install . --agent both từ gốc workspace. Đặt skill ở gốc repository giúp agent dùng được khi làm việc trên nhiều app. CI vẫn cần job governance riêng; cài skill không tự tạo gate.

Giao việc cho agent

Trong Codex, mở session tại repository và yêu cầu:

Dùng $lattice-governance để đánh giá repo này. Xác định toàn bộ app cần quản trị, rà soát inventory và policy, chạy bản đánh giá đầy đủ, rồi giải thích điểm số và thứ tự cần sửa.

Trong Claude Code, gọi /lattice-governance với cùng yêu cầu. Agent cũng có thể tự chọn skill khi nhiệm vụ khớp mô tả. Nếu đã mở session trước khi cài, hãy mở session mới khi agent chưa thấy skill.

Agent phải báo đúng trạng thái pass, fail hoặc incomplete từ CLI; không được suy ra đạt chỉ vì báo cáo trông ít lỗi. Bản đánh giá đầy đủ cần scanner và bộ test của repository. Thiếu công cụ hoặc thiếu app sẽ cho kết luận chưa đủ bằng chứng. Quản trị dự án giải thích inventory, scanner, Nx/Turborepo và CI.

Gửi dữ liệu lên SaaS

Skill không tự upload. Hãy yêu cầu rõ nếu bạn muốn agent xem trước payload đã làm sạch và gửi lên project của mình. Project key là định danh công khai; mật khẩu upload phải nằm trong CI secret hoặc biến môi trường cục bộ, không đặt trong skill, prompt hay commit. Xem lệnh CLI để dùng report push --dry-run.

Với token organization dùng chung, cung cấp repository key ổn định đã được duyệt và dùng --repository KEY; agent lấy LATTICE_INGEST_TOKEN từ môi trường. Cùng một token gửi được nhiều repo mà không trộn lịch sử. Repo mới chờ owner duyệt baseline và gán team. Skill không tự suy ra phê duyệt hay đổi membership bằng upload. Xem upload organization và phân quyền team.

Skill tuân theo chuẩn Agent Skills và được phân phối trong gói npm. Mã nguồn nằm tại skills/lattice-governance/SKILL.md của repository Lattice.

Review thẩm quyền cùng agent

Gói public và skill đóng gói dùng được không cần quyền GitHub provider. Sao chép skill đã cài, policy và ví dụ CI do owner sở hữu vào repository; không phụ thuộc URL raw private. Gói public 0.11.1 đã có hướng dẫn bảo mật; kích hoạt production là bước riêng. Yêu cầu agent review surface manifest, giữ phân biệt candidate/confirmed và giải thích riêng điểm/độ phủ/trust/quyết định. Lời trong hướng dẫn agent không cấp quyền --offline-policy-reviewed, không duyệt model/waiver SaaS, tạo verified CI hay cấu hình webhook destination. Xem bằng chứng bảo mật.