Bỏ qua tới nội dung
Ông T.vn

wshobson/agents: Bộ agent AI cho lập trình — hướng dẫn cài đặt và dùng

12 phút đọcCập nhật
wshobson/agents: Bộ agent AI cho lập trình — hướng dẫn cài đặt và dùng

Tóm tắt nhanh

wshobson/agents là bộ sưu tập plugin, agent, skill và command cho các công cụ lập trình AI như Claude Code, Codex CLI, Cursor và OpenCode. Bạn có thể dùng nó để viết Python, JavaScript, review code, kiểm thử, bảo mật và dựng dự án. Cách cài tùy công cụ; Claude Code và Codex CLI có lệnh marketplace, còn một số công cụ cần clone repo và chạy Makefile.

wshobson/agents là bộ plugin, agent, skill và command cho các công cụ lập trình AI. Repo giúp bạn dùng một bộ hướng dẫn và quy trình thống nhất trong Claude Code, OpenAI Codex CLI, Cursor, OpenCode, Antigravity CLI, GitHub Copilot và Pi.

Điểm đáng giá nhất là người đóng góp chỉ viết mỗi thành phần một lần bằng Markdown. Repo sẽ tạo định dạng phù hợp cho từng công cụ, kiểm tra cấu trúc và chạy các bài đánh giá. Hiện bộ sưu tập có 94 plugin, gồm 92 plugin nội bộ và 2 mục bên ngoài; mã nguồn nội bộ có 202 agent, 185 skill và 105 command. Repo dùng giấy phép MIT và hiện có khoảng 42.473 sao cùng 4.488 fork.

Repo phù hợp với lập trình viên mới muốn có sẵn quy trình làm việc, người dùng AI coding tool cần các chuyên gia phụ trợ, và đội nhóm muốn chuẩn hóa việc review, test, bảo mật hoặc dựng dự án. Người làm kinh doanh, văn phòng cũng có thể hưởng lợi nếu đang dùng công cụ lập trình AI để tự động hóa website, báo cáo hoặc ứng dụng nội bộ.

Danh sách tuyển chọn

wshobson/agents

Bộ plugin, agent, skill và command dùng chung cho Claude Code, Codex CLI, Cursor cùng nhiều công cụ lập trình AI.

★ 42kPythonMIT
Xem repo trên GitHub

I.wshobson/agents làm được gì

A.Gom nhiều chuyên gia AI vào một bộ cài

Mỗi agent là một bộ hướng dẫn dành cho một loại công việc. Agent có thể hỗ trợ phân tích, triển khai hoặc kiểm tra một phần cụ thể của dự án. Bạn không phải tự viết lại prompt dài cho từng việc; chỉ cần cài plugin phù hợp rồi yêu cầu công cụ AI thực hiện nhiệm vụ.

B.Cung cấp skill để AI dùng đúng quy trình

Skill là hướng dẫn và tài liệu tham chiếu được agent tải khi cần. Chúng giúp công cụ AI hiểu cách xử lý những việc như kiểm thử Python, review code, bảo mật hoặc thiết lập dự án. Cách này hữu ích khi bạn muốn kết quả có quy trình rõ ràng hơn thay vì chỉ hỏi một câu chung chung.

C.Có command cho các thao tác lặp lại

Command là những quy trình có tên để bạn gọi lại. Ví dụ, plugin phát triển Python có command dựng một dịch vụ FastAPI kèm test. Bạn có thể dùng command khi cần tạo nhanh bộ khung dự án hoặc chạy một quy trình kiểm tra đã định nghĩa sẵn.

D.Hỗ trợ nhiều công cụ lập trình AI

Repo có đường cài đặt cho Claude Code, Codex CLI, Cursor, OpenCode, Antigravity CLI, GitHub Copilot và Pi. Mỗi công cụ có giới hạn khác nhau. Chẳng hạn, Claude Code đọc agent, skill, command và cả hook hoặc cấu hình MCP của plugin; một số công cụ khác dùng artifact được tạo tự động.

E.Có các nhóm công việc thực tế

