Hướng dẫn đầy đủ về Skills For Real Engineers: Thư viện kỹ năng AI Agent của Matt Pocock

Skills For Real Engineers là gì

Một câu trả lời: Skills For Real Engineers (tên kho Matt Pocock Skills) là thư viện kỹ năng AI Agent dành cho kỹ sư chuyên nghiệp do Matt Pocock phát hành, bắt nguồn từ thực hành thư mục .claude hằng ngày của Matt Pocock.

Định vị của nó rất rõ ràng — không phải đồ chơi vibe coding, mà là bộ công cụ hằng ngày để “làm kỹ thuật thực thụ”. Tác giả cho biết các kỹ năng này được tạo ra để sửa những kiểu thất bại phổ biến mà anh gặp lặp lại trên các coding agent như Claude Code, Codex.

Khác biệt so với GSD, BMAD

Các phương pháp như GSD, BMAD, Spec-Kit cố gắng “nắm quyền quy trình”. Khi nắm quyền, chúng cũng lấy đi quyền kiểm soát của bạn, và khi quy trình gặp vấn đề sẽ rất khó xác định. Skills For Real Engineers đi theo hướng ngược lại:

• Nhỏ gọn: mỗi kỹ năng dùng độc lập, không xây khung tổng thể.
• Có thể kết hợp: chọn theo nhu cầu, cắt bớt tự do, thích ứng với kho riêng.
• Có thể tùy biến: kỹ năng chính là các tệp thông thường trong kho của bạn, không hiểu thì sửa.
• Không gắn mô hình: không ràng buộc model cụ thể, Claude, Codex, Cursor đều dùng được.
• Bản địa kỹ thuật: dựa trên các nguyên tắc kỹ thuật kinh điển như The Pragmatic Programmer, Domain-Driven Design, thay vì chồng chất prompt trick.

Định vị sản phẩm

Dành cho lập trình viên đã có thói quen kỹ thuật thực thụ: dùng phản hồi thực như kiểu tĩnh, kiểm thử tự động, red-green-refactor để ràng buộc Agent, tránh việc nó “bay mù”. Bản thân thư viện kỹ năng không cung cấp dịch vụ lưu trữ, cũng không quyết định kiến trúc thay bạn; nó chỉ cung cấp một bộ giao diện hội thoại và quy trình có thể tái sử dụng.

Tính năng chính

Kỹ năng được cung cấp cho Agent dưới dạng lệnh gạch chéo, chia thành vài nhóm.

Căn chỉnh yêu cầu

• /grill-me: căn chỉnh triệt để yêu cầu và các nhánh quyết định trước khi viết mã thông qua phiên hỏi cường độ cao; dùng được cả cho tình huống phi lập trình.
• /grill-with-docs: dựa trên grilling để cùng xây ngôn ngữ chung cho dự án và hồ sơ quyết định kiến trúc (ADR).
• /zoom-out: yêu cầu Agent bước ra khỏi mã cục bộ, đưa ra giải thích từ góc nhìn tổng thể hệ thống.

Phát triển và kiểm chứng

• /tdd: thúc đẩy Agent thực hiện vòng red-green-refactor, xây tính năng hoặc sửa lỗi theo từng lát cắt dọc.
• /diagnose: vòng chẩn đoán chuẩn hóa — tái hiện → tối giản → giả thuyết → chèn mã đo → sửa → kiểm thử hồi quy.
• /prototype: nhanh chóng xây nguyên mẫu terminal chạy được hoặc nhiều biến thể UI để xác nhận thiết kế.

Nhiệm vụ và lập kế hoạch

• /triage: phân cấp và điều phối Issue dựa trên state machine, hỗ trợ từ vựng nhãn tùy chỉnh.
• /to-prd: tự động tổng hợp ngữ cảnh hội thoại hiện tại thành PRD và gửi lên GitHub Issue.
• /to-issues: chia kế hoạch hoặc PRD thành các nhiệm vụ lát cắt dọc có thể nhận riêng.

Kiến trúc và cộng tác

• /improve-codebase-architecture: dựa trên CONTEXT.md và ADR để nhận diện cơ hội đào sâu module, xử lý “bùn kiến trúc”.
• /caveman: chế độ giao tiếp nén cực đoan, giảm khoảng 75% lượng token tiêu thụ trong khi vẫn giữ độ chính xác kỹ thuật.
• /handoff: nén phiên hiện tại thành tài liệu bàn giao, giúp Agent khác tiếp tục liền mạch.
• /teach: dùng thư mục hiện tại làm không gian dạy học có trạng thái, dạy kỹ năng hoặc khái niệm mới qua nhiều phiên.
• /write-a-skill: tạo kỹ năng mới theo cấu trúc chuẩn, hỗ trợ tiết lộ dần dần và đóng gói tài nguyên.

