Pstack là gì? Bộ skill giúp Claude Code, Cursor viết ít code hơn mà chắc hơn
Giao cho AI agent sửa một bug nhỏ, nó trả về 300 dòng thay đổi: sửa được bug, nhưng kèm một lớp tiện ích mới, vài chỗ try/catch cho "an toàn", và một đoạn comment dài giải thích những thứ code đã tự nói. Chạy được, nhưng review mệt hơn tự viết. Nhiều người gọi kiểu code này là "slop".
pstack là câu trả lời của Lauren Tan (poteto), kỹ sư ở Cursor, thành viên core team React, từng làm ở Meta và Netflix. Đây là bộ skill chị dùng hằng ngày để bắt agent làm việc như một kỹ sư kỹ tính: tái hiện bug trước khi sửa, chứng minh bằng chạy thật chứ không nói suông, và ưu tiên viết ít code hơn. Bộ skill công khai, giấy phép MIT, cài được cho Cursor lẫn Claude Code.
Mình đọc kỹ repo trước khi viết bài này. Dưới đây là pstack gồm những gì, chạy ra sao, cài thế nào, và khi nào nó không đáng dùng.
pstack khác một prompt "hãy code cẩn thận" ở đâu
Dặn agent "code cẩn thận, đừng viết thừa" thì nó đồng ý rồi quên sau vài lượt. pstack biến lời dặn đó thành quy trình cụ thể có từng bước, và agent phải đi đúng các bước đó:
| Dặn bằng lời | pstack |
|---|---|
| "Sửa bug này giúp mình" | Playbook sửa bug: tái hiện lỗi, tìm nguyên nhân gốc, sửa, chứng minh bằng kết quả chạy thật |
| "Đừng viết thừa" | Nguyên tắc "laziness protocol": ưu tiên xoá và thay đổi nhỏ nhất giải quyết được vấn đề |
| "Review kỹ vào" | Skill interrogate: nhiều model khác nhau cùng cố phá diff, chỉ giữ lỗi nào chạy ra được bằng chứng |
| "Xong thì báo" | Nguyên tắc "prove it works": kiểm trên chính thứ đã làm ra, không tin "build xanh là xong" |
Ý tưởng chính của tác giả: muốn chạy nhiều agent song song mà vẫn yên tâm, thì từng agent phải đủ kỹ để tin được trước đã.
Bên trong có gì
Gần 60 skill, chia làm ba nhóm.
1. Một lối vào chính: poteto-mode. Bạn gõ /poteto-mode kèm yêu cầu, nó đọc yêu cầu, chọn một trong 22 playbook phù hợp, chép các bước của playbook đó thành todo list, rồi tự gọi các skill khác khi bước nào cần. Một vài playbook:
| Playbook | Dùng khi |
|---|---|
| Investigation | Câu hỏi chỉ đọc: X chạy thế nào, vì sao Y được viết như vậy |
| Bug fix | Tái hiện lỗi, tìm nguyên nhân gốc, sửa kèm bằng chứng chạy thật |
| Perf | Có một chỗ chậm đo được, cải thiện so với số đo ban đầu |
| Feature | Tính năng mới, xây từ một cấu trúc dữ liệu được đặt tên rõ |
| Refactoring | Đổi cấu trúc code mà giữ nguyên hành vi |
| Prototype | Làm bản nháp để quyết định nhanh giữa vài hướng thiết kế |
| Babysit | Đưa một PR tới trạng thái merge được: conflict, review, CI |
| Autonomous run | Chạy một việc dài tới khi xong mà không dừng giữa chừng |
Ví dụ cách gõ (dịch từ README):
/poteto-mode PR này có bug: thanh cuộn tự trôi mỗi 750ms dù không làm gì.
Tái hiện trước, rồi sửa và kiểm chứng.
/poteto-mode list lớn mất 1-2 giây mới load dù đã virtualize.
Chạy CPU trace và cho mình biết vì sao.
2. Các skill dùng trực tiếp khi cần. Thường poteto-mode tự gọi, nhưng vài cái bạn sẽ muốn gõ tay:
| Skill | Làm gì |
|---|---|
how |
Giải thích một phần hệ thống chạy thế nào |
why |
Trả lời "vì sao code viết thế này" từ commit và thảo luận PR, ghi rõ chỗ nào là suy luận |
blast-radius |
Một thay đổi trông nhỏ có thể làm hỏng những gì, chứng minh bằng code chạy |
architect |
Chốt cách gọi, kiểu dữ liệu, cấu trúc module trước khi viết code vượt qua ranh giới hàm |
arena |
Cho nhiều agent cùng làm một việc song song, rồi lấy phần tốt nhất của từng bản |
swarm |
Chia việc cho nhiều agent theo từng phần, gom về một báo cáo |
interrogate |
Cho nhiều model cùng cố phá một diff, chỉ giữ lỗi chứng minh được |
tdd |
Viết test đỏ trước, rồi mới sửa |
benchmark-checklist |
Soát lại một con số benchmark trước khi tin hoặc báo cáo nó |
unslop |
Dọn những dấu hiệu "văn AI" trong phần chữ |
3. 24 skill nguyên tắc. Mỗi skill là một nguyên tắc ngắn, poteto-mode đọc mục lục của chúng mỗi khi bắt đầu việc. Vài nguyên tắc đáng đọc kể cả khi bạn không dùng pstack:
- Subtract before you add: dọn code chết, kiểm tra thừa trước, rồi mới xây lên nền gọn hơn.
- Fix root causes: lần mỗi triệu chứng về chỗ đầu tiên hệ thống sai và sửa ở đó. Một đoạn kiểm tra chặn lỗi chỉ được coi là bản sửa khi trạng thái nó xử lý là hợp lệ.
- Make operations idempotent: chạy lại bao nhiêu lần, kể cả sau khi lần trước chết giữa chừng, vẫn ra cùng một kết quả.
- Test behavior, not implementation: test kiểm thứ người dùng code nhìn thấy, để đổi phần bên trong không làm test đỏ oan.
- Boundary discipline: dồn phần kiểm tra dữ liệu về ranh giới hệ thống (API ngoài, cấu hình, input người dùng), bên trong thì tin kiểu dữ liệu.
Cài cho Claude Code: hai lựa chọn
pstack viết cho Cursor trước, nhưng có hai cách đưa vào Claude Code.
Bản chính thức từ repo của Cursor:
/plugin marketplace add cursor/plugins
/plugin install pstack@cursor-plugins
Trong Claude Code, tên lệnh có thêm tiền tố: /poteto-mode thành /pstack:poteto-mode. Bước nào cần tính năng chỉ Cursor mới có (như Bugbot, automations) sẽ được bỏ qua kèm một dòng ghi chú.
Bản port của cộng đồng pstack-claude (Michael Denyer, MIT):
/plugin marketplace add michael-denyer/pstack-claude
/plugin install pstack@pstack-claude
Khác biệt: bản chính thức để agent tự "dịch" tên khái niệm của Cursor sang Claude Code lúc chạy, còn bản port dịch sẵn trước khi cài, theo lời tác giả port là để đỡ tốn token và đỡ phụ thuộc vào việc agent dịch đúng. Bản port còn thêm một hook tự chuyển việc sang poteto-mode, cần Claude Code 2.1.292 trở lên, và có bản cho Codex, Copilot CLI, Pi.
| Bản chính thức | Bản port | |
|---|---|---|
| Nguồn | Repo của Cursor, cập nhật trực tiếp từ tác giả | Theo sát bản gốc, kèm vài thay đổi riêng được khai báo |
| Tên Cursor trong skill | Agent dịch lúc chạy | Dịch sẵn trước khi cài |
| Agent khác | Cursor, Claude Code | Claude Code, Codex, Copilot, Pi và vài agent khác |
Dù chọn bản nào, lưu ý: Claude Code tắt tự động cập nhật với marketplace bên thứ ba, nên plugin đứng yên ở bản bạn cài. Muốn bật thì vào /plugin, tab Marketplaces, chọn marketplace tương ứng, bật auto-update.
Cài xong, làm hai bước:
- Chạy
/pstack:setup-pstackđể chọn model cho từng vai trò. Với Claude Code, lựa chọn được ghi vào~/.claude/rules/pstack-models.md. - Dùng
/pstack:poteto-modecho việc gì cần làm kỹ.
Không biết nên dùng skill nào thì hỏi /pstack:poteto-help.
Với Cursor thì đơn giản hơn: gõ /add-plugin pstack, hoặc cài từ Cursor Marketplace. Một mẹo trong README: chọn poteto-mode từ menu / rồi bấm Option+Enter (Mac) hoặc Alt+Enter (Windows) thay vì Enter, nó thành chế độ làm việc giữ nguyên qua các lượt thay vì chỉ áp cho một tin nhắn.
Khi nào không nên dùng
pstack đổi tốc độ và chi phí lấy độ chắc chắn. Đáng cân nhắc trước khi bật cho mọi việc:
- Tốn token. Mặc định, việc code, viết lách và các quyết định giao cho Opus 5.5 ở mức suy luận xhigh. Một số skill chạy nhiều agent song song (
arena,swarm) hoặc cho nhiều model cùng review (nhưinterrogate; nhóm review mặc định gồm Fable 5.2, Opus 5.5, Gemini 4 Carbon). Kỹ hơn, nhưng mỗi việc tốn hơn hẳn một lượt chat thường. Fable 5.2 chỉ chạy khi bạn gọi tên hoặc khi Opus 5.5 thất bại hai lần cùng một việc, nên không phải lúc nào cũng dùng model đắt nhất. - Việc nhỏ thì thừa. Đổi tên một biến, sửa một dòng cấu hình thì không cần playbook có todo list và bước kiểm chứng.
- Bộ nguyên tắc rất "có quan điểm". Ví dụ nguyên tắc chuyển hết chỗ gọi rồi xoá API cũ trong cùng một đợt, không giữ lớp tương thích. Hợp với codebase mà team kiểm soát toàn bộ chỗ gọi, nhưng không hợp với thư viện public có người dùng bên ngoài. Đọc qua các nguyên tắc trước khi để agent áp hết vào project của bạn.
- Một vài thứ chỉ chạy trên Cursor. Trên Claude Code, các bước cần Bugbot hay automations bị bỏ qua.
Mẹo của mình: đừng bắt đầu bằng việc bật poteto-mode cho mọi thứ. Thử với đúng một bug bạn đang kẹt, so cách nó làm với cách bạn vẫn giao việc cho agent, rồi mới quyết định có dùng rộng hơn không.
Thử ngay: cài bản chính thức cho Claude Code, chạy /pstack:setup-pstack, rồi đưa cho /pstack:poteto-mode một bug thật đang mở trong project của bạn với câu "tái hiện trước, rồi sửa và kiểm chứng". Để ý xem nó có tái hiện được lỗi trước khi động vào code không. Đó là khác biệt dễ thấy nhất so với cách agent làm mặc định. Bạn đã thử pstack chưa, playbook nào hợp với bạn nhất? Comment chia sẻ với mọi người nhé.
Tài liệu để đọc thêm:
- Mã nguồn pstack và danh sách đầy đủ skill: github.com/cursor/plugins/tree/main/pstack
- Hướng dẫn làm việc thật đầu tiên với pstack: pstack guide
- Bản port cho Claude Code, Codex, Copilot, Pi: michael-denyer/pstack-claude
- Plugin trên Cursor Marketplace: cursor.com/marketplace/cursor/pstack
- Bài hướng dẫn của chính tác giả trên X: Lauren Tan (poteto)
- Bản đồ các skill trong pstack, do cộng đồng vẽ: pstack skill map
P.S. Nếu thấy poteto-mode nặng quá cho việc hằng ngày, PrimeKit, bộ skill mình tự làm, đi theo hướng ngược lại: skill primekit-router chọn quy trình nhỏ nhất đủ dùng trong các skill đã cài, và bỏ qua mọi thủ tục với việc đơn giản. Cài bằng npx @lovehlmmm/primekit init, rồi gõ /pk:primekit-router kèm việc cần làm khi chưa biết nên dùng skill nào. Việc nào thật sự cần làm kỹ thì pstack vẫn là lựa chọn đáng thử.
Series khác của mình
- Dùng AI hiệu quả trong công việc: kinh nghiệm thực chiến của dev: viết prompt đủ ngữ cảnh, bắt AI bịa API, giao việc cho agent, review code AI viết, debug, đọc codebase lạ, đóng gói quy trình thành skill.
- SQL thực chiến: Những bài học mình ước đã biết sớm hơn: viết query dễ đọc, đọc execution plan, lỗi NULL và N+1 không báo lỗi, schema và transaction, phân trang bằng con trỏ.
- Backend .NET thực chiến: những case hay gặp trên production: async/await làm treo API, HttpClient hết socket, EF Core kéo cả bảng, idempotency, outbox, caching, bảo mật API.
All rights reserved