Danh mục có plugin cho Python, Django, FastAPI, JavaScript, TypeScript, review code, debug, Git, kiểm thử, hạ tầng, bảo mật, kiểm tra dependency và quét mã nguồn. Bạn có thể bắt đầu từ các plugin gợi ý như python-development, javascript-typescript, developer-essentials và security-scanning.

F.Có kiểm tra và đánh giá chất lượng

Repo có các lệnh để tạo lại artifact, kiểm tra cấu trúc và chạy quy trình garden. Công cụ plugin-eval có thể kiểm tra tĩnh skill mà không cần gọi model. Repo cũng có lớp đánh giá dùng LLM và Monte Carlo, nhưng tài liệu nói rõ các lớp này mang tính thử nghiệm và không chứng minh một task chắc chắn thành công trong dự án thật.

II.Cần chuẩn bị gì

Bạn cần chọn một công cụ lập trình AI làm harness, tức công cụ sẽ tải và chạy các plugin, agent, skill hoặc command. Repo hỗ trợ Claude Code, OpenAI Codex CLI, Cursor, OpenCode, Antigravity CLI, GitHub Copilot và Pi.

Nếu cài theo cách clone repo cho OpenCode, Antigravity CLI, GitHub Copilot hoặc Pi, README yêu cầu cài uv, Python 3.12 trở lên và công cụ lập trình tương ứng. README có chỉ dẫn cài uv, nhưng nội dung được cung cấp ở đây không ghi lệnh cụ thể cho bước đó.

Nếu dùng cách cài skill riêng lẻ bằng gh skill, bạn cần GitHub CLI phiên bản 2.90 trở lên. Nếu dùng npx skills, bạn cần Node.js và npm.

Một số chức năng đánh giá bằng LLM cần dependency tùy chọn llm. Khi biến ANTHROPIC_API_KEY được đặt, các lần gọi model dùng và tính phí vào tài khoản API Anthropic. Nếu không đặt biến này, chúng dùng tài khoản Claude Code của bạn.

README không nêu yêu cầu GPU, tài khoản trả phí bắt buộc, hay hệ điều hành cụ thể. Vì vậy, mình không kết luận repo cần GPU hoặc chỉ chạy trên một hệ điều hành nào.

Hãy kiểm tra kỹ công cụ đang dùng, quyền truy cập repo và tài khoản model trước khi chạy đánh giá LLM. Nếu có ANTHROPIC_API_KEY, các lần gọi model có thể phát sinh chi phí vào tài khoản API đó.

III.Cài đặt từng bước

  1. Chọn harnessChọn Claude Code, Codex CLI, Cursor, OpenCode, Antigravity CLI, GitHub Copilot hoặc Pi
  2. Chọn pluginXác định nhóm công việc như Python, JavaScript, review hoặc bảo mật
  3. Cài theo đường tương ứngDùng marketplace, skills-only installer hoặc clone repo
  4. Chạy thửGọi command hoặc yêu cầu công cụ dùng agent đã cài
  5. Kiểm tra repoNếu phát triển plugin, chạy generate, validate và garden

A.Chọn công cụ và plugin

Trước tiên, xác định bạn đang dùng công cụ nào. Cách cài không giống nhau. Claude Code và Codex CLI có lệnh marketplace trong README. OpenCode, Antigravity CLI, GitHub Copilot và Pi cần clone repo rồi chạy lệnh make tương ứng. Cursor dùng marketplace registry đã commit.

Nếu chưa biết bắt đầu từ đâu, README gợi ý bốn plugin: python-development cho Python, Django, FastAPI, testing và packaging; javascript-typescript cho JavaScript, TypeScript và thiết lập dự án; developer-essentials cho review code, debug, Git và mẫu kiểm thử; security-scanning cho review bảo mật, kiểm tra dependency và quét mã nguồn.

B.Cài trên Claude Code

Mở Claude Code trong terminal. Chạy hai lệnh sau để đăng ký marketplace rồi cài plugin Python:

text
/plugin marketplace add wshobson/agents
/plugin install python-development@claude-code-workflows

Sau khi cài, bạn có thể yêu cầu Claude dùng các agent Python cho task của mình. README cũng đưa command dựng một dịch vụ FastAPI có test:

text
/python-development:python-scaffold Create a FastAPI service with tests

Phần câu lệnh tiếng Anh sau tên command là yêu cầu cụ thể. Bạn có thể thay bằng mô tả dự án của mình, nhưng nên nói rõ công nghệ, đầu ra và yêu cầu kiểm thử để agent có đủ ngữ cảnh.

C.Cài trên Codex CLI

Mở terminal có Codex CLI hiện tại. Chạy đúng các lệnh sau:

Terminal
codex plugin marketplace add wshobson/agents
codex plugin add python-development@claude-code-workflows

Bản cài native của Codex cung cấp source skill. README lưu ý agent dạng TOML được tạo ra và skill sinh từ command đi theo đường adapter riêng. Bản native cũng đọc trực tiếp nội dung skill gốc, trong khi bản được tạo có thể tách nội dung lớn thành file tham chiếu để đáp ứng giới hạn 8 KB.

D.Cài riêng một skill

Nếu bạn chỉ cần một skill mà không cần toàn bộ agent, command hoặc hook của plugin, có thể dùng GitHub CLI hoặc trình cài npx. Hai lệnh nguyên văn trong README là:

Terminal
gh skill install wshobson/agents python-testing-patterns
npx skills add wshobson/agents --skill python-testing-patterns

Lệnh đầu yêu cầu GitHub CLI 2.90 trở lên. Lệnh thứ hai yêu cầu Node.js và npm. Khi trình cài hỏi, hãy chọn đúng coding tool bạn đang dùng. README nói hai installer này đọc skill trực tiếp từ GitHub, không cần clone repo, đồng thời không cài agent, command hoặc hook đi kèm plugin.

E.Cài bằng bản clone

Cách này dành cho OpenCode, Antigravity CLI, GitHub Copilot và Pi. README đưa lệnh clone bằng GitHub CLI:

Terminal
gh repo clone wshobson/agents ~/agents
cd ~/agents

Lệnh đầu tải repo vào thư mục ~/agents. Lệnh thứ hai chuyển terminal vào thư mục repo. Nếu terminal đang ở thư mục khác thì vẫn có thể chạy lệnh clone; lỗi thường gặp là chạy make trước khi dùng cd ~/agents.

Sau đó, chạy đúng lệnh tương ứng với công cụ bạn dùng:

Terminal
make install-opencode
make install-antigravity
make install-copilot
make install-pi

Mỗi lệnh tạo artifact cho harness tương ứng và liên kết toàn bộ plugin nội bộ vào cấu hình người dùng của công cụ đó. Pi cần extension subagent tham chiếu hoặc extension tương thích nếu bạn muốn dùng agent của Pi.

F.Kiểm tra cấu hình của plugin

Nếu bạn đang phát triển hoặc chỉnh sửa plugin, đứng ở thư mục gốc repo rồi chạy các lệnh kiểm tra trong README:

Terminal
make generate-all
make validate STRICT=1
make garden

make generate-all tạo lại artifact cho các harness. make validate STRICT=1 kiểm tra với chế độ nghiêm ngặt. make garden chạy kiểm tra tổng hợp theo quy trình của repo. Các lệnh này phù hợp với người đóng góp hoặc đội nhóm muốn xác nhận thay đổi trước khi chia sẻ.

IV.Kiểm tra đã chạy được chưa

Cách kiểm tra phụ thuộc vào harness. Với Claude Code, kết quả mong đợi là marketplace được đăng ký, plugin python-development được cài và bạn có thể gọi command:

text
/python-development:python-scaffold Create a FastAPI service with tests

Nếu công cụ bắt đầu xử lý yêu cầu dựng FastAPI và test, đường cài Claude Code đã hoạt động.

Với Codex CLI, hai lệnh codex plugin marketplace add và codex plugin add phải hoàn tất mà không báo lỗi. Sau đó, kiểm tra xem Codex có nhận các skill được cung cấp hay không bằng cách giao một task Python hoặc kiểm thử phù hợp.

Với OpenCode, Antigravity CLI, GitHub Copilot và Pi, lệnh make install-... tương ứng phải chạy được từ thư mục repo. README nói các lệnh này tạo artifact và liên kết plugin vào cấu hình người dùng. Pi còn cần extension tương thích cho agent.