Cơ chế ngôn ngữ chung

Dùng CONTEXT.md để xây dựng hệ thuật ngữ của dự án là chiêu được tác giả coi trọng nhất trong bộ kỹ năng này. Điều tác giả quan sát thấy là: Agent thường bị ném thẳng vào dự án, vừa làm vừa đoán biệt ngữ ngành, nên việc lẽ ra chỉ cần 1 từ để diễn đạt lại tốn tới 20 từ.

Ví dụ, thay vì viết “một lesson bên trong một section của khóa học bị made real”, hãy viết “có vấn đề với materialization cascade”: một câu có thể tiết kiệm rất nhiều chi phí giải thích, và sự cô đọng này còn cộng dồn qua từng phiên. Ngôn ngữ chung còn mang lại: tên biến, hàm, tệp nhất quán; codebase dễ điều hướng hơn cho Agent; và Agent tốn ít token hơn khi suy nghĩ.

Cách sử dụng Skills For Real Engineers

Có hai đường dẫn bắt đầu, ứng với hai triết lý; bạn chỉ nên chọn một.

Đường dẫn 1: Plugin Claude Code

• Toàn bộ kỹ năng được cài dưới dạng gói chỉ đọc được quản lý, khi tác giả phát hành là tự cập nhật, tương đương “đăng ký” thay vì fork.
• Nó đã có trên marketplace chính thức của Claude Code, không cần thêm nguồn trước, bản cập nhật tự đến.
• Plugin Codex bản địa đang trong lộ trình (xem .agents/adr/0002-ship-as-a-claude-code-plugin.md).

Đường dẫn 2: Trình cài đặt skills

Chạy npx skills@latest add mattpocock/skills, chọn Agent mục tiêu và đánh dấu /setup-matt-pocock-skills. Trình cài đặt cho phép bạn tự chọn kỹ năng và chọn cài lên những coding agent nào; kỹ năng sẽ được ghi vào kho của bạn dưới dạng tệp thông thường, do bạn sở hữu và có thể chỉnh sửa, không tự cập nhật ngầm; khi cần, dùng npx skills update để kéo thay đổi mới nhất.

Lưu ý: cài đồng thời cả hai đường dẫn sẽ khiến mỗi kỹ năng xuất hiện hai bản.

Khởi tạo và nhịp làm việc hằng ngày

1. Chạy một lần /setup-matt-pocock-skills trong Agent, mỗi kho một lần. Nó sẽ hỏi bạn: dùng trình theo dõi Issue nào (GitHub, Linear hoặc tệp cục bộ); khi triage sẽ gắn nhãn gì (/triage phụ thuộc các nhãn này); lưu tài liệu được tạo ra vào thư mục nào.
2. Trước mỗi thay đổi, dùng /grill-me hoặc /grill-with-docs để căn chỉnh yêu cầu.
3. Trong quá trình phát triển, dùng /tdd để đảm bảo chất lượng.
4. Khi gặp bug, dùng /diagnose để bắt đầu chẩn đoán chuẩn hóa.
5. Về bảo trì kiến trúc, định kỳ chạy /improve-codebase-architecture để ngăn mã hư hỏng dần.

Toàn bộ cài đặt và cấu hình mất khoảng 30 giây, hỗ trợ GitHub, Linear hoặc tệp cục bộ làm trình theo dõi Issue.

Tình huống phù hợp

• Căn chỉnh yêu cầu và lập kế hoạch: trước khi khởi động dự án hoặc thay đổi tính năng, dùng /grill-me hoặc /grill-with-docs để truy vấn cường độ cao cùng Agent, đảm bảo hai bên hoàn toàn thống nhất về yêu cầu, nhánh quyết định và thuật ngữ miền.
• Phát triển theo kiểm thử: khi cần đảm bảo chất lượng mã, dùng /tdd để Agent thực hiện vòng red-green-refactor, xây tính năng hoặc sửa lỗi theo lát cắt dọc, để mỗi thay đổi đều có kiểm thử tự động bảo vệ.
• Chẩn đoán bug phức tạp: khi gặp suy giảm hiệu năng khó tái hiện hoặc lỗi logic, dùng /diagnose để đi trọn vòng chẩn đoán.
• Quản trị kiến trúc liên tục: trên codebase lớn, bảo trì lâu dài, định kỳ chạy /improve-codebase-architecture, dựa trên CONTEXT.md và ADR để nhận diện cơ hội đào sâu module, tránh việc Agent đẩy nhanh sự hư hỏng.
• Cộng tác xuyên phiên: dùng /handoff để nén phiên, dùng /caveman để giảm token, phù hợp nhiệm vụ dài và nhiều người, nhiều Agent tiếp sức.

Ưu điểm

