Cách cài đặt 300+ chuyên gia AI vào Claude Code và Cursor

TL;DR: agency-agents là bộ sưu tập lớn nhất các hồ sơ cá nhân tác nhân AI được tuyển chọn trên GitHub, với 149.312 lượt sao tính đến ngày 1 tháng 9 năm 2026. Nó cung cấp hơn 300 tệp định nghĩa tác nhân trong khoảng 20 thư mục danh mục và cài đặt chúng vào Claude Code, Cursor, Codex, Gemini CLI, OpenCode, Windsurf, Aider, cùng hàng chục công cụ khác chỉ bằng một lệnh. Những gì bạn nhận được là định hình, không phải khả năng. Các hồ sơ cá nhân thay đổi cách tác nhân của bạn tiếp cận một nhiệm vụ; chúng không cung cấp cho tác nhân những thông tin mà nó không có, và chúng không tồn tại sau phiên làm việc.

Đây là một phân tích sâu về một công cụ từ danh sách tổng hợp năm công cụ tác nhân AI mã nguồn mở đáng cài đặt vào năm 2026 của chúng tôi.

Tác nhân lập trình của bạn có một tính cách: chuyên gia tổng quát hữu ích. Yêu cầu nó xem xét một quy trình xác thực và bạn sẽ nhận được lời khuyên hợp lý, dễ quên. Yêu cầu một nhà đánh giá bảo mật với mô hình mối đe dọa và danh sách kiểm tra, và bạn sẽ nhận được các phát hiện.

Khoảng trống đó chính là điều mà agency-agents lấp đầy. Nó bắt đầu như một chủ đề Reddit về chuyên môn hóa tác nhân và phát triển thành một danh sách đủ lớn đến mức việc cài đặt toàn bộ nó làm hỏng ít nhất một môi trường chạy tác nhân phổ biến. Đây là những gì thực sự bên trong, cách cài đặt các phần bạn muốn và hai điều mà thư viện hồ sơ cá nhân không thể làm cho bạn.

Những gì bạn thực sự đang cài đặt

Mỗi tác nhân là một tệp markdown. Không phải một lời nhắc hệ thống một dòng, và không phải một plugin có mã. Một tệp chứa danh tính và tính cách, một nhiệm vụ cốt lõi, một quy trình làm việc, các sản phẩm kỹ thuật với ví dụ và các chỉ số thành công.

Tính số lượng tệp markdown trong cây thư mục kho lưu trữ vào ngày 1 tháng 9 năm 2026, có 312 tệp trong 20 thư mục danh mục cấp cao nhất, hoặc 306 tệp sau khi loại trừ thư mục examples/. Phân bổ này nghiêng về việc xây dựng:

Cần lưu ý README của kho lưu trữ vẫn quảng cáo "hơn 230 tác nhân". Dòng đó đã lỗi thời. Cây thư mục đã phát triển vượt quá 300.

Phân ngành kỹ thuật là nơi hầu hết các nhà phát triển sẽ bắt đầu, và tính cụ thể cao hơn bạn mong đợi từ một bộ sưu tập lời nhắc. Bên cạnh các mục nhập rõ ràng như Frontend Developer và Backend Architect, còn có Network Engineer được giới hạn cho Cisco IOS-XE, Juniper Junos và Palo Alto PAN-OS, một Embedded Firmware Engineer cho ESP32, STM32 và các mục tiêu Nordic, một Incident Response Commander cho các cuộc đánh giá sau sự cố và sự sẵn sàng trực ban, và một Codebase Onboarding Engineer được viết để khám phá một kho lưu trữ chỉ đọc và nêu các sự kiện về nó thay vì đề xuất thay đổi.

Ví dụ cuối cùng đó là một ví dụ điển hình về mô hình hoạt động. Một hồ sơ cá nhân chỉ đọc với một yêu cầu không chỉnh sửa rõ ràng là một công cụ thực sự khác biệt so với tác nhân mặc định của bạn, và nó không tốn gì ngoài một tệp.