Nếu bạn đang kiểm tra chất lượng mã nguồn, ba lệnh make generate-all, make validate STRICT=1 và make garden là các lệnh xác nhận được README cung cấp. Với một skill cụ thể, có thể chạy:

Terminal
uv run --project plugins/plugin-eval plugin-eval score plugins/python-development/skills/python-testing-patterns --depth quick

Lệnh này chạy kiểm tra điểm cho skill python-testing-patterns ở mức quick. Đây là kiểm tra tĩnh của plugin-eval, không phải bằng chứng tuyệt đối rằng task thực tế sẽ thành công.

V.Dùng vào việc thật

A.Chủ shop cần dựng API đơn giản

Một chủ shop muốn tạo API FastAPI để quản lý sản phẩm có thể cài plugin python-development trên Claude Code, sau đó gọi:

text
/python-development:python-scaffold Create a FastAPI service with tests

Kết quả mong đợi theo README là command khởi động quy trình scaffolding cho một dịch vụ FastAPI có test. Khi dùng trong dự án thật, bạn nên bổ sung các yêu cầu như trường dữ liệu sản phẩm, cách chạy và quy tắc xác thực.

B.Lập trình viên mới làm dự án Python

Một lập trình viên mới có thể dùng python-development cho Python, Django, FastAPI, testing và packaging. Thay vì tự soạn prompt về mọi bước, bạn có thể yêu cầu công cụ dùng các agent Python cho task cụ thể, chẳng hạn kiểm tra cấu trúc dự án hoặc viết test.

Điểm hữu ích là bộ plugin gom hướng dẫn vào một quy trình có sẵn. Tuy vậy, README không cam kết một agent cụ thể luôn tạo đúng mã cho mọi dự án. Bạn vẫn cần đọc diff, chạy test và kiểm tra dependency.

C.Nhân viên kỹ thuật review code

Một nhân viên văn phòng có thể phối hợp với dev để kiểm tra một ứng dụng nội bộ. Plugin developer-essentials tập trung vào code review, debug, Git và mẫu kiểm thử. Sau khi cài plugin theo route của công cụ đang dùng, hãy giao task nêu rõ phạm vi review, file cần xem và tiêu chí chấp nhận.

Kết quả có thể là các nhận xét và đề xuất sửa trong phạm vi những capability mà plugin cung cấp. Không nên gửi thông tin bí mật nếu chính sách dữ liệu của đội nhóm chưa cho phép.

D.Đội phát triển muốn rà soát bảo mật

Đội dev có thể chọn security-scanning để review bảo mật, kiểm tra dependency và quét mã nguồn. Hãy nêu rõ repository hoặc thư mục cần kiểm tra, loại dependency đang dùng và dạng báo cáo mong muốn.

Plugin giúp tạo quy trình ban đầu, nhưng không thay thế việc đánh giá bảo mật chuyên sâu. Các phát hiện cần được xác minh lại, nhất là cảnh báo có thể ảnh hưởng đến hệ thống đang chạy.

Dùng đúng plugin giúp biến một yêu cầu lập trình chung thành quy trình có agent, skill và command rõ ràng.

Ông T

VI.Lỗi hay gặp và cách xử lý

A.Dùng sai lệnh cho sai công cụ

Mỗi harness có route cài riêng. Không nên chạy make install-opencode nếu bạn đang cài Claude Code, cũng không nên dùng lệnh Claude Code trong Codex CLI. Hãy xác định công cụ trước rồi chọn đúng phần hướng dẫn tương ứng.

B.Chạy lệnh clone nhưng quên chuyển thư mục

Các lệnh make install-... phải chạy sau khi bạn vào thư mục repo. Nếu terminal không ở ~/agents, hãy chạy lại:

Terminal
cd ~/agents

Sau đó dùng đúng lệnh cài cho harness.

C.Thiếu công cụ nền tảng

Cài skill riêng lẻ bằng gh skill cần GitHub CLI 2.90 trở lên. Cài bằng npx skills cần Node.js và npm. Cách clone cho các harness còn lại cần uv, Python 3.12 trở lên và công cụ lập trình tương ứng. README không cung cấp trong phần tư liệu này lệnh cài từng dependency, nên bạn cần xem hướng dẫn setup liên quan trong repo.

