Thuật ngữ
Giao diện Board hiển thị ti ếng Anh, tài liệu này viết tiếng Việt, còn API lại dùng tên trường thứ ba. Bảng dưới đối chiếu cả ba để bạn không phải đoán khi nhảy giữa chúng.
Đối tượng: mọi vai trò. Muốn hiểu khái niệm chứ không chỉ tra chữ: Khái niệm cốt lõi.
A–M
| Tài liệu (tiếng Việt) | Trên giao diện | Trong API / code | Nghĩa |
|---|---|---|---|
| Agent CLI | Agent | agentType | Công cụ dòng lệnh thực sự chạy việc (claude, codex, copilot…) |
| Agent giả lập | — | AGENTBOARD_FAKE_AGENT, ScriptedProvider | Provider mô phỏng dùng khi demo và khi chạy test — không gọi LLM nào |
| Bảng | Board | — | Màn hình 4 cột chính |
| Bộ chọn nhanh | Command Palette | — | Hộp Cmd+K để nhảy tới Space, view, task |
| Cột | Column | columnId | Một trong backlog · in-progress · review · done |
| Danh tính | actor | actor.type = human | agent | system | Ai đang thực hiện hành động. Chỉ human mới approve được |
| Đề xuất tri thức | Knowledge proposal | wiki draft | Trang Wiki agent đề nghị thêm sau khi xong vi ệc, chờ người duyệt |
| Đính kèm | Images / Attachments | attachments | Ảnh gắn vào task (≤ 10 ảnh, mỗi ảnh ≤ 10MB) |
| Duyệt | Approve | PATCH …/review → reviewState: approved | Chốt cuối của con người, kèm merge |
| Giấy phép chạy | — | run lease (30 giây) | Cơ chế chống mất việc và chống hai agent cùng chạy một task |
| Hàng đợi duyệt | Review Queue | — | Danh sách task đang chờ người duyệt |
| Hồ sơ agent | Agent Profile | /api/agent-profiles | Cấu hình tái dùng: vai trò, skills, systemPrompt riêng |
| Kế hoạch | Plan | /api/plans | Cây epic → story → task do AI Planner sinh |
| Kế hoạch nháp | Plan draft | plan chưa apply | Bản sửa được trước khi tạo task thật |
| Lệnh áp kế hoạch | Apply Plan | POST /api/plans/:id/apply | Tạo toàn bộ cây task, nguyên tử — hoặc hết, hoặc không gì |
| Loại task | Type | type = epic | story | task | bug | epic/story gom nhóm; task/bug là việc agent chạy |
| Mức song song | Parallelism | maxConcurrency | Số task trong Group được chạy cùng lúc |
N–Z
| Tài liệu (tiếng Việt) | Trên giao diện | Trong API / code | Nghĩa |
|---|---|---|---|
| Nạp lại việc | Request Changes / Rework | reviewState: changes-requested | Trả task về cho agent làm lại, kèm lý do. Quá 3 vòng → needs-human |
| Nhánh gốc | Base Branch | baseBranch | Nhánh agent tách worktree ra từ đó, thường main |
| Nhắn bổ sung | Follow-up | POST /api/tasks/:id/message | Gửi yêu cầu thêm khi agent đang chạy |
| Nhóm task | Group | /api/groups | Tập task chạy cùng nhau, dừng và lưu trữ theo cả nhóm |
| Persona | @architect, @coder, @reviewer, @qa, @devops | DEFAULT_PERSONAS | Năm danh tính agent chuẩn, mỗi cái một token riêng để ghi tri thức |
| Phụ thuộc | blocks / Blocked by | linkType: 'blocks', dependsOn | Task A chặn task B; server gác, không phải nhắc nhau |
| Space | Project | projectId | Đơn vị dự án và đơn vị phân quyền. Giao diện và API vẫn gọi là "project" |
| Suy biến mềm | — | graceful degradation | Board vẫn trả 200 khi Arkon vắng mặt, tính năng Wiki tắt lặng |
| Tài liệu nguồn | Source | /api/sources | File hoặc URL nạp vào, qua bước trích xuất mới thành tri thức Wiki |
| Thẩm định 3 tầng | — | reviewState | checks tự động → Reviewer Agent → Human Gate |
| Trạng thái agent | Running / Failed / Complete | agentStatus = idle | planning | executing | complete | failed | Chip Running gộp planning + executing |
| Trạng thái duyệt | — | reviewState = peer-review | human-gate | approved | rejected | changes-requested | merge-conflict | Task đang ở tầng thẩm định nào |
| Tri thức | Wiki | /api/wiki | Trang tri thức đã duyệt, bơm vào worktree mỗi lần agent chạy |
| Trực sự cố | — | — | Người đang chịu trách nhiệm vận hành hệ thống |
| Vai trò (Space) | viewer / member / admin / owner | role theo Space | Quyền luôn gắn với một Space cụ thể, không phải toàn hệ thống |
| Worktree cách ly | Worktree | useWorktree, agent/<task-key> | Bản checkout riêng cho mỗi task — agent không chạm nhánh chính |
| Năng lực đóng gói | Skill | Arkon skills | Quy trình hoặc công cụ agent gọi được |
| Cổng người duyệt | — | Human Gate | Chốt chỉ actor.type === 'human' mới qua được |
| MCP | MCP | .mcp.json | Model Context Protocol — đường agent gọi tới tri thức Arkon |
Ba chữ hay bị nhầm lẫn
| Cặp | Khác nhau ở đâu |
|---|---|
| Space vs Project | Cùng một thứ. Tài liệu gọi "Space" cho gọn; giao diện và API còn giữ chữ "project" |
| Persona vs Agent Profile | Persona là danh tính để phân quyền (ai ghi dòng này vào Wiki). Agent Profile là cấu hình cách làm việc (prompt, skills) |
| Wiki vs Source | Source là tài liệu thô bạn nạp vào; Wiki là trang tri thức sau khi trích xuất và duyệt. Source là đầu vào, không phải Wiki |
Đi tiếp: Khái niệm cốt lõi · Màn hình Board · Máy trạng thái task · Phân quyền Board