Agents
Agent của Engineer
Khám phá 16 vai trò chuyên biệt giúp Engineer Kit tìm hiểu, lập kế hoạch, triển khai, xác minh và bàn giao công việc phần mềm.
Engineer Kit gồm 16 Agent: 10 vai trò dùng chung trong AgentKit và 6 vai trò riêng cho công việc kỹ thuật. Các Agent hỗ trợ toàn bộ quá trình từ một yêu cầu chưa rõ đến kết quả đã được đánh giá mà không biến mỗi chuyên gia thành một command riêng bạn phải tự quản lý.
Agent bổ trợ cho Skill như thế nào
Skill là workflow bạn chọn theo kết quả cần đạt, chẳng hạn lập kế hoạch thay đổi, debug lỗi hoặc review code. Agent là vai trò chuyên biệt nhận một task có phạm vi rõ ràng và trả về kết quả tập trung. Một Skill có thể phối hợp một hoặc nhiều Agent, và coding assistant có thể giao việc cho Agent khi task hiện tại phù hợp với vai trò đó.
Hãy bắt đầu từ Skill hoặc kết quả bạn cần. Thông thường, bạn không phải tự chọn mọi Agent, và ID của Agent không phải một bề mặt slash command dùng chung cho mọi runtime. Cách discovery và orchestration phụ thuộc vào target runtime.
Tìm trợ giúp phù hợp theo kết quả
Danh sách dưới đây là toàn bộ tập Engineer đã resolve. “Dùng chung” là vai trò thuộc phần nền chung; “Riêng Engineer” là một trong sáu vai trò do Engineer Kit bổ sung.
Tìm hiểu và quyết định
| Agent | Nguồn | Mục đích |
|---|---|---|
Explore | Dùng chung | Xác định các tệp, ký hiệu và mối quan hệ liên quan đến một câu hỏi codebase có phạm vi rõ ràng. |
researcher | Dùng chung | Tổng hợp có nguồn dẫn về công nghệ, mẫu triển khai hoặc tài liệu chính thức. |
brainstormer | Riêng Engineer | Khám phá kiến trúc và các hướng giải pháp trước khi bắt đầu triển khai. |
advisor | Riêng Engineer | Review hướng đi ở cấp độ chuyên gia và đưa ra rủi ro, đánh đổi cùng khuyến nghị. |
kongming | Dùng chung | Biến quyết định chiến lược khó thành các lựa chọn, hệ quả và hướng được khuyến nghị. |
Lập kế hoạch và điều phối
| Agent | Nguồn | Mục đích |
|---|---|---|
planner | Dùng chung | Biến một thay đổi đáng kể thành implementation plan dựa trên bằng chứng. |
project-manager | Dùng chung | Tổng hợp công việc theo plan và báo cáo tiến độ, khoảng trống cùng hành động tiếp theo. |
Tạo và cải thiện
| Agent | Nguồn | Mục đích |
|---|---|---|
fullstack-developer | Dùng chung | Triển khai một giai đoạn có phạm vi rõ ràng trên frontend, backend hoặc hạ tầng với quyền sở hữu cụ thể. |
ui-ux-designer | Riêng Engineer | Thiết kế hoặc audit giao diện, khả năng đáp ứng, accessibility và design system. |
code-simplifier | Riêng Engineer | Tinh gọn code vừa thay đổi để rõ ràng và nhất quán hơn nhưng vẫn giữ nguyên hành vi. |
docs-manager | Dùng chung | Audit và duy trì tài liệu kỹ thuật cùng tiêu chuẩn phát triển. |
Xác minh, bàn giao và rút kinh nghiệm
| Agent | Nguồn | Mục đích |
|---|---|---|
debugger | Dùng chung | Điều tra lỗi, log, hành vi, dữ liệu hoặc hiệu năng và đưa ra chẩn đoán. |
tester | Dùng chung | Chạy và đánh giá test, build, coverage cùng các nhánh lỗi liên quan. |
code-reviewer | Riêng Engineer | Review tính đúng đắn, bảo mật, hiệu năng, edge case và khả năng bảo trì. |
git-manager | Riêng Engineer | Xử lý staging, commit, push và bàn giao Git trong phạm vi được yêu cầu rõ ràng. |
journal-writer | Dùng chung | Ghi lại lỗi nghiêm trọng, incident, dependency bị chặn hoặc trở ngại kiến trúc. |
Khám phá và điều phối Agent
Dùng ak agents list --kit engineer để xem danh sách đã resolve. Sau khi cài đặt,
runtime đã chọn sẽ chuyển đổi và nhận diện Agent theo cách riêng:
- Bắt đầu từ kết quả cần đạt. Chọn một Skill hoặc mô tả task cần hoàn thành thay vì coi danh sách là một chuỗi bắt buộc.
- Để workflow giao task có phạm vi rõ ràng. Một Skill hoặc coding assistant có thể chọn chuyên gia khi vai trò của Agent phù hợp với bước hiện tại.
- Review kết quả đã tổng hợp. Việc giao task không tự phê duyệt thay đổi hay hành động bên ngoài; con người vẫn chịu trách nhiệm cho quyết định cuối cùng.
Claude Code dùng bề mặt subagent native. Codex nhận định nghĩa Agent đã được chuyển đổi cùng tích hợp AgentKit runtime. Cursor nhận native Agent projection. Đây là các bề mặt điều phối khác nhau, vì vậy một tên có trong danh sách không chứng minh rằng cả ba runtime dùng chung một cú pháp gọi trực tiếp.
Ranh giới runtime và model
Tên Agent và mục đích ở trên mô tả danh sách được phân phối, không bảo đảm hành vi tương đương giữa các runtime. Cấp model có thể được ánh xạ khác nhau cho từng target, còn provider hoặc model khả dụng có thể phụ thuộc vào thiết lập runtime của người dùng. Hãy xem mục đích của Agent là vai trò làm việc, không phải cam kết về một model cụ thể, kết quả giống hệt nhau hay hành vi điều phối giống hệt nhau.
Với Codex trong bản phát hành này, TOML được tạo cho Agent researcher dùng
chung có model = "gpt-5.4" và model_reasoning_effort = "medium" khi model
được resolve. Nếu không resolve được model, AgentKit không ghi cả hai thiết lập.
Thay đổi đó không làm đổi danh sách Agent, hành vi trên Claude Code hay hành vi
trên Cursor.
Để hiểu thêm về khác biệt khi phân phối, hãy đọc Runtime adapter. Nếu runtime không nhận diện được Agent đã cài, hãy làm theo Runtime không tìm thấy Skill hoặc Agent trước khi thay đổi tệp cài đặt.
Khám phá tiếp
- Quay lại tổng quan Engineer Kit để xem ranh giới package đầy đủ và workflow đầu tiên.
- Đọc Kits, Skills, Agents và Hooks để hiểu cách các thành phần phối hợp.
- Dùng Cài đặt Kit để chọn runtime, scope, delivery mode và Skill.
Vận hành ak CLI an toàn với ak:ak
Chạy các subcommand ak, xác định rõ scope, ưu tiên đọc trước khi mutation, và diễn giải envelope --json mà không phá state của người dùng.
Hook của Engineer và hỗ trợ theo runtime
Tìm hiểu event graph của Hook Engineer, kết quả có thể quan sát và ranh giới hỗ trợ theo runtime.