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

Bài này là một góc nhìn khác về wshobson/agents — repo từng đổi tên nên mình viết lại với cách tiếp cận khác. Bài hướng dẫn chính: wshobson/agents: Bộ agent AI cho lập trình — hướng dẫn cài đặt và dùng →

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 viết bằng Markdown, dùng cho nhiều công cụ lập trình AI. Repo hỗ trợ Claude Code, Codex CLI, Cursor, OpenCode, Antigravity CLI, GitHub Copilot và Pi. Cài đặt khá đơn giản nếu bạn dùng đúng công cụ; một số tuyến cần uv, Python và lệnh make.

wshobson/agents là bộ plugin, agent, skill và command cho các công cụ lập trình AI. Bạn có thể dùng một nguồn nội dung cho Claude Code, OpenAI Codex CLI, Cursor, OpenCode, Antigravity CLI, GitHub Copilot và Pi.

Repo phù hợp với lập trình viên muốn giao việc có cấu trúc cho AI: tạo dự án Python, viết kiểm thử, review code, debug, kiểm tra bảo mật hoặc làm việc với JavaScript và TypeScript. Điểm đáng giá nhất là các thành phần được viết một lần bằng Markdown, sau đó bộ chuyển đổi tạo định dạng phù hợp cho từng công cụ.

Repo hiện có khoảng 42.473 sao và 4.488 fork, dùng giấy phép MIT. Nội dung chính gồm khoảng 94 plugin, 202 agent, 185 skill và 105 command trong mã nguồn cục bộ. Bạn không cần cài toàn bộ; có thể chọn một plugin hoặc chỉ một skill phù hợp với công việc.

Danh sách tuyển chọn

wshobson/agents

Bộ plugin, agent, skill và command 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 sẵn các workflow cho lập trình

Repo cung cấp những workflow có thể dùng ngay cho phát triển Python, Django, FastAPI, JavaScript, TypeScript, kiểm thử, đóng gói, review code, Git, debug và quét bảo mật. Thay vì viết lại một prompt dài cho mỗi dự án, bạn gọi đúng plugin hoặc command cho nhiệm vụ cần làm.

Lợi ích thực tế là bạn có một cách làm thống nhất giữa các dự án. Một nhân viên mới có thể dùng workflow đã được chuẩn hóa để tạo service, viết test hoặc kiểm tra code mà không phải tự thiết kế toàn bộ hướng dẫn cho AI.

B.Dùng cùng nhiều công cụ AI

Claude Code, Codex CLI, Cursor, OpenCode, Antigravity CLI, GitHub Copilot và Pi có cách đọc cấu hình khác nhau. Repo dùng các adapter để tạo artifact phù hợp với từng harness, tức công cụ chịu trách nhiệm tải và chạy component.

Bạn có thể giữ cùng một bộ nội dung khi đổi công cụ. Tuy vậy, thành phần sẵn có và giới hạn phụ thuộc vào tuyến cài đặt và khả năng của từng harness.

C.Chọn agent chuyên môn cho từng việc

Agent là các hướng dẫn dành cho những tác vụ chuyên biệt và có thể được công cụ gọi khi cần. Ví dụ, một agent có thể hỗ trợ kiểm thử Python, review code hoặc phân tích bảo mật.

Cách tổ chức này hữu ích khi dự án có nhiều loại việc. Bạn không phải giao mọi nhiệm vụ cho một prompt chung, nên dễ chọn đúng hướng dẫn hơn.

D.Tải skill khi cần

Skill là phần hướng dẫn và tài liệu tham khảo mà agent có thể nạp khi phù hợp. Repo cũng hỗ trợ cài từng skill bằng GitHub CLI hoặc trình cài npx skills, không cần clone toàn bộ kho mã.

Đây là lựa chọn gọn cho người chỉ cần một khả năng, chẳng hạn skill python-testing-patterns, nhưng không muốn cài thêm agent, command hoặc hook của cả plugin.

E.Tạo artifact và kiểm tra chất lượng