Cài đặt mà không làm hỏng thiết lập của bạn

Kho lưu trữ này cung cấp các script chuyển đổi và cài đặt. Đường dẫn tương tác sẽ phát hiện những gì bạn đã cài đặt và hỏi những gì bạn muốn:

git clone https://github.com/msitarzewski/agency-agents.git
cd agency-agents
./scripts/install.sh

Việc nhắm mục tiêu một công cụ cụ thể và một tập hợp con các phân ngành là tùy chọn mặc định an toàn hơn:

# mọi thứ, vào Claude Code
./scripts/install.sh --tool claude-code

# chỉ hai phân ngành
./scripts/install.sh --tool claude-code --division engineering,security

# chỉ các tác nhân được đặt tên
./scripts/install.sh --tool cursor --agent frontend-developer,ui-designer

# xem có gì tồn tại trước khi cam kết
./scripts/install.sh --list teams
./scripts/install.sh --tool opencode --division engineering --dry-run

Các mục tiêu được hỗ trợ bao gồm Claude Code, Cursor, Codex, Gemini CLI, OpenCode, GitHub Copilot, Windsurf, Aider, Kimi Code, Hermes, Antigravity, Osaurus và Mistral Vibe. Ngoài ra còn có một ứng dụng desktop gốc tại agencyagents.app dành cho macOS, Linux và Windows để duyệt danh sách, cài đặt bằng một cú nhấp chuột và tự động cập nhật, cộng với một cask Homebrew.

Hãy đọc điều này trước khi cài đặt mọi thứ. Thời gian chạy của OpenCode hiện chỉ đăng ký khoảng 119 tác nhân và lặng lẽ bỏ qua phần còn lại, điều mà kho lưu trữ ghi nhận là một lỗi từ phía nhà cung cấp. Việc cài đặt một tập hợp con với --division giúp bạn nằm trong giới hạn, và trình cài đặt sẽ cảnh báo bạn khi một lựa chọn vượt quá giới hạn đó. Cắt bớt một cách âm thầm là chế độ lỗi tệ nhất, vì tác nhân bạn muốn bị thiếu và không có gì cho bạn biết.

Ngay cả khi không có lỗi cụ thể đó, việc cài đặt 300 hồ sơ cá nhân là một ý tưởng tồi. Một danh sách mà bạn không thể nhớ là một danh sách bạn sẽ không sử dụng. Hãy cài đặt hai phân ngành bạn làm việc, đọc bốn hoặc năm tệp, và xóa những tệp không khớp với cách nhóm của bạn thực sự hoạt động.

Một hồ sơ cá nhân thay đổi điều gì, và không thay đổi điều gì

Một hồ sơ cá nhân là một khung. Nó đặt ra những gì tác nhân tìm kiếm, định dạng mà nó tạo ra và những gì nó coi là hoàn thành. Điều đó có giá trị hơn những gì nghe có vẻ, bởi vì một phần lớn đầu ra tác nhân kém không phải do mô hình sai, mà là do mô hình tối ưu hóa cho dạng câu trả lời sai.

Điều mà một hồ sơ cá nhân không thể làm là cung cấp thông tin mà mô hình không có. Đây là giới hạn mà mọi người khám phá sau một tuần sử dụng, và nó thể hiện rõ nhất xung quanh các API.

Tải Backend Architect và yêu cầu nó viết một client cho dịch vụ thanh toán nội bộ của bạn. Nó sẽ tạo ra mã sạch, chuẩn mực dựa trên một dạng phản hồi mà nó tự sáng tạo. Nó không có cách nào để biết rằng dịch vụ của bạn trả về 409 với một phong bì lỗi khác khi một khóa idempotency bị lặp lại, hoặc rằng con trỏ phân trang là opaque chứ không phải là một offset. Hồ sơ cá nhân đã làm cho mã được tổ chức tốt hơn. Nó không làm cho mã đúng.