D.Pi không chạy được agent

README nói agent của Pi cần extension subagent tham chiếu hoặc extension tương thích. Nếu skill và prompt template đã cài nhưng agent không hoạt động, hãy kiểm tra phần cấu hình extension và hướng dẫn global install của Pi trong repo.

E.Đánh giá LLM phát sinh chi phí

Khi đặt ANTHROPIC_API_KEY, các model call dùng tài khoản API Anthropic và bị tính phí vào tài khoản đó. Nếu không đặt biến, chúng dùng tài khoản Claude Code. Hãy chỉ chạy các lớp đánh giá LLM khi bạn hiểu giới hạn và chi phí; plugin-eval có kiểm tra tĩnh không cần model call để bắt đầu an toàn hơn.

VII.Có nên dùng không

Nên dùng nếu bạn đang dùng một trong các harness được hỗ trợ và muốn có sẵn quy trình cho phát triển, review, kiểm thử hoặc bảo mật. Repo có số lượng thành phần lớn, hỗ trợ nhiều công cụ, có cơ chế adapter và có kiểm tra artifact. Việc viết một nguồn Markdown rồi tạo định dạng cho từng harness cũng giúp đội nhóm giảm công sức duy trì.

Giới hạn là capability thay đổi theo công cụ. Một plugin có thể cung cấp agent, skill, command, hook hoặc MCP configuration trên harness này nhưng không đầy đủ trên harness khác. Codex cũng có khác biệt giữa bản native và artifact được tạo; Pi cần extension bổ sung cho agent.

Bạn cũng không nên xem điểm đánh giá của LLM là bảo đảm chất lượng tuyệt đối. README ghi rõ các lớp LLM judge và Monte Carlo còn thử nghiệm, không được xác thực với nhãn do con người tạo và không chứng minh task sẽ thành công trong dự án thật. Vì vậy, vẫn phải review mã, chạy test và kiểm tra bảo mật.

Nếu chỉ cần một skill nhỏ, dùng gh skill hoặc npx skills sẽ gọn hơn clone toàn bộ repo. Nếu công ty cần một workflow được kiểm soát chặt, hãy đọc capability matrix, hướng dẫn sử dụng và tài liệu kiến trúc trong repo trước khi áp dụng rộng. Với những đội muốn xây bộ plugin đa công cụ, wshobson/agents là lựa chọn đáng cân nhắc nhờ giấy phép MIT, số lượng thành phần lớn và quy trình tạo artifact có sẵn.

5.0/5 · Ông T chấm

Chưa có độc giả chấm

Bài này có ích với bạn không?

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

wshobson/agents có miễn phí không?

Repo dùng giấy phép MIT. Tuy nhiên, nếu chạy các lớp đánh giá LLM với ANTHROPIC_API_KEY, các lần gọi model sẽ tính phí vào tài khoản API Anthropic.

Repo này có cần GPU không?

Tư liệu được cung cấp không nêu yêu cầu GPU. Repo chủ yếu cung cấp plugin, agent, skill và command cho các công cụ lập trình AI.

Có chạy được trên Windows không?

README không nêu hệ điều hành được hỗ trợ. Vì vậy chưa có đủ thông tin để khẳng định riêng về Windows.

Tôi cần cài những gì để dùng bản clone?

Với OpenCode, Antigravity CLI, GitHub Copilot và Pi, README yêu cầu uv, Python 3.12 trở lên và công cụ lập trình tương ứng. Cách cài skill bằng gh skill cần GitHub CLI 2.90 trở lên; cách dùng npx skills cần Node.js và npm.

Có phải clone repo mới cài được không?

Không. Claude Code và Codex CLI có route marketplace, còn một skill riêng lẻ có thể cài bằng gh skill hoặc npx skills. Clone repo chủ yếu được README hướng dẫn cho OpenCode, Antigravity CLI, GitHub Copilot và Pi.

Repo hỗ trợ những công cụ nào?