Các adapter tạo định dạng cho từng công cụ. Repository có kiểm tra cấu trúc plugin, artifact đã sinh và tài liệu. Bạn cũng có thể chạy các lệnh kiểm tra từ thư mục gốc để xác nhận nội dung sinh ra hợp lệ.

Repo có plugin-eval cho kiểm tra skill tĩnh mà không cần gọi model. Các lớp đánh giá bằng LLM và Monte Carlo là thử nghiệm; điểm số của chúng chỉ mô tả đánh giá của model và mô phỏng lặp lại, không chứng minh một task luôn thành công trong dự án thật.

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

  • Một công cụ AI lập trình được repo hỗ trợ: Claude Code, Codex CLI, Cursor, OpenCode, Antigravity CLI, GitHub Copilot hoặc Pi.
  • Với tuyến cài từ clone cho OpenCode, Antigravity CLI, GitHub Copilot và Pi: cần uv, Python 3.12 trở lên và công cụ lập trình tương ứng.
  • Với cách cài skill riêng: gh skill cần GitHub CLI 2.90 trở lên. Lệnh npx skills cần Node.js và npm.
  • Với đánh giá có LLM: cần các dependency tùy chọn llm. Khi biến ANTHROPIC_API_KEY được đặt, lệnh dùng key đó và tính phí vào tài khoản API tương ứng; nếu không, lệnh dùng đăng nhập Claude Code.
  • Tài khoản, API key hoặc phần cứng GPU không được README nêu thành yêu cầu chung. Việc có cần đăng nhập hay key hay không phụ thuộc công cụ và tuyến sử dụng.

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

  1. Chọn harnessXác định bạn dùng Claude Code, Codex CLI, Cursor, OpenCode, Antigravity CLI, Copilot, Pi hoặc chỉ cần skill
  2. Cài plugin hoặc skillDùng lệnh phù hợp với công cụ đã chọn
  3. Cài từ clone nếu cầnClone repo và chạy installer cho OpenCode, Antigravity CLI, Copilot hoặc Pi
  4. Chạy thử workflowGọi command hoặc yêu cầu công cụ dùng agent phù hợp
  5. Kiểm tra tùy chọnChạy generate, validate, garden hoặc plugin-eval khi cần

A.Chọn tuyến cài đặt

Trước hết, xác định công cụ bạn đang dùng. Claude Code, Codex CLI và Cursor có tuyến marketplace. OpenCode, Antigravity CLI, GitHub Copilot và Pi dùng repo đã clone cùng các lệnh make install-*. Nếu chỉ muốn một skill, dùng GitHub CLI hoặc npx skills.

Nếu bạn chưa biết mình đang dùng harness nào, hãy kiểm tra tên công cụ mở trong terminal hoặc editor. Không nên chạy lẫn lệnh của các tuyến, vì mỗi harness có cách nạp component riêng.

B.Cài plugin cho Claude Code

Mở Claude Code và chạy hai lệnh sau trong phiên làm việc của Claude Code:

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

Lệnh đầu đăng ký marketplace của repo. Lệnh thứ hai cài plugin python-development. Sau đó, bạn có thể yêu cầu Claude dùng các agent Python hoặc gọi command scaffold:

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

Bạn có thể thay nội dung sau command bằng yêu cầu thật của dự án. README không nêu tên mọi command cho mọi plugin, vì vậy hãy xem plugin catalog và usage guide trong repo để chọn đúng component.

C.Cài plugin cho Codex CLI

Mở terminal có Codex CLI hiện hành rồi chạy:

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

Lệnh đầu thêm marketplace. Lệnh sau cài plugin Python development. README lưu ý rằng manifest native của Codex chủ yếu cung cấp source skill. Agent TOML được sinh ra và các command chuyển thành skill đi theo một tuyến adapter riêng.

Native installation đọc body skill gốc. Bản sinh có thể tách body quá lớn thành file tham chiếu để phù hợp giới hạn 8 KB. Nếu bạn cần agent hoặc command đã chuyển đổi, hãy xem phần hướng dẫn Codex trong tài liệu repo trước khi chọn tuyến cài.

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