Giới hạn tương tự cũng áp dụng cho phân ngành kiểm thử. Một hồ sơ QA viết các bài kiểm thử kỹ lưỡng dựa trên mô hình tinh thần của riêng nó về API, vì vậy các bài kiểm thử vượt qua và không chứng minh được gì. Chúng tôi đã đề cập lý do tại sao vòng lặp cụ thể đó nguy hiểm trong kiểm thử các tác nhân AI không xác định, và điều gì xảy ra khi hình dạng thực thay đổi trong điều gì xảy ra khi các thay đổi API làm hỏng các tác nhân AI.

Cách khắc phục là cung cấp cho tác nhân hợp đồng thay vì hy vọng hồ sơ cá nhân bù đắp. Nếu API của bạn được thiết kế trong Apidog, thì đặc tả OpenAPI là nguồn sự thật: các schema thực, mã trạng thái thực, phong bì lỗi thực. Tác nhân đọc chúng thay vì tái tạo chúng từ các điểm gọi. Mocks được tạo từ cùng một đặc tả đó, bao gồm cả các nhánh lỗi mà một hồ sơ cá nhân sẽ không bao giờ nghĩ đến việc giả mạo, và bộ kiểm thử sẽ thất bại ầm ĩ trong CI khi thực tế và đặc tả khác biệt.

Sự kết hợp đó là mô hình tinh thần hữu ích. Hồ sơ cá nhân quyết định cách tác nhân hoạt động. Đặc tả quyết định điều gì là đúng. Đọc thêm: sử dụng đặc tả OpenAPI của bạn làm công cụ tác nhân và thiết kế schema công cụ API cho tác nhân. Nếu bạn muốn kết nối một đặc tả trực tiếp vào ngữ cảnh tác nhân của mình, hãy tải Apidog và chỉ nó vào dự án hiện có của bạn.

Giới hạn thứ hai: một hồ sơ cá nhân không phải là một nhóm

Đây là điều mà phép ẩn dụ về danh sách hứa hẹn nhưng không thực hiện được.

Mục đích là có một cơ quan hoàn chỉnh trong tầm tay bạn. Trong thực tế, bạn kích hoạt một hồ sơ cá nhân trong một phiên, nó thực hiện một nhiệm vụ, và phiên kết thúc. Ngày mai bạn gõ kích hoạt lại. Không có đội ngũ, bởi vì không có gì tồn tại vĩnh viễn: không có sự phân công, không có ghi chép về những gì người đánh giá bảo mật đã tìm thấy vào thứ Ba tuần trước, và không có cách nào để đồng nghiệp nhìn thấy bất kỳ điều gì trong số đó. Chín trong số các phân ngành trong kho lưu trữ này mô tả các vai trò chỉ có ý nghĩa trong một tổ chức, và công cụ cài đặt chúng không có khái niệm nào về điều đó.

Nếu bạn muốn ý tưởng danh sách này tồn tại sau một phiên terminal duy nhất, lớp bị thiếu là quản lý công việc. Sharkly được xây dựng chính xác cho mục đích đó, và sự tương ứng với agency-agents đủ gần để đáng được trình bày chi tiết.

• Một Agent trong Sharkly là một cấu hình đã lưu, không phải một lời nhắc bạn nhập lại. Nó chứa các hướng dẫn, môi trường chạy, kỹ năng, kho lưu trữ và môi trường. Một hồ sơ cá nhân bạn đã tinh chỉnh một lần sẽ được tái sử dụng, đây là phiên bản bền vững của những gì một tệp .md trong ~/.claude/agents/ đang hướng tới.
• Một Crew là một tác nhân lãnh đạo cộng với các tác nhân và con người khác. Đây là khái niệm phân ngành với cơ chế thực tế. Crews hoạt động theo kiểu lãnh đạo-đầu tiên: người lãnh đạo đọc ngữ cảnh nhiệm vụ, quyết định thành viên nào sẽ được kéo vào, và kết hợp kết quả của họ vào một nơi, thay vì mỗi chuyên gia bắt đầu cùng lúc và chạy đua.
• Công việc được giao, không phải được gọi. Bạn giao một nhiệm vụ cho một Agent giống như bạn giao cho một đồng đội. Nó tồn tại trong một không gian, một dự án và một sprint, với tính năng đồng bộ Jira nếu nhóm của bạn đã làm việc ở đó.
• Thực thi là do bạn tự mang đến. Bạn kết nối một Máy tính, có thể là máy tính xách tay của bạn, một máy chủ hoặc một container, và Sharkly sử dụng Runtime đã được cài đặt trên đó. Đăng ký Claude Code hoặc Codex của bạn thực hiện công việc; không có gì bán lại token cho bạn.
• Đầu ra có thể xem xét được. Tiến độ, các cuộc gọi công cụ và kết quả được truyền về nhiệm vụ, và đầu ra của tác nhân xuất hiện dưới dạng các bình luận mà bạn trả lời. Một nhiệm vụ trong Backlog không bắt đầu một lần chạy, vì vậy bạn có thể chuẩn bị công việc trước khi bất cứ điều gì được thực thi.

