Skills For Real Engineers
Mã nguồn mở bởi mattpocock
Skills For Real Engineers là bộ skill của Matt Pocock dành cho trợ lý lập trình AI như Claude Code, Codex, GitHub Copilot, Gemini CLI. Mỗi skill là một file hướng dẫn ngắn, gói một thói quen kỹ thuật (hỏi kỹ yêu cầu, viết test trước, gỡ lỗi theo từng bước, rà kiến trúc) để trợ lý làm theo.
Skills For Real Engineers dùng để làm gì?
- Bắt trợ lý hỏi lại chi tiết yêu cầu trước khi viết code bằng /grill-me hoặc /grill-with-docs
- Xây file thuật ngữ chung GLOSSARY.md và ghi quyết định thiết kế (ADR) ngay trong lúc trao đổi
- Cho trợ lý viết test trước rồi mới sửa code theo vòng đỏ, xanh, tái cấu trúc với /tdd
- Biến cuộc trao đổi thành spec và các ticket có thứ tự phụ thuộc, đẩy lên trình quản lý issue
- Rà codebase tìm chỗ nên gom lại thành module sâu bằng /improve-codebase-architecture
Giao diện
Ảnh và video lấy từ README của dự án trên GitHub, bản quyền thuộc nhóm phát triển.
Cần biết trước khi dùng
- Lưu ýKhông tìm thấy docker-compose hay Dockerfile ở thư mục gốc: chưa thể gắn nút Deploy tự động.
- Lưu ýDependency được khai báo theo khoảng phiên bản (ví dụ ">="), chưa tra lỗ hổng tự động được. Cần quét trên bản cài thật.
- Lưu ýTino chưa kiểm thử dự án này.
Kiểm tra tự động ngày 04/11/2026 từ dữ liệu GitHub, OSV.dev và docker-compose. Đây không phải chứng nhận bảo mật; Tino không phát triển hay bảo trì repo này.
Skills For Real Engineers là gì?
Trợ lý lập trình AI hay hỏng theo vài kiểu quen thuộc: làm sai ý người dùng, nói dài dòng vì không biết thuật ngữ của dự án, viết code không chạy vì thiếu vòng phản hồi, và làm codebase rối nhanh hơn. Bộ skill này nhắm vào từng kiểu lỗi đó. Theo README, các skill được viết nhỏ, dễ sửa, ghép với nhau được và không phụ thuộc model.
Skill chia làm hai nhóm theo người gọi. Nhóm do người dùng gọi (gõ lệnh như /grill-me, /to-spec, /implement, /triage) đóng vai điều phối. Nhóm do model gọi (tdd, diagnosing-bugs, code-review, domain-modeling…) chứa kỷ luật dùng lại được; trợ lý tự lấy ra khi việc đang làm phù hợp. Một skill người dùng gọi có thể dùng skill model gọi, nhưng không gọi một skill người dùng gọi khác.
Ngoài nhóm kỹ thuật còn có nhóm năng suất chung: handoff để nén cuộc trò chuyện thành tài liệu bàn giao cho agent khác, teach để học một chủ đề qua nhiều buổi, to-questionnaire để soạn bảng câu hỏi gửi người ra quyết định, writing-for-agents để viết tài liệu cho agent đọc.
Có hai cách cài. Cài dạng plugin thì skill tự cập nhật. Cài qua skills.sh thì file skill được chép vào dự án để bạn sửa, và phải tự cập nhật. README khuyên chỉ chọn một cách cho mỗi trợ lý, vì cài cả hai sẽ có mỗi skill hai lần. Sau khi cài, chạy /setup-matt-pocock-skills một lần cho mỗi repo để khai báo trình quản lý issue, nhãn phân loại và nơi lưu tài liệu.
Nên dùng khi
- Bạn dùng Claude Code, Codex hoặc Copilot hằng ngày và trợ lý hay làm lệch ý vì yêu cầu chưa rõ
- Dự án có nhiều thuật ngữ riêng và bạn muốn trợ lý dùng đúng tên gọi trong code lẫn trao đổi
- Bạn muốn trợ lý làm theo quy trình có test, có review thay vì sinh code một mạch
- Bạn cần chia một tính năng lớn thành spec và ticket có thứ tự trên GitHub, GitLab hoặc file cục bộ
Không nên dùng khi
- Bạn chỉ cần trợ lý trả lời nhanh vài câu; các buổi hỏi kỹ (grilling) tốn thời gian và token
- Bạn không muốn nội dung skill thay đổi mà chưa đọc lại: bản plugin tự cập nhật, nên hướng dẫn agent làm theo có thể đổi giữa các lần chạy
- Repo không cho phép trợ lý tạo issue, ghi file tài liệu hay commit: một số skill như to-spec, to-tickets, implement ghi lên trình quản lý issue và nhánh git
- Bạn cần một quy trình cố định có người chịu trách nhiệm hỗ trợ; đây là bộ skill cá nhân của tác giả, bạn tự điều chỉnh và tự chịu kết quả
Tính năng chính
- Nhóm Engineering: grill-with-docs, triage, to-spec, to-tickets, implement, implement-spec, wayfinder, retro, ask-matt
- Skill do model tự gọi: tdd, diagnosing-bugs, code-review, prototype, research, domain-modeling, codebase-design, pr, wizard
- Nhóm Productivity: grill-me, handoff, teach, to-questionnaire, wait-what, grilling, writing-for-agents
- improve-codebase-architecture xuất báo cáo HTML các chỗ nên gom module rồi hỏi kỹ phương án bạn chọn
- implement-spec chạy nhiều subagent song song trên các ticket sẵn sàng của cùng một spec
- code-review chạy hai trục song song: theo chuẩn code của repo và theo đúng spec gốc
- Cài được cho Claude Code, Codex, GitHub Copilot, Gemini CLI, Cursor, OpenCode, Windsurf và các agent khác qua skills.sh
- Giấy phép MIT
Cách cài đặt Skills For Real Engineers
-
Cài cho Claude Code
Cài dạng plugin, mặc định tự cập nhật.
claude plugin install mattpocock-skills@claude-plugins-official -
Cài cho Codex
Theo README, plugin tự cập nhật mỗi khi Codex khởi động.
codex plugin marketplace add mattpocock/skills codex plugin add mattpocock-skills@mattpocock -
Cài cho GitHub Copilot (CLI)
Sau đó thêm một lần khối extraKnownMarketplaces trỏ tới repo mattpocock/skills vào ~/.copilot/settings.json như README hướng dẫn. Trong VS Code, chạy lệnh Chat: Install Plugin From Source và nhập https://github.com/mattpocock/skills.
copilot plugin marketplace add mattpocock/skills copilot plugin install mattpocock-skills@mattpocock -
Cài cho Gemini CLI
Bản này không tự cập nhật; chạy lại cả hai lệnh khi muốn lấy bản mới.
gemini skills install https://github.com/mattpocock/skills.git --path skills/engineering gemini skills install https://github.com/mattpocock/skills.git --path skills/productivity -
Cài cho agent khác hoặc lấy file để tự sửa
Thay bằng tên trợ lý, bỏ -a để chọn trong danh sách. Khi được hỏi chọn skill nào, nhớ chọn setup-matt-pocock-skills. Cập nhật bằng npx skills@latest update.
npx skills@latest add mattpocock/skills -a <agent> # cursor, opencode, devin, windsurf, amp, pi; omit -a to choose -
Cấu hình cho từng repo
Gõ trong ô chat của trợ lý, một lần cho mỗi repo. Skill hỏi bạn dùng trình quản lý issue nào, nhãn phân loại ticket là gì và lưu tài liệu ở đâu.
/setup-matt-pocock-skills
Lệnh chép từ README của dự án. Đọc kỹ trước khi chạy và đối chiếu với README mới nhất, vì lệnh có thể đổi theo phiên bản.
Cấu hình quan trọng
| Mục | Ý nghĩa |
|---|---|
~/.copilot/settings.json | Với GitHub Copilot: thêm khối extraKnownMarketplaces trỏ tới mattpocock/skills, bật autoUpdate để plugin tự cập nhật |
GLOSSARY.md | File thuật ngữ chung của dự án do grill-with-docs và domain-modeling tạo và cập nhật |
Cách tích hợp và sử dụng
- Hỏi kỹ trước khi làmGõ /grill-me (việc không liên quan code) hoặc /grill-with-docs (việc code) rồi mô tả thay đổi. Trợ lý sẽ hỏi lần lượt từng nhánh quyết định cho tới khi rõ.
- Chốt spec và chia ticketGõ /to-spec để tổng hợp cuộc trao đổi thành spec trên trình quản lý issue, rồi /to-tickets để chia thành các ticket có ghi rõ ticket nào chặn ticket nào.
- Cho trợ lý làm theo specGõ /implement để làm theo spec hoặc ticket, có viết test trước tại các điểm đã thống nhất và chạy /code-review trước khi commit.
- Không biết dùng skill nàoGõ /ask-matt và mô tả tình huống; skill này chỉ ra skill hoặc quy trình phù hợp.
- Rà lại sau mỗi phiênGõ /retro để trợ lý gợi ý cải thiện môi trường làm việc (công cụ kiểm tra, chuẩn code, file hướng dẫn), xếp từ vấn đề nặng nhất.
Cập nhật và sao lưu
Bản plugin cho Claude Code, Codex và Copilot tự cập nhật. Bản Gemini CLI cập nhật bằng cách chạy lại hai lệnh cài. Bản cài qua skills.sh cập nhật bằng npx skills@latest update, chạy lại lệnh add để lấy skill mới.
Không có dữ liệu cần sao lưu ngoài các file skill đã sửa và tài liệu skill tạo ra trong repo (GLOSSARY.md, ADR, spec).
Câu hỏi thường gặp
Nên cài dạng plugin hay qua skills.sh?
Plugin tự cập nhật, hợp nếu bạn dùng nguyên bản. skills.sh chép file vào dự án để bạn sửa theo ý, đổi lại phải tự cập nhật. README khuyên chỉ chọn một cách cho mỗi trợ lý để không bị trùng skill.
Có phải chạy /setup-matt-pocock-skills không?
Có, một lần cho mỗi repo trước khi dùng nhóm skill kỹ thuật. Skill này lưu lựa chọn trình quản lý issue, nhãn phân loại và nơi lưu tài liệu để các skill như triage, to-spec, to-tickets biết ghi vào đâu.
Bộ skill có dùng được với model ngoài Claude không?
README ghi các skill dùng được với mọi model. Cách cài có sẵn cho Claude Code, Codex, GitHub Copilot, Gemini CLI, và các agent khác như Cursor, OpenCode, Windsurf qua skills.sh.
Skill do người dùng gọi và do model gọi khác nhau thế nào?
Skill người dùng gọi chỉ chạy khi bạn gõ lệnh, như /grill-me hay /implement. Skill model gọi, như tdd hay diagnosing-bugs, có thể do bạn gọi hoặc trợ lý tự dùng khi thấy việc đang làm phù hợp.
Ứng dụng liên quan
Miễn trừ trách nhiệm
Tino không phát triển, không sở hữu và không liên kết với Skills For Real Engineers hay nhóm phát triển mattpocock. Tên, logo và nhãn hiệu thuộc về chủ sở hữu tương ứng; việc nhắc tới chỉ để mô tả, không có nghĩa là dự án xác nhận hay hợp tác với Tino.
Skills For Real Engineers được phân phối theo giấy phép MIT của nhóm phát triển. Tino không bảo đảm về tính năng, bảo mật hay mức độ phù hợp của phần mềm; bạn tự chịu trách nhiệm khi cài đặt, cấu hình và sử dụng.
Lệnh cài và thông tin trên trang lấy từ tài liệu công khai của dự án tại thời điểm cập nhật và có thể đã thay đổi. Đọc tài liệu chính thức và sao lưu dữ liệu trước khi chạy trên máy chủ thật.