Nếu chỉ cần skill kiểm thử Python, dùng GitHub CLI:

Terminal
gh skill install wshobson/agents python-testing-patterns

Hoặc dùng trình cài npx:

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

Cả hai cách đọc skill trực tiếp từ GitHub mà không clone repo. Chúng cài skill mà không cài agent, command hoặc hook của plugin. Với gh skill, cần GitHub CLI 2.90 trở lên. Với npx, cần Node.js và npm. Khi trình cài hỏi công cụ lập trình, hãy chọn đúng harness bạn đang dùng.

E.Clone repo cho các tuyến dùng Makefile

Nếu dùng 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ụ tương ứng. Sau đó clone repo và đi vào thư mục:

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

Lệnh đầu dùng GitHub CLI để sao chép repo vào thư mục ~/agents. Lệnh thứ hai chuyển terminal vào thư mục gốc. Nếu terminal báo không tìm thấy gh, bạn cần cài GitHub CLI trước; README không đưa lệnh cài GitHub CLI cụ thể.

Chạy installer tương ứng với công cụ của bạn:

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 các plugin cục 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 để agent hoạt động. Đường dẫn cấu hình và lệnh gỡ cài đặt được nêu trong global install guide của repo.

F.Cài cho Cursor

README cho biết Cursor dùng registry marketplace của plugin. Bạn cần làm theo hướng dẫn Cursor trong tài liệu repo để thêm marketplace và cài plugin.

README chưa ghi lệnh cụ thể cho Cursor trong phần nội dung được cung cấp. Vì vậy, không nên tự đoán command hoặc đường dẫn. Hãy mở phần Cursor setup instructions trong repo và làm đúng theo registry đã commit.

G.Sinh và kiểm tra artifact

Từ thư mục gốc repo, bạn có thể chạy bộ kiểm tra dành cho contributor:

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

make generate-all sinh 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 garden được repo cung cấp. Các lệnh này phù hợp khi bạn muốn xác nhận cấu trúc hoặc đang chỉnh sửa nội dung trong repo.

Để chấm tĩnh một skill 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 dùng uv chạy plugin-eval trong project plugins/plugin-eval, sau đó chấm skill python-testing-patterns ở độ sâu quick. Nếu thiếu dependency hoặc uv, lệnh sẽ không chạy được.

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

Cách kiểm tra phụ thuộc tuyến cài đặt. Với Claude Code, marketplace và plugin phải được đăng ký thành công, sau đó command sau phải được nhận diện:

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

Với Codex CLI, hai lệnh codex plugin không báo lỗi và plugin xuất hiện trong cấu hình hoặc danh sách plugin của Codex là dấu hiệu cài thành công. README không cung cấp một màn hình đầu ra cụ thể.

Với tuyến clone, các lệnh make install-opencode, make install-antigravity, make install-copilot hoặc make install-pi phải chạy được từ thư mục gốc. Repo cho biết 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.

Nếu muốn kiểm tra nội dung được sinh, chạy:

Terminal
make generate-all
make validate STRICT=1

Kết quả mong đợi là quá trình sinh và kiểm tra hoàn tất mà không có lỗi. Với skill, chạy plugin-eval ở trên để nhận điểm kiểm tra tĩnh. Điểm này không phải bằng chứng rằng mọi yêu cầu trong dự án sẽ thành công.

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

A.Chủ shop cần làm API quản lý đơn hàng

Một chủ shop có đội kỹ thuật nhỏ muốn làm service FastAPI có kiểm thử có thể cài plugin python-development trong Claude Code, rồi gọi:

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

Kết quả mong đợi là Claude dùng workflow scaffold Python để bắt đầu service và test. README chỉ nêu rõ ví dụ FastAPI này; cấu trúc dữ liệu đơn hàng, thanh toán hay kho cần được bạn mô tả thêm trong yêu cầu.

B.Nhân viên văn phòng quản lý một dự án nội bộ