Nói một cách đơn giản: agency-agents cung cấp cho bạn mô tả công việc, và Sharkly cung cấp cho bạn nơi mà những công việc đó được giao, chạy và xem xét. Hãy sử dụng kho lưu trữ như một thư viện các định nghĩa vai trò để gieo mầm các Agent thực sự thay vì như một thư mục bạn cài đặt rồi quên.

Tự viết của riêng bạn, sử dụng của họ làm mẫu

Điều bền vững nhất mà kho lưu trữ này mang lại cho bạn là một định dạng. Một khi bạn đã đọc vài tệp, việc viết một hồ sơ cá nhân cho ngăn xếp của riêng bạn mất khoảng mười lăm phút, và một hồ sơ cụ thể của riêng bạn luôn vượt trội hơn một hồ sơ chung chung.

Cấu trúc lặp lại trong các tệp tốt:

• Danh tính và giọng điệu. Tác nhân này là ai và nó nói chuyện như thế nào. Nghe có vẻ mang tính hình thức, và đó là phần ngăn tác nhân quay trở lại chế độ trợ lý chung chung giữa chừng một nhiệm vụ dài.
• Nhiệm vụ cốt lõi. Một câu nói về ý nghĩa của thành công. Tệp Codebase Onboarding Engineer là một ví dụ rõ ràng: khám phá chỉ đọc, theo dõi đường dẫn mã, nêu sự thật về cấu trúc và hành vi, không đề xuất gì.
• Quy trình làm việc. Các bước có thứ tự mà tác nhân tuân theo. Đây là phần đáng để học hỏi. Một hồ sơ đánh giá với quy trình bảy bước tạo ra đầu ra nhất quán qua các phiên; một hồ sơ không có nó sẽ tạo ra bất cứ điều gì mô hình cảm thấy vào ngày đó.
• Sản phẩm bàn giao. Các hiện vật cụ thể, với định dạng. Nói "một bảng markdown các phát hiện với mức độ nghiêm trọng, đường dẫn tệp và số dòng" thay vì "một báo cáo".
• Các chỉ số thành công. Cách tác nhân biết nó đã hoàn thành, điều này cũng đồng nghĩa với việc bạn kiểm tra công việc của nó dựa trên đó.

Một phiên bản nội bộ cho công việc API có thể trông như thế này:

# Người đánh giá hợp đồng API

## Nhiệm vụ
Xác minh rằng các endpoint mới hoặc đã thay đổi khớp với đặc tả OpenAPI trong kho lưu trữ này
trước khi chúng được xem xét. Báo cáo các điểm không khớp. Không chỉnh sửa mã.

## Quy trình
1. Đọc đặc tả cho mọi endpoint bị ảnh hưởng bởi khác biệt hiện tại.
2. Đối với mỗi endpoint, so sánh trình xử lý với đặc tả: mã trạng thái,
   schema phản hồi, phong bì lỗi, tiêu đề bắt buộc, kiểu phân trang.