• Nhẹ và có thể kết hợp: từ chối khung nặng, mỗi kỹ năng dùng độc lập, có thể cắt bớt tự do.
• Không gắn mô hình: Claude, Codex, Cursor đều dùng được.
• Bản địa kỹ thuật: xây trên các nguyên tắc kỹ thuật kinh điển, không phải prompt trick.
• Cơ chế ngôn ngữ chung: CONTEXT.md giảm rõ rệt chi phí giao tiếp và token tiêu thụ của Agent.
• Vòng phản hồi: nhấn mạnh phản hồi thực như kiểu tĩnh, kiểm thử tự động, red-green-refactor.
• Dễ tùy biến: theo đường dẫn skills, kỹ năng là tệp có thể chỉnh sửa trong kho của bạn.

Hạn chế

• Đây là một bộ kỹ năng, không phải trình quản lý quy trình đầu cuối; nhóm không có kỷ luật ngôn ngữ chung và ADR cần tự duy trì CONTEXT.md cùng hồ sơ quyết định.
• Hệ thống nhãn của /triage phụ thuộc cấu hình lúc khởi tạo; cấu hình không phù hợp sẽ ảnh hưởng hiệu quả phân cấp.
• Hai đường dẫn cài đặt loại trừ lẫn nhau; cài lẫn sẽ tạo ra kỹ năng trùng lặp.
• Plugin Codex bản địa còn trong lộ trình, người dùng Codex hiện dùng đường dẫn cài tệp kỹ năng.
• Phạm vi hỗ trợ cụ thể, chi tiết lệnh và nhịp cập nhật có thể thay đổi.

Lưu ý kiểm chứng giá và tính khả dụng

Bảng dữ kiện lần này không cung cấp thông tin giá, phí đăng ký hay điều khoản cấp phép, nên không suy đoán. Việc có thu phí hay không, phương thức cấp phép, kênh cài đặt khả dụng và trạng thái phiên bản mới nhất, hãy kiểm tra trực tiếp tại trang chính thức https://github.com/mattpocock/skills và trang marketplace plugin chính thức của Agent bạn đang dùng trước khi quyết định.

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

Nó có gắn với một mô hình nào không?

Không. Cách diễn đạt chính thức là không gắn mô hình, Claude, Codex, Cursor đều dùng được.

Cài xong là dùng được ngay không?

Còn cần khởi tạo. Hãy chạy một lần /setup-matt-pocock-skills trong Agent, cấu hình trình theo dõi Issue, nhãn phân cấp và thư mục tài liệu; sau đó các kỹ năng như /triage mới làm việc theo thỏa thuận của bạn.

Tôi nên chọn plugin hay trình cài đặt?

Muốn theo bản cập nhật của tác giả và chấp nhận gói chỉ đọc được quản lý, hãy chọn plugin Claude Code; muốn sở hữu và tùy biến tệp, tự kiểm soát thời điểm cập nhật, dùng npx skills@latest add mattpocock/skills. Đừng cài cả hai cùng lúc.

Nó có xung đột với GSD, BMAD không?

Ý định thiết kế của tác giả là đưa ra một lối tư duy thay thế: GSD, BMAD, Spec-Kit giúp bằng cách nắm quyền quy trình, vì thế lấy đi quyền kiểm soát và khiến vấn đề trong quy trình khó giải quyết; bộ kỹ năng này chọn hướng nhỏ gọn, có thể kết hợp, có thể tùy biến. Việc có kết hợp hay không tùy thuộc kỷ luật của nhóm bạn.

Nên thử kỹ năng nào trước tiên?

Tác giả cho rằng /grill-with-docs có thể là kỹ thuật mạnh nhất trong cả kho: nó vừa là phiên truy vấn, vừa giúp bạn cùng AI xây ngôn ngữ chung, đồng thời ghi lại các quyết định khó giải thích vào ADR.

Giải pháp thay thế

• GSD, BMAD, Spec-Kit: các khung nặng cố nắm quyền quy trình phát triển, ít quyền kiểm soát hơn và vấn đề quy trình khó xác định hơn.
• Agent Skill mã nguồn mở của Eze (Nhất Trạch): tập trung “suy nghĩ cách lên mạng”.
• Khung kỹ năng agentic và plugin phương pháp phát triển phần mềm mã nguồn mở của Jesse Vincent.
• Skill thiết kế AI mã nguồn mở dành riêng cho trợ lý lập trình AI.
• Cách làm chung: tự duy trì một bộ tệp kỹ năng .claude hoặc cấp dự án rồi ghép theo thói quen nhóm.

Tài liệu gốc

• Trang chính thức và kho sản phẩm: https://github.com/mattpocock/skills

Nếu bạn muốn theo dõi các thay đổi của bộ kỹ năng cũng như những kỹ năng mới tác giả tạo ra, có thể tham gia newsletter có khoảng 60.000 lập trình viên đăng ký của anh.