Một nhân viên văn phòng có thể nhờ người phụ trách kỹ thuật dùng các plugin trong developer-essentials cho review code, debug, Git và mẫu kiểm thử. Khi plugin đã được cài, người phụ trách có thể yêu cầu công cụ review một thay đổi hoặc giải thích lỗi theo workflow có sẵn.

Repo không đưa một prompt mẫu riêng cho tình huống văn phòng. Vì vậy, hãy nêu rõ mục tiêu, file cần xem và kết quả mong muốn trong yêu cầu gửi cho công cụ.

C.Dev mới học kiểm thử Python

Một dev mới không cần cài cả bộ plugin. Có thể cài riêng skill python-testing-patterns:

Terminal
gh skill install wshobson/agents python-testing-patterns

Sau đó chọn công cụ lập trình khi trình cài hỏi. Cách này phù hợp khi bạn chỉ cần hướng dẫn về mẫu kiểm thử Python và muốn tránh cài thêm agent, command hoặc hook không dùng đến.

D.Nhóm phát triển muốn kiểm tra bảo mật

Nhóm phát triển có thể chọn plugin security-scanning để hỗ trợ review bảo mật, kiểm tra dependency và code scanning. README xếp đây là một trong các plugin khởi đầu được gợi ý.

Nếu nhóm đang phát triển JavaScript hoặc TypeScript, có thể xem plugin javascript-typescript. Với Python, Django, FastAPI, testing và packaging, plugin python-development là lựa chọn trực tiếp hơn.

Chọn đúng plugin giúp AI làm việc theo quy trình, nhưng kết quả vẫn cần được kiểm tra trong dự án thật.

Ông T

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

A.Chạy Makefile nhưng thiếu uv hoặc Python

Tuyến cài từ clone yêu cầu uv và Python 3.12 trở lên. Nếu lệnh make install-* lỗi ngay từ đầu, kiểm tra hai yêu cầu này trước và bảo đảm terminal đang ở thư mục repo.

B.Dùng sai lệnh cho harness

Lệnh /plugin ... dành cho Claude Code, còn codex plugin ... dành cho Codex CLI. OpenCode, Antigravity CLI, Copilot và Pi dùng các mục tiêu make install-*. Chọn đúng tuyến theo công cụ đang chạy.

C.Cài skill nhưng mong có cả agent và command

gh skill install và npx skills add chỉ cài skill. Chúng không cài agent, command hoặc hook của plugin. Nếu cần nhóm component đầy đủ, hãy cài plugin theo marketplace hoặc clone repo theo hướng dẫn của harness.

D.Plugin hoặc artifact quá lớn so với giới hạn của công cụ

README cho biết bản cài native của Codex đọc skill gốc, còn artifact sinh ra có thể tách body lớn thành file tham chiếu để phù hợp giới hạn 8 KB. Nếu một tuyến không nhận đủ nội dung, hãy xem Codex setup details và chọn đúng cách cài.

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

Các lớp đánh giá LLM và Monte Carlo là tùy chọn, cần dependency llm. Nếu đặt ANTHROPIC_API_KEY, model calls dùng key đó và tính phí vào tài khoản API; nếu không, chúng dùng đăng nhập Claude Code. Chỉ bật các lớp này khi bạn hiểu tài khoản nào đang chịu chi phí.

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

Nên dùng nếu bạn thường xuyên làm việc với công cụ lập trình AI và muốn có workflow sẵn cho Python, JavaScript, TypeScript, review, kiểm thử hoặc bảo mật. Cách viết một lần rồi tạo định dạng cho nhiều harness giúp giảm công sức duy trì khi nhóm đổi công cụ.

Repo cũng phù hợp với người muốn bắt đầu nhỏ. Bạn có thể cài một skill như python-testing-patterns, hoặc chọn một plugin như python-development thay vì cài cả catalog.

Giới hạn là cách cài không giống nhau giữa các công cụ. Cursor cần xem hướng dẫn riêng; Codex có khác biệt giữa source skill và artifact sinh; Pi cần extension subagent hoặc extension tương thích. Một số số liệu và tính năng của external plugin có thể có yêu cầu riêng, vì external plugin có giấy phép riêng.