3. Chạy các bài kiểm tra hợp đồng. Ghi lại các lỗi nguyên văn.
4. Kiểm tra xem các endpoint mới đã được thêm vào đặc tả chứ không chỉ vào bộ định tuyến.
5. Gắn cờ bất kỳ trường phản hồi nào có trong mã mà không có trong đặc tả.

## Sản phẩm bàn giao
Một bảng: endpoint, phương thức, loại không khớp, dòng đặc tả, dòng mã, mức độ nghiêm trọng.
Không có tóm tắt văn xuôi. Không có đề xuất sửa lỗi trừ khi được yêu cầu.

## Hoàn thành khi
Mọi endpoint trong khác biệt xuất hiện trong bảng với một phán quyết, và
kết quả kiểm tra hợp đồng được đính kèm làm bằng chứng.

Tệp đó ngắn gọn, và nó có ích hơn cho một nhóm backend so với bất kỳ 59 hồ sơ kỹ thuật nào trong kho lưu trữ, bởi vì nó nêu tên đặc tả, các bài kiểm thử và định nghĩa về hoàn thành của bạn. Bước thứ ba là phần quan trọng: hồ sơ cá nhân được hướng dẫn tạo ra bằng chứng thay vì ý kiến, đó là sự khác biệt giữa một đánh giá mà bạn có thể hành động và một đoạn văn bản trấn an.

Thủ thuật tương tự cũng hiệu quả cho phản ứng sự cố, công việc di chuyển, nâng cấp phụ thuộc và tích hợp. Hãy lấy cấu trúc tệp, giữ kỷ luật quy trình, thay thế nội dung chung chung bằng nội dung của bạn. Khi đầu ra tác nhân phải trải qua quá trình chuyển giao cho con người hoặc tác nhân khác, hợp đồng định dạng thực hiện hầu hết công việc, đây là điểm chúng tôi đã đề cập trong chuyển giao tác nhân và truyền ngữ cảnh.

Số lượng sao ở đây có ý nghĩa không?

149.312 sao là rất nhiều, và nó xứng đáng có một lời cảnh báo. Các kho lưu trữ hồ sơ cá nhân thu thập sao nhanh hơn hầu hết các danh mục khác vì chúng dễ hiểu, dễ chia sẻ và không tốn kém để thử. Một sao có nghĩa là ai đó nghĩ rằng đây là một ý tưởng hay, không phải là họ vẫn sử dụng nó.

Điều làm cho kho lưu trữ này đáng tin cậy là hình dạng của công việc hơn là con số. Nó có lịch sử đóng góp thực tế từ tháng 10 năm 2025, nó được cấp phép MIT, nó ghi lại các giới hạn của chính nó bao gồm giới hạn đăng ký OpenCode, và các tệp tác nhân mang nội dung miền cụ thể hơn là những vai trò chung chung. So sánh điều đó với nhiều kho lưu trữ "awesome prompts" đã đạt đỉnh và dừng lại.

Hãy đánh giá nó bằng cách mở ba tệp trong một phân ngành mà bạn hiểu rõ. Nếu tệp Frontend Developer nói những điều mà một nhà phát triển frontend giỏi sẽ nói, thì phần còn lại có lẽ ổn. Nếu nó đọc như một bản mô tả công việc, hãy bỏ qua kho lưu trữ.

Làm thế nào để thực sự có được giá trị từ nó

Một quy trình làm việc hiệu quả:

1. Cài đặt một phân ngành. Chọn một phân ngành phù hợp với công việc hàng ngày của bạn. Kỹ thuật cho hầu hết độc giả.
2. Đọc các tệp. Bốn hoặc năm tệp, từ đầu đến cuối. Bạn đang tìm kiếm các phần quy trình, đây là phần đáng giữ lại.
3. Chỉnh sửa chúng. Thêm ngăn xếp của bạn, các quy ước của bạn, định nghĩa về hoàn thành của bạn. Một hồ sơ cá nhân mô tả một cửa hàng React chung chung ít giá trị hơn cùng tệp đó với các quy tắc kiểm thử của bạn.
4. Cung cấp đầu vào thực cho các hồ sơ cá nhân đã chỉnh sửa. Một nhà đánh giá bảo mật với đặc tả OpenAPI của bạn sẽ tìm thấy các vấn đề hợp đồng. Cùng một nhà đánh giá mà không có nó sẽ tạo ra một danh sách kiểm tra.
5. Thúc đẩy những hồ sơ cá nhân phù hợp. Bất kỳ hồ sơ cá nhân nào bạn sử dụng hai lần một tuần nên trở thành một Agent đã lưu trong hệ thống quản lý công việc thay vì một tệp bạn sao chép giữa các máy.