Repo hỗ trợ Claude Code, OpenAI Codex CLI, Cursor, OpenCode, Antigravity CLI, GitHub Copilot và Pi. Thành phần có thể khác nhau tùy capability của từng harness.

Dữ liệu và API key có an toàn không?

README chỉ nói các model call dùng ANTHROPIC_API_KEY khi biến này được đặt và tính phí vào tài khoản API đó; nếu không, chúng dùng tài khoản Claude Code. Tư liệu không nêu chính sách lưu trữ dữ liệu chi tiết, nên bạn cần tự kiểm tra quy định của công cụ và nhà cung cấp trước khi gửi mã nguồn nhạy cảm.

Chuyển nhanh tới mục

  1. I.wshobson/agents làm được gì
    1. A.Gom nhiều chuyên gia AI vào một bộ cài
    2. B.Cung cấp skill để AI dùng đúng quy trình
    3. C.Có command cho các thao tác lặp lại
    4. D.Hỗ trợ nhiều công cụ lập trình AI
    5. E.Có các nhóm công việc thực tế
    6. F.Có kiểm tra và đánh giá chất lượng
  2. II.Cần chuẩn bị gì
  3. III.Cài đặt từng bước
    1. A.Chọn công cụ và plugin
    2. B.Cài trên Claude Code
    3. C.Cài trên Codex CLI
    4. D.Cài riêng một skill
    5. E.Cài bằng bản clone
    6. F.Kiểm tra cấu hình của plugin
  4. IV.Kiểm tra đã chạy được chưa
  5. V.Dùng vào việc thật
    1. A.Chủ shop cần dựng API đơn giản
    2. B.Lập trình viên mới làm dự án Python
    3. C.Nhân viên kỹ thuật review code
    4. D.Đội phát triển muốn rà soát bảo mật
  6. VI.Lỗi hay gặp và cách xử lý
    1. A.Dùng sai lệnh cho sai công cụ
    2. B.Chạy lệnh clone nhưng quên chuyển thư mục
    3. C.Thiếu công cụ nền tảng
    4. D.Pi không chạy được agent
    5. E.Đánh giá LLM phát sinh chi phí
  7. VII.Có nên dùng không

Repo & Skill · 13/11/2026 · 11 phút đọc

Garden Skills: bộ skill thiết kế web, tạo ảnh, làm video cho AI — hướng dẫn cài đặt và dùng

Garden Skills là bộ sưu tập Agent Skills (kỹ năng cho AI) của tác giả ConardLi, dùng được với Claude Code, Cursor, Codex và các AI coding agent khác. Mỗi skill dạy agent làm tốt một việc như thiết kế trang web, tạo ảnh, làm video bằng code, biến tài liệu thành bài viết đẹp. Cài không khó, nhưng README có nhiều cách cài nên bạn cần chọn một cách hợp với công cụ đang dùng.

Repo & Skill · 13/11/2026 · 15 phút đọc

thesysdev/openui: xây giao diện AI dạng streaming — hướng dẫn cài đặt và dùng

OpenUI là framework full-stack, độc lập framework, giúp mô hình AI sinh giao diện có cấu trúc và hiển thị dần khi dữ liệu streaming về. Bạn có thể dựng nhanh một ứng dụng chat bằng CLI hoặc cài từng gói cho React, Vue, Svelte, Angular và LangChain. Việc bắt đầu khá đơn giản nếu máy có đúng phiên bản Node; README chưa ghi đầy đủ lệnh chạy ứng dụng sau khi scaffold.

Repo & Skill · 13/11/2026 · 11 phút đọc

Ruflo: điều phối nhóm agent AI cho Claude Code và Codex — hướng dẫn cài đặt và dùng

Ruflo (trước đây là Claude Flow) là một agent harness: lớp công cụ bao quanh Claude Code và Codex, bổ sung nhiều agent chuyên biệt, bộ nhớ qua các phiên và khả năng chia việc cho nhóm agent. Cài bằng một lệnh `npx ruflo@latest init` trong thư mục dự án, cần Node 20 trở lên. Cài khá dễ, nhưng hệ thống rất rộng nên bạn nên bắt đầu từ một tác vụ nhỏ.