README không đưa thông tin chung về hệ điều hành, GPU, quyền riêng tư dữ liệu hoặc chi phí của từng công cụ AI. Nếu doanh nghiệp có yêu cầu dữ liệu nghiêm ngặt, bạn cần kiểm tra chính sách của harness và model đang dùng trước khi đưa mã nguồn vào. Nếu bạn chỉ cần một prompt đơn giản hoặc không dùng công cụ nào được repo hỗ trợ, một bộ hướng dẫn nội bộ có thể phù hợp hơn.

3.9/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

Repo này có miễn phí không?

Repo dùng giấy phép MIT. Tuy nhiên, các external plugin có thể có giấy phép riêng, và README không nêu bảng giá cho các công cụ AI hoặc dịch vụ bên ngoài. Các model calls trong phần đánh giá có thể tính phí vào tài khoản API nếu bạn dùng `ANTHROPIC_API_KEY`.

Có cần GPU không?

README không nêu yêu cầu GPU. Tài liệu tập trung vào plugin, agent, skill, command và các công cụ harness như Claude Code, Codex CLI, Cursor, OpenCode, Antigravity CLI, GitHub Copilot và Pi.

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

README được cung cấp không nêu hệ điều hành được hỗ trợ. Tài liệu có các lệnh shell như `make`, `gh`, `uv` và `npx`, nên bạn cần kiểm tra cách cài tương ứng của công cụ trên môi trường mình dùng.

Có cần API key không?

Cài và dùng các component cơ bản không được README nêu là luôn cần API key. Riêng lớp đánh giá LLM dùng `ANTHROPIC_API_KEY` khi biến này được đặt; nếu không, nó dùng đăng nhập Claude Code.

Dữ liệu và mã nguồn có an toàn không?

README không cung cấp cam kết chung về quyền riêng tư hoặc cách xử lý dữ liệu. Bạn nên kiểm tra chính sách của harness và model trước khi đưa mã nguồn hoặc dữ liệu doanh nghiệp vào công cụ AI.

Có phải cài toàn bộ repo không?

Không. Bạn có thể cài plugin cụ thể, chẳng hạn `python-development`, hoặc cài riêng một skill bằng `gh skill` hay `npx skills`. Tuyến clone đầy đủ chủ yếu được README hướng dẫn cho OpenCode, Antigravity CLI, GitHub Copilot và Pi.

wshobson/agents khác gì một plugin riêng lẻ?

Repo là một catalog gồm khoảng 94 plugin, 202 agent, 185 skill và 105 command trong mã nguồn cục bộ. Nó còn có adapter để tạo định dạng cho nhiều harness, thay vì chỉ phục vụ một công cụ hoặc một workflow.

Chuyển nhanh tới mục

  1. I.wshobson/agents làm được gì
    1. A.Gom sẵn các workflow cho lập trình
    2. B.Dùng cùng nhiều công cụ AI
    3. C.Chọn agent chuyên môn cho từng việc
    4. D.Tải skill khi cần
    5. E.Tạo artifact và kiểm tra 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 tuyến cài đặt
    2. B.Cài plugin cho Claude Code
    3. C.Cài plugin cho Codex CLI
    4. D.Cài riêng một skill
    5. E.Clone repo cho các tuyến dùng Makefile
    6. F.Cài cho Cursor
    7. G.Sinh và kiểm tra artifact
  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 làm API quản lý đơn hàng
    2. B.Nhân viên văn phòng quản lý một dự án nội bộ
    3. C.Dev mới học kiểm thử Python
    4. D.Nhóm phát triển muốn kiểm tra bảo mật
  6. VI.Lỗi hay gặp và cách xử lý
    1. A.Chạy Makefile nhưng thiếu uv hoặc Python
    2. B.Dùng sai lệnh cho harness
    3. C.Cài skill nhưng mong có cả agent và command
    4. D.Plugin hoặc artifact quá lớn so với giới hạn của công cụ
    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ỏ.