Bước cuối cùng đó là nơi các nhóm hoặc là mở rộng quy mô hoặc lặng lẽ từ bỏ nó.

Câu hỏi thường gặp

agency-agents có hoạt động với Cursor và Codex, hay chỉ Claude Code? Tất cả. Script convert.sh tạo các tệp tích hợp cho từng công cụ và install.sh --tool nhắm mục tiêu một công cụ cụ thể. Claude Code, Cursor, Codex, Gemini CLI, OpenCode, Copilot, Windsurf, Aider, Kimi Code, và một số công cụ khác đều được hỗ trợ. Nếu bạn đang so sánh các client tác nhân cho công việc API, hãy xem bài viết của chúng tôi về các client API trong Cursor và Copilot.

Tôi có nên cài đặt tất cả 300 tác nhân không? Không. Trên OpenCode bạn không thể, vì thời gian chạy chỉ đăng ký khoảng 119 tác nhân và tự động loại bỏ phần còn lại. Trên các công cụ khác bạn có thể cài đặt về mặt kỹ thuật, nhưng bạn sẽ không bao giờ sử dụng hầu hết chúng. Hãy cài đặt theo phân ngành.

Các hồ sơ cá nhân có làm cho tác nhân thông minh hơn không? Chúng giúp tác nhân được định hướng tốt hơn. Độ chính xác về các câu hỏi thực tế, bao gồm cả những gì API của bạn trả về, không thay đổi. Điều đó cần một đặc tả thực sự, đây là lập luận trong bạn vẫn cần một công cụ API trong thời đại tác nhân AI không.

Có an toàn khi chạy script cài đặt không? Nó ghi các tệp định nghĩa tác nhân vào thư mục cấu hình của công cụ của bạn. Đó là mục đích của nó. Nó được cấp phép MIT với mã nguồn đầy đủ, và --dry-run cho bạn thấy nó sẽ làm gì trước khi nó thực hiện. Hãy chạy dry run trước. Nguyên tắc chung về những gì bạn cho phép tác nhân chạm vào nằm trong các hàng rào bảo vệ tác nhân AI.

Sự khác biệt giữa điều này và một framework tác nhân là gì? Nếu bạn muốn các hồ sơ cá nhân chạy nhiều cái cùng lúc thay vì một cái mỗi phiên, đó là Orca. Một framework như Strands hoặc AgentKit cung cấp cho bạn khả năng điều phối thời gian chạy trong mã. agency-agents cung cấp cho bạn các tệp markdown thay đổi cách một tác nhân hiện có hoạt động. Lớp khác nhau, không chồng chéo.

Tóm tắt

agency-agents là phiên bản tốt nhất của một ý tưởng cụ thể: tác nhân của bạn làm việc tốt hơn khi nó biết mình đang đóng vai trò gì. Cài đặt một phân ngành, đọc các tệp, chỉnh sửa chúng để phù hợp với nhóm của bạn, và bạn sẽ nhận được giá trị thực chỉ với khoảng hai mươi phút thiết lập.

Sau đó, hãy thành thật về hai điều mà nó không giải quyết được. Các hồ sơ cá nhân không biết API của bạn trả về gì, đó là mục đích của Apidog, và chúng không tồn tại thành thứ mà một nhóm có thể nhìn thấy hoặc xem xét, đó là mục đích của Sharkly. Một danh sách là một khởi đầu tốt. Nó không phải là một tổ chức, và nó không phải là một nguồn sự thật.