Dưới đây là bản dịch nội dung từ tiếng Anh sang tiếng Việt, tuân thủ tất cả các nguyên tắc và hướng dẫn đã nêu. Các thuật ngữ kỹ thuật, tên sản phẩm, URL, thẻ payload và code blocks giữ nguyên không dịch. Nội dung dịch đảm bảo tự nhiên, dễ hiểu, chuẩn SEO cho thị trường tiếng Việt, đồng thời giữ nguyên cấu trúc Markdown.
Một hướng dẫn toàn diện về Hermes Kanban: mô hình phối hợp, chia sẻ ngữ cảnh giữa các tác nhân, và xây dựng một đội ngũ phần mềm 4 tác nhân (PM, backend, frontend, tester) trong khoảng 20 phút.
Các tác nhân AI đáng lẽ phải hoạt động như một đội nhóm.
Bạn mô tả mục tiêu. Chúng phân chia công việc. Mỗi tác nhân tiếp nối công việc của tác nhân trước.
Đó là lời hứa hẹn. Nhưng thực tế lại hoàn toàn ngược lại. Các tác nhân bắt đầu với một bảng trắng. Một tác nhân không biết những tác nhân khác đã xây dựng gì, tệp nào đã thay đổi, hoặc API trông như thế nào. Mỗi lần bàn giao là một khởi đầu lạnh, và công việc bị giảm chất lượng ngay khi chuyển từ tác nhân này sang tác nhân khác.
Hermes Kanban giải quyết vấn đề đó. Mỗi nhiệm vụ đều tồn tại ngay cả khi hệ thống sập hoặc khởi động lại. Mỗi bản tóm tắt mang đầy đủ thông tin mà tác nhân tiếp theo cần. Mỗi lần thất bại đều được lưu lại, để lần thử lại biết chính xác điều gì đã hỏng.
Đây là giao diện điều khiển của bạn trông như thế nào:
Bảng điều khiển Kanban
Phần tuyệt nhất là toàn bộ đội ngũ có thể chạy từ điện thoại của bạn. Bạn tạo và điều phối nhiệm vụ qua Telegram, và các tác nhân sẽ thực hiện chúng khi bạn đang rời khỏi bàn làm việc.
Hãy xem này:
Trong bài viết này, chúng tôi sẽ xây dựng toàn bộ thiết lập này từ đầu: mô hình phối hợp, các bản tóm tắt, và một đội ngũ phần mềm 4 thành viên chạy trên phần cứng của riêng bạn trong khoảng 20 phút.
Để minh họa, tôi đã tạo ra một bản sao Google Docs hoạt động được, bao gồm các tính năng AI, backend sẵn sàng cho sản xuất, được xây dựng bởi chính đội ngũ tác nhân này.
Bản sao Google Docs demo
Vì vậy, không dài dòng nữa, chúng ta hãy bắt đầu ngay.
Tại sao một tác nhân là không đủ
Ví dụ, bạn muốn thêm tính năng đặt lại mật khẩu. Công việc được chia thành ba lĩnh vực:
- Một nhà phát triển backend xây dựng REST API
- Một nhà phát triển frontend đọc API đó và xây dựng giao diện người dùng dựa trên nó
- Một người kiểm thử xác minh toàn bộ end to end
1 vs 3 Tác nhân
Bạn có thể chạy cả ba qua một tác nhân duy nhất, nhưng cửa sổ ngữ cảnh sẽ đầy và tác nhân mất dấu những gì nó đã làm ba bước trước. Bạn dành nhiều thời gian để quản lý nó hơn là thời gian nó tiết kiệm cho bạn.
Chia công việc cho nhiều tác nhân, mỗi tác nhân phụ trách một lĩnh vực, lại tạo ra một vấn đề khác: làm thế nào để nhà phát triển frontend biết nhà phát triển backend đã xây dựng gì? Vấn đề về ngữ cảnh dùng chung đó chính là điều Hermes Kanban giải quyết.
Mô hình tinh thần: một bảng nhiệm vụ, nhưng các tác nhân ngồi phía sau các cột
Một nhiệm vụ có tiêu đề, mô tả, chủ sở hữu và trạng thái. Ai đó nhặt nó lên, di chuyển nó qua bảng và đóng nó lại. Bảng là nguồn thông tin duy nhất.
Hermes Kanban giữ mô hình đó và đặt các tác nhân phía sau mỗi cột thay vì con người.
Bảng Hermes Kanban
Mỗi nhiệm vụ là một hàng tồn tại ngay cả khi hệ thống sập hoặc khởi động lại. Khi một tác nhân hoàn thành, nó viết một bản tóm tắt: tệp nào đã thay đổi, nó đã xây dựng gì, tác nhân tiếp theo cần biết điều gì. Tác nhân tiếp theo đọc bản tóm tắt đó trước khi bắt đầu.
Bản tóm tắt đó là toàn bộ chìa khóa. Nó biến một nhóm các tác nhân thành một đội nhóm thay vì những người xa lạ.
Từ vựng
Chúng ta có 6 cột khác nhau trên bảng Kanban:
- Phân loại (Triage): Các ý tưởng sơ bộ được đặt ở đây, phù hợp cho việc "tôi muốn giới hạn tốc độ xác thực" trước khi bạn có một đặc tả đầy đủ.
- Cần làm (Todo): Nhiệm vụ đã được tạo nhưng đang chờ phụ thuộc. Nó sẽ không di chuyển cho đến khi nhiệm vụ cha của nó hoàn thành.
- Sẵn sàng (Ready): Các phụ thuộc đã được đáp ứng, đang chờ một tác nhân nhặt nó lên.
- Đang thực hiện (In Progress): Một tác nhân đang chạy.
- Bị chặn (Blocked): Tác nhân gặp phải rào cản và đánh dấu nó cho con người. Không có gì chạy cho đến khi bạn gỡ chặn nó.
- Hoàn thành (Done): Đã hoàn thành, với toàn bộ lịch sử chạy, bản tóm tắt và siêu dữ liệu được lưu giữ.
Người điều phối: một tác nhân quản lý những tác nhân còn lại
Hãy nghĩ về tác nhân điều phối như một người quản lý dự án, người đọc một mục tiêu cấp cao, kiểm tra những tác nhân nào tồn tại, chia mục tiêu thành các nhiệm vụ được liên kết và lùi lại. Nó không bao giờ viết mã hoặc chạy kiểm thử. Nó chỉ phối hợp.
Tác nhân điều phối
Một quy tắc quan trọng: hãy kiểm tra xem những hồ sơ nào tồn tại trước khi tạo nhiệm vụ. Hệ thống sẽ âm thầm bỏ qua bất kỳ nhiệm vụ nào mà người được giao không khớp với một hồ sơ thực tế, vì vậy bước số không luôn là kanban_list.
Đây là một lượt quản lý dự án điển hình, phân tích một yêu cầu "xây dựng luồng đặt lại mật khẩu" thành một pipeline liên kết:
1kanban_show()23be = kanban_create(title="Backend đặt lại mật khẩu", assignee="backend-developer",4 body="Luồng quên/đặt lại mật khẩu + vô hiệu hóa phiên")56fe = kanban_create(title="Giao diện đặt lại mật khẩu", assignee="frontend-developer",7 parents=[be], body="Luồng đặt lại Next.js sử dụng API backend")89qa = kanban_create(title="Kiểm thử E2E đặt lại mật khẩu", assignee="tester",10 parents=[fe], body="Xác thực tất cả các tiêu chí chấp nhận")1112kanban_complete(summary="Đã tạo pipeline phụ thuộc backend → frontend → QA")
Sau đó, bảng xử lý việc thăng cấp và các bản tóm tắt xử lý ngữ cảnh. Khi cả ba hoàn thành, người quản lý dự án thức dậy, đọc các bản tóm tắt và đánh giá xem công việc đã hoàn thành chưa. Nếu người kiểm thử trả về "verdict": "FAIL", nó sẽ tạo các nhiệm vụ sửa lỗi và vòng lặp tiếp tục.
Nhưng trên thực tế, bạn không cần phải quan tâm đến bất cứ điều gì. Bạn chỉ cần ủy thác một nhiệm vụ từ Telegram và người điều phối sẽ lo phần còn lại.
Ba mẫu hình bạn sẽ thường xuyên sử dụng
1. Pipeline:Mỗi nhiệm vụ phụ thuộc vào nhiệm vụ trước. Chỉ nhiệm vụ đầu tiên bắt đầu ở trạng thái sẵn sàng. Mọi thứ khác đều chờ đến lượt.
1BACKEND=$(hermes kanban create "Triển khai API xác thực" \2 --assignee backend-developer \3 --body "POST /register, POST /login, POST /refresh, POST /logout." \4 --json | jq -r .id)56FRONTEND=$(hermes kanban create "Xây dựng giao diện xác thực" \7 --assignee frontend-developer \8 --parent $BACKEND \9 --body "Đọc bản bàn giao backend để biết hình dạng API. Các trang Đăng nhập, Đăng ký, Hồ sơ." \10 --json | jq -r .id)1112hermes kanban create "Kiểm thử luồng xác thực end to end" \13 --assignee tester \14 --parent $FRONTEND \15 --body "Bao gồm happy path, sai mật khẩu, token hết hạn, duy trì phiên."
Bạn không chạy cái này bằng tay. Bạn mô tả dự án cho người quản lý dự án trên Telegram và nó sẽ tạo ra các nhiệm vụ này cho bạn. Bên trong, nó trông giống như ở trên.
Khi tác nhân backend gọi kanban_complete(), nhiệm vụ frontend chuyển sang trạng thái sẵn sàng kèm theo công việc của backend đã được đính kèm.
2. Con người trong vòng lặp:Không phải mọi tắc nghẽn đều là thất bại. Đôi khi một tác nhân tìm thấy một vấn đề thực sự và dừng lại để hỏi.
1kanban_block(reason="review-required: thiếu kiểm tra độ mạnh mật khẩu, "2 "token đặt lại không phải là sử dụng một lần (có thể phát lại trong vòng 30 phút)")
Bạn thấy tắc nghẽn trên bảng điều khiển. Bạn xác minh vấn đề, sửa nó và gỡ chặn nhiệm vụ:
1hermes kanban unblock $IMPL
Bạn cũng không chạy lệnh này trong terminal. Chỉ cần bình luận trên bảng Kanban hoặc nhắn tin trên Telegram, hệ thống sẽ tự động gỡ chặn.
Hệ thống khởi động lại tác nhân trong chu kỳ tiếp theo. Lần chạy thứ hai gọi kanban_show() và thấy chính xác lý do tại sao lần thử đầu tiên bị chặn. Nó biết chính xác cần sửa gì; nó không bắt đầu lại từ đầu.
3. Công cụ xác định phân loại.
Khi bạn có một ý tưởng sơ bộ thay vì một đặc tả đầy đủ, hãy thả nó lên bảng và để hệ thống phát triển nó trước khi bất kỳ tác nhân nào nhặt nó lên.
1# Thả một ý tưởng sơ bộ2hermes kanban create "xác thực cần giới hạn tốc độ" --triage --assignee backend-developer34# Phát triển nó trước khi người điều phối nhặt nó lên5hermes kanban specify $TASK_ID
Lệnh specify viết lại tiêu đề ba từ thành một nhiệm vụ đầy đủ với mục tiêu, cách tiếp cận và tiêu chí chấp nhận. Tác nhân nhặt nó lên sẽ nhận được một bản tóm tắt thực sự.
Thiết lập: bốn hồ sơ trong khoảng 20 phút
Bốn tác nhân, một bảng dùng chung, người quản lý dự án có thể liên lạc qua Telegram.
Bước 1: Tạo các hồ sơ.
1hermes profile create project-manager --clone2hermes profile create backend-developer --clone3hermes profile create frontend-developer --clone4hermes profile create tester --clone
--clone sao chép cấu hình hồ sơ mặc định của bạn làm điểm khởi đầu.
Bước 2: Tạo cá tính cho mỗi tác nhân
1. Người quản lý dự án tại ~/.hermes/profiles/project-manager/SOUL.md:
1# Soul23Bạn là người quản lý dự án của một đội ngũ phát triển phần mềm. Công việc của bạn4là tiếp nhận ý tưởng ứng dụng của người dùng, chia nó thành các nhiệm vụ rõ ràng, giao chúng5cho các thành viên phù hợp trong nhóm và theo dõi tiến độ trên bảng Kanban.6Bạn không tự viết mã. Bạn quản lý công việc.
2. Nhà phát triển Backend tại ~/.hermes/profiles/backend-developer/SOUL.md:
1# Soul23Bạn là nhà phát triển backend trong một nhóm phần mềm. Bạn xây dựng và quản lý4toàn bộ backend sử dụng InsForge — cơ sở dữ liệu, xác thực, lưu trữ, edge5functions và triển khai.
3. Nhà phát triển Frontend tại ~/.hermes/profiles/frontend-developer/SOUL.md:
1# Soul23Bạn là nhà phát triển frontend trong một nhóm phần mềm. Bạn xây dựng giao diện người dùng —4các thành phần, trang và luồng người dùng — và kết nối chúng với backend5bằng các API và phương thức SDK mà nhà phát triển backend đã thiết lập.
4. Người kiểm thử tại ~/.hermes/profiles/tester/SOUL.md:
1# Soul23Bạn là người kiểm thử trong một nhóm phần mềm. Bạn kiểm thử các tính năng đã hoàn thành4end-to-end, xác minh các tiêu chí chấp nhận đã được đáp ứng và báo cáo lỗi5rõ ràng trên bảng Kanban để chúng có thể được sửa.
Bước 3: Thêm kỹ năng cho tác nhân
Kỹ năng là các hướng dẫn từng bước, các chỉ dẫn cụ thể về cách thực hiện một số loại công việc nhất định. Hãy coi chúng như là đào tạo công việc cho các tác nhân của bạn. Hãy liệt kê từng cái một:
InsForge (mã nguồn mở, Apache 2.0) hoạt động như một lớp kỹ thuật ngữ cảnh backend cho các tác nhân sử dụng Kỹ năng và CLI. Hồ sơ tác nhân nhà phát triển backend của chúng tôi sử dụng kỹ năng này để có một dịch vụ backend sẵn sàng sử dụng cho các dự án.
Đầu tiên, thêm tap kỹ năng InsForge:
1hermes skills tap add InsForge/insforge-skills
Sau đó cài đặt các kỹ năng backend:
1hermes -p backend-developer skills install InsForge/insforge-skills/insforge --force
Theo cách tương tự, chúng ta cài đặt các kỹ năng khác dưới dạng insforge-cli (lệnh cơ sở hạ tầng), insforge-debug (chẩn đoán lỗi) và insforge-integrations (các nhà cung cấp xác thực bên thứ ba).
Đây là cách tác nhân nhà phát triển backend sử dụng kỹ năng để xây dựng backend dự án của chúng tôi trên InsForge.
Đầu tiên, tác nhân nhà phát triển backend tạo một dự án có tên "Google Docs Clone" trong InsForge.
Bảng điều khiển hiển thị số liệu thống kê dự án như số lượng Người dùng, bảng trong Cơ sở dữ liệu, Bộ nhớ và danh sách các Edge Functions với mã JavaScript/TypeScript đã triển khai liên quan đến xác thực, xử lý tài liệu, v.v.
Vì vậy, nếu bạn đang xây dựng một kỹ sư AI backend, hãy xem InsForge →
(đừng quên star 🌟)
Thêm kỹ năng từ Skills Hub
Hermes cũng duy trì một Skills Hub với 687 kỹ năng trên 18 danh mục: 87 kỹ năng tích hợp sẵn, 79 kỹ năng tùy chọn, 16 kỹ năng từ Anthropic (frontend-design, pdf, pptx, docx, mcp-builder, v.v.) và 505 kỹ năng từ LobeHub.
Đối với nhà phát triển frontend, hãy cài đặt frontend-design. Đối với người kiểm thử, hãy cài đặt webapp-testing. Cả hai đều có trong Hub.
Bước 4: Khởi tạo bảng và bắt đầu cổng kết nối.
hermes kanban init tạo ~/.hermes/kanban.db, cơ sở dữ liệu SQLite lưu trữ mọi nhiệm vụ, ngữ cảnh và lịch sử chạy.
Sau đó, thiết lập cổng kết nối trò chuyện dưới hồ sơ người quản lý dự án. Lấy mã thông báo bot từ @BotFather trên Telegram và ID người dùng của bạn từ @userinfobot, sau đó:
1hermes kanban init2hermes -p project-manager gateway setup3hermes -p project-manager gateway start
Kết nối chạy 24/7, giữ cho hệ thống hoạt động và giúp người quản lý dự án có thể liên lạc được trên Telegram.
Bước 5: Gửi dự án đầu tiên của bạn.
Nhắn tin cho người quản lý dự án về những gì bạn muốn xây dựng. Nó sẽ chia mục tiêu thành các nhiệm vụ, tạo chúng với các liên kết phụ thuộc và hệ thống sẽ chạy chúng theo thứ tự.
Bảng điều khiển
Chạy hermes dashboard và mở http://127.0.0.1:9119. Bạn sẽ có một cột cho mỗi trạng thái và các cập nhật trực tiếp qua WebSocket mà không cần làm mới.
0:20
Bảng điều khiển Hermes Kanban
Hai điều khiển đáng để biết. Lanes by profile nhóm con các cột Running theo người được giao, để bạn có thể thấy tác nhân nào sở hữu nhiệm vụ nào trong nháy mắt. Nudge dispatcher chạy một lượt ngay lập tức thay vì chờ 60 giây, điều này rất hữu ích ngay sau khi bạn gỡ chặn một nhiệm vụ.
Nhấp vào bất kỳ thẻ nào để mở ngăn kéo của nó để xem toàn bộ lịch sử chạy, kết quả và siêu dữ liệu của mọi lần thử, cũng như các trường có thể chỉnh sửa cho tiêu đề, người được giao, mức độ ưu tiên và phụ thuộc.
Những điều cần lưu ý
Ba chế độ hỏng hóc đáng biết trước khi có khối lượng công việc nghiêm trọng.
1. Quá tải cơ sở dữ liệu. Với 2 đến 4 tác nhân song song, bạn sẽ không bao giờ gặp vấn đề này. Với 10+ tác nhân ghi dữ liệu với tần suất cao, mọi thứ sẽ chậm lại. Giới hạn nó bằng hermes kanban dispatch --max 4.
2. Xóa không gian làm việc tạm thời. Các tệp được lưu vào không gian làm việc tạm thời sẽ biến mất ngay khi nhiệm vụ được đánh dấu là hoàn thành, vì không gian tạm thời bị xóa theo thiết kế. Sử dụng worktree cho các tác vụ mã hóa hoặc đặt đường dẫn thư mục dự án trong mô tả nhiệm vụ để tác nhân biết nơi lưu.
3. Bão hòa mô hình cục bộ. Đối với mô hình cục bộ (Ollama, GPU cục bộ), hệ thống có thể khởi chạy nhiều tác nhân cùng một lúc và làm quá tải GPU, làm chậm quá trình tạo và kích hoạt tính năng tự động dừng. Đối với thiết lập cục bộ, hermes kanban dispatch --max 2. Đối với các mô hình dựa trên API như Claude hoặc GPT-4o, điều này hiếm khi xảy ra.
Bức tranh toàn cảnh
Mỗi phần có một công việc:
- SOUL.md là danh tính cố định của tác nhân: nó là ai và nó suy nghĩ như thế nào.
- Kỹ năng (Skills) là các hướng dẫn từng bước cho các loại công việc cụ thể.
- Bộ nhớ (Memory) là những gì tác nhân biết về môi trường của bạn qua các phiên.
- Kanban là lớp phối hợp: trạng thái dùng chung, chuyển giao ngữ cảnh và con người có thể can thiệp vào bất kỳ thời điểm nào.
Bốn hồ sơ, bốn tệp SOUL.md, một lần khởi động cổng kết nối. Mô tả những gì bạn muốn xây dựng cho người quản lý dự án trên Telegram và xem bảng điều khiển đầy dần lên.
Nếu bạn học tốt hơn từ video, một bài hướng dẫn đầy đủ về Hermes Kanban sẽ được đăng tải trên YouTube và X trong vài ngày tới.
Cảm ơn bạn đã đọc.
