compound-engineering-plugin: AI nhớ bài học sau mỗi lần code — hướng dẫn cài và dùng
Bài này là một góc nhìn khác về EveryInc/compound-engineering-plugin — 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: compound-engineering-plugin: chuẩn hoá quy trình code với AI — hướng dẫn cài đặt và dùng →

Tóm tắt nhanh
compound-engineering-plugin là plugin gồm 38 skill dành cho AI coding agent như Claude Code, Cursor và Codex. Nó bắt AI làm việc theo vòng lặp brainstorm, plan, work, review, compound, để kiến thức của lần làm trước được ghi lại cho lần sau. Cài chỉ cần một đến hai lệnh trong công cụ bạn đang dùng, không phải biên dịch gì.
Compound Engineering là một plugin gồm 38 skill dành cho các AI coding agent như Claude Code, Cursor, Codex. Skill ở đây là những quy trình làm việc đóng gói sẵn, bạn gõ một lệnh dạng /ten-skill là AI chạy theo quy trình đó. Repo hiện có khoảng 26.000 sao và khoảng 2.067 fork, giấy phép MIT, do Every phát hành.
Vấn đề mà repo giải quyết rất quen: AI viết code nhanh, nhưng mỗi lần làm là một lần "mất trí nhớ". Bài học của lần sửa lỗi trước không ai ghi lại, lần sau AI lại mắc đúng lỗi cũ. Plugin này chia công việc thành một vòng lặp cố định và bắt bước cuối là ghi lại những gì đã học vào thư mục trong dự án, để lần sau AI đọc lại trước khi bắt tay làm.
Ai nên dùng? Lập trình viên mới hoặc đã quen dùng AI viết code, và những người làm sản phẩm, kinh doanh muốn AI làm có kế hoạch thay vì code ẩu từ một câu lệnh mơ hồ. Điểm đáng giá nhất là tính "cộng dồn": làm càng nhiều, kho ghi chú của dự án càng dày, AI càng ít phải đoán.
EveryInc/compound-engineering-plugin
Bộ 38 skill cho AI coding agent (Claude Code, Cursor, Codex…) chạy theo vòng lặp: lên ý tưởng, lập kế hoạch, code, review, rồi ghi lại bài học.
I.Compound Engineering làm được gì
Triết lý của repo gói trong một câu: mỗi đơn vị công việc nên làm cho đơn vị sau dễ hơn, không khó hơn. Tác giả đề xuất dành khoảng 80% công sức cho lập kế hoạch và review, 20% cho phần viết code. Sáu bước cốt lõi, mỗi bước là một skill:
/ce-brainstormhỏi đáp tương tác để bạn nghĩ rõ tính năng hay vấn đề, rồi viết ra bản yêu cầu. Lợi ích: AI hỏi lại những chỗ bạn chưa nghĩ tới, thay vì đoán./ce-planbiến ý tưởng hoặc bản yêu cầu thành kế hoạch đủ chi tiết để bắt tay làm. Cùng một tệp kế hoạch được mở rộng dần từ yêu cầu sang kế hoạch triển khai./ce-workthực thi kế hoạch đã sẵn sàng, đồng thời giữ các bước kiểm tra, commit và đưa code lên./ce-simplify-codegọn lại đoạn code vừa viết, bỏ test và comment thừa trước khi review./ce-code-reviewreview nhiều agent đối chiếu với kế hoạch trước khi gộp code. Mặc định nó chỉ báo cáo; việc áp dụng thay đổi trên máy bạn là thao tác chọn riêng./ce-compoundghi bài học vào thư mụcdocs/solutions/để vòng sau khởi đầu thông minh hơn. Đây là bước làm nên tên của repo.
Ngoài vòng lặp chính, repo còn nhiều skill dùng khi cần:
/lfgchạy cả quy trình không cần bạn can thiệp. Nó đi từ kế hoạch, làm, gọn code, review và sửa, ghi bài học, test trên trình duyệt, rồi commit. Nếu có git remote, nó push, mở PR và theo dõi CI; nó không tự merge trừ khi bạn cho phép./ce-debugbắt đầu từ một lỗi thay vì một tính năng./ce-ideatedùng khi bạn chưa biết nên làm gì./ce-explainhỏi một hành vi trong code hoạt động thế nào và vì sao nó tồn tại, trước khi bạn sửa./ce-povxin một khuyến nghị. Nói "oracle this" thì có thêm ý kiến độc lập từ các mô hình khác.- Nhóm Git
ce-commit,ce-commit-push-pr,ce-babysit-pr,ce-resolve-pr-feedback,ce-worktree. - Nhóm kiểm thử và hoàn thiện
ce-test-browser,ce-test-xcode,ce-polish,ce-dogfood. /ce-helphỏi khi bạn không biết nên chạy skill nào, hoặc bước tiếp theo là gì.
Plugin chạy trên 14 agent host, gồm Claude Code, Cursor, Codex, Kimi Code CLI, Cline, Grok Build CLI, Devin CLI, GitHub Copilot, Factory Droid, Qwen Code, OpenCode, Pi, oh-my-pi và Antigravity CLI.
Phần README tôi có được còn nhắc một tính năng thử nghiệm tên là Compound Packs. Đó là các thư mục quy tắc dùng chung cho nhiều repo trong một tổ chức, để lập kế hoạch bám theo và review kiểm tra theo. Người mới chưa cần quan tâm phần này.
II.Cần chuẩn bị gì
Tư liệu tôi có chỉ nói những điều sau:
- Một công cụ AI coding agent mà plugin hỗ trợ: Claude Code, Cursor, Codex hoặc một trong các công cụ kể trên. Bạn cài plugin vào công cụ đó, không cài riêng.
- Một dự án (thư mục code) để chạy các skill. README hướng dẫn chạy
/ce-setup"trong bất kỳ dự án nào" sau khi cài. - Với Codex CLI, cần có sẵn lệnh
codex. Với Cline cần cógitđể clone repo. Với Grok Build, Devin, Factory Droid, Qwen Code, Pi, Copilot CLI thì cần sẵn lệnh tương ứng (grok,devin,droid,qwen,pi,copilot). - Với Cursor và Grok Bot: Grok Bot dùng chung tài khoản Cursor và thư viện plugin của Cursor, không có đăng nhập riêng.
Phiên bản Node, Python, yêu cầu phần cứng hay API key riêng của plugin: phần README tôi đọc được không nói. Repo có package.json và bun.lock, nhưng đó là phần dành cho người phát triển plugin. Người dùng cuối cài qua marketplace của công cụ AI nên không cần đụng tới. Bạn vẫn cần tài khoản hoặc gói dùng của chính công cụ AI bạn chọn, và chi phí tính theo công cụ đó.
III.Cài đặt từng bước
- Chọn công cụXác định bạn dùng Claude Code, Cursor hay Codex
- Thêm marketplaceCho công cụ biết nơi lấy plugin (Claude Code, Codex CLI)
- Cài pluginCài compound-engineering vào công cụ
- Khởi động lạiMở phiên mới hoặc restart để skill được nạp
- Chạy /ce-setupThiết lập trong dự án của bạn
README chia cách cài theo từng công cụ. Bạn chỉ làm đúng phần của công cụ mình đang dùng.
A.Cài trong Claude Code
Mở Claude Code trong dự án của bạn, rồi gõ lần lượt hai lệnh sau vào khung chat (đây là lệnh gạch chéo của Claude Code, không phải lệnh terminal thường):
/plugin marketplace add EveryInc/compound-engineering-plugin
/plugin install compound-engineeringLệnh đầu thêm "kho" plugin của Every vào Claude Code. Lệnh sau cài plugin có tên compound-engineering từ kho đó.
Nếu bạn đã cài plugin này từ trước, README cảnh báo: hãy làm mới marketplace TRƯỚC khi cập nhật. Chỉ chạy `/plugin update` thì vẫn ở phiên bản cũ. README gọi phần này là "Upgrading", bạn xem đúng mục đó trong repo để làm theo.
B.Cài trong Cursor
Trong khung chat Cursor Agent, gõ:
/add-plugin compound-engineeringBạn cũng có thể tìm "compound engineering" trong marketplace plugin của Cursor. Nếu dùng Grok Bot, hãy cài trên tài khoản Cursor theo cách này, rồi Grok Bot tự dùng được. README dặn rõ: đừng chạy /add-plugin trong chat của Grok Bot, và đừng clone repo vào máy Grok Bot.
C.Cài trong Codex App
Compound Engineering chưa nằm trong marketplace có sẵn của Codex, nên bạn thêm nó như một marketplace tự chọn:
- Trong Codex app, mở Plugins ở thanh bên.
- Bấm mũi tên cạnh Create, chọn Add marketplace.
- Điền: Source là
EveryInc/compound-engineering-plugin, Git ref làmain, Sparse paths để trống. - Bấm Add marketplace.
- Tìm Compound Engineering, cài compound-engineering-plugin, rồi khởi động lại Codex.
README nói bản cài này tự đủ, không cần cài thêm agent nào khác.
D.Cài trong Codex CLI
Mở terminal (PowerShell hoặc Terminal đều được) rồi đăng ký marketplace:
codex plugin marketplace add EveryInc/compound-engineering-pluginSau đó cài plugin:
codex plugin add compound-engineering@compound-engineering-pluginCách khác: chạy codex, gõ /plugins, tìm marketplace Compound Engineering, chọn plugin compound-engineering rồi bấm Install. Xong thì khởi động lại Codex.
Nếu bạn dùng profile Codex không mặc định, mọi bước phải chạy cùng một CODEX_HOME. Ví dụ cho profile tên work:
CODEX_HOME="$HOME/.codex/profiles/work" codex plugin marketplace add EveryInc/compound-engineering-plugin
CODEX_HOME="$HOME/.codex/profiles/work" codex plugin add compound-engineering@compound-engineering-pluginBước đầu chỉ làm plugin "có sẵn"; bước thứ hai mới thực sự bật skill cho profile đó.
E.Cài trên các công cụ khác
README còn hướng dẫn riêng cho nhiều công cụ khác. Vài ví dụ đúng theo README:
grok plugin install EveryInc/compound-engineering-plugindevin plugins install EveryInc/compound-engineering-pluginqwen extensions install EveryInc/compound-engineering-plugin:compound-engineeringpi install git:github.com/EveryInc/compound-engineering-pluginVới Cline, bạn bật Settings -> Features -> Enable Skills trong tiện ích Cline, rồi chạy:
git clone https://github.com/EveryInc/compound-engineering-plugin
./compound-engineering-plugin/.cline/scripts/install-skills.sh --globalLệnh đầu tải mã về máy, lệnh sau liên kết các skill vào Cline cho toàn máy. Muốn cài riêng cho một dự án, dùng --project thay cho --global. Chạy script .sh trên Windows có thể cần Git Bash, bạn xem thêm .cline/INSTALL.md trong repo.
Với OpenCode, thêm vào opencode.json (khóa là plugin số ít trên OpenCode 1.x):
{
"plugins": ["compound-engineering@git+https://github.com/EveryInc/compound-engineering-plugin.git"]
}Với GitHub Copilot, Factory Droid, Kimi Code CLI, Antigravity CLI: xem mục "More Install Options" trong README của repo. Phần README tôi có bị cắt giữa chừng, nên tôi không chép lệnh cho các mục chưa đọc được.
F.Chạy thiết lập đầu tiên
Mở dự án của bạn trong công cụ AI và gõ:
/ce-setupTheo README, lệnh này báo cáo những khả năng công cụ tùy chọn, tạo tệp .compound-engineering/config.yaml trong repo nếu chưa có, làm mới tệp ví dụ và thêm bản cấu hình cá nhân vào gitignore. Trong Codex, bạn gõ $ce-setup thay vì /ce-setup, vì Codex gọi skill bằng dấu $.
IV.Kiểm tra đã chạy được chưa
Cách đơn giản nhất: sau khi cài và khởi động lại, gõ /ce-help (hoặc $ce-help trong Codex). Nếu skill hiện ra và AI trả lời hướng dẫn, plugin đã được nạp. Tiếp theo chạy /ce-setup trong một dự án; nếu nó báo cáo tình trạng và tạo tệp .compound-engineering/config.yaml, bạn đã sẵn sàng.
Với Devin CLI, README có sẵn lệnh kiểm tra:
devin plugins list
devin plugins info compound-engineeringVới Devin, skill hiện ra dạng lệnh /compound-engineering:<tên-skill> và chỉ xuất hiện sau khi bạn mở phiên mới. README không mô tả lệnh kiểm tra riêng cho Claude Code ngoài việc thử gọi skill như trên.
V.Dùng vào việc thật
A.Thêm một tính năng nhỏ nhưng làm cho đàng hoàng
Bạn là lập trình viên mới trong một công ty bán hàng online, được giao "làm cho việc thử lại khi tác vụ nền thất bại an toàn hơn". Thay vì bảo AI "sửa đi", bạn chạy đúng vòng lặp mà README đưa ra:
/ce-brainstorm make background job retries safer
/ce-plan
/ce-work
/ce-simplify-code
/ce-code-review
/ce-compoundBước đầu AI hỏi bạn từng câu để chốt yêu cầu. /ce-plan biến yêu cầu thành kế hoạch, /ce-work làm theo kế hoạch, hai bước sau gọn và review, cuối cùng /ce-compound ghi bài học vào docs/solutions/. Kết quả là code đã review cùng một ghi chú mà lần sau AI sẽ đọc.
Chạy lần một là dạy. Chạy lần hai là nhớ.
Ông T
B.Giao nguyên một tính năng cho AI chạy tự động
Bạn là người làm sản phẩm có biết chút code, đã có ý tưởng rõ và muốn AI làm hết. README gợi ý chạy brainstorm trước để AI có yêu cầu thật, rồi gọi /lfg:
/ce-brainstorm describe the feature
/lfg/lfg tự đi qua các bước: làm theo kế hoạch, gọn code, review và áp dụng sửa, ghi bài học, test trình duyệt, commit. Có git remote thì nó push, mở PR và theo dõi CI với số lần sửa có giới hạn. Nó không tự merge nếu bạn không cho phép, và có thể dừng với việc còn dang dở nếu hết số lần sửa. Bạn nhận lại một PR để xem, không phải một khối code chưa ai kiểm tra.
C.Bắt đầu từ một lỗi
Khách phản ánh trang thanh toán thỉnh thoảng bị lỗi. Bạn không cần soạn kế hoạch tính năng, chỉ cần gọi skill dành cho lỗi:
/ce-debugREADME mô tả /ce-debug là lối vào khi bạn bắt đầu từ một lỗi. /lfg cũng biết đi đường ce-debug khi nguồn việc là một báo cáo lỗi. Sau khi sửa xong, chạy /ce-compound để lỗi đó không bị "khám phá lại" lần nữa.
D.Hiểu code trước khi đụng vào
Bạn mới vào dự án và sợ sửa nhầm. README gợi ý hỏi ce-explain về hành vi liên quan: nó chạy thế nào và vì sao tồn tại. Cần một ý kiến thì dùng ce-pov, nói "oracle this" để nhận thêm ý kiến độc lập từ các mô hình khác. Không biết chạy skill nào thì hỏi /ce-help. Bạn nhận lại phần giải thích để ra quyết định, trước khi viết dòng code nào.
VI.Lỗi hay gặp và cách xử lý
- Cập nhật xong vẫn thấy bản cũ. README nêu rõ: chạy một mình
/plugin updatesẽ giữ bạn ở phiên bản cũ. Cách xử lý: làm mới marketplace trước rồi mới cập nhật, theo mục Upgrading trong README. - Cài xong mà không thấy skill. Plugin được nạp khi phiên bắt đầu. README dặn khởi động lại Codex, chạy
/reloadhoặc mở phiên mới với Kimi, mở phiên mới với Devin và Cline. Hãy thử đóng và mở lại công cụ. - Gõ
/ce-plantrong Codex không chạy. Codex gọi skill bằng dấu$, ví dụ$ce-planvà$lfg. Riêng/goalvẫn là lệnh có sẵn của Codex. - Dùng profile Codex khác mà cài xong vẫn không có. Có thể bạn đăng ký marketplace ở một
CODEX_HOMEcòn cài plugin ởCODEX_HOMEkhác. Chạy mọi bước cùng mộtCODEX_HOMEnhư ví dụ ở trên, và nhớ phải chạy bướccodex plugin addthì skill mới bật. - Devin hỏi quyền liên tục. Một số skill khai báo tên công cụ kiểu Claude (như
Bash) mà Devin không ánh xạ được. Skill vẫn chạy, chỉ là một số thao tác sẽ hỏi bạn trước thay vì tự chạy. Đây là hành vi bình thường; chi tiết ởdocs/specs/devin.md.
Với `/lfg`, AI có thể commit, push và mở PR thay bạn. Hãy thử trên dự án nhỏ hoặc nhánh riêng trước, và chỉ cho phép merge khi bạn thật sự muốn. Nhớ rằng chi phí dùng AI tính theo gói của công cụ bạn chọn; các vòng review nhiều agent có thể tốn hơn một câu hỏi thông thường.
VII.Có nên dùng không
Điểm mạnh. Quy trình rõ ràng, dễ nhớ (brainstorm, plan, work, simplify, review, compound). Kiến thức được ghi vào chính repo của bạn nên cả đội và các lần sau đều hưởng lợi. Chạy trên 14 công cụ nên bạn không bị khóa vào một nơi. Giấy phép MIT, repo có người duy trì và còn cập nhật trong vài tháng gần đây.
Giới hạn. Đây không phải phần mềm chạy độc lập mà là bộ quy trình cho AI, nên bạn vẫn cần một công cụ AI coding agent và tự chịu chi phí của nó. Bộ skill khá lớn: 38 skill, nên người mới có thể thấy ngợp lúc đầu. Hãy bắt đầu với sáu lệnh cốt lõi và /ce-help. Với việc rất nhỏ (sửa một dòng chữ), cả vòng lặp này là thừa. Một số phần như Compound Packs còn được README ghi là thử nghiệm.
Khi nào chọn cách khác. Nếu bạn chỉ cần AI làm nhanh một việc lẻ và không có ý định ghi lại bài học, hãy cứ chat thường. Nếu bạn không viết code hay làm sản phẩm phần mềm, plugin này không dành cho bạn. Nếu công cụ của bạn không nằm trong danh sách hỗ trợ, README chưa nói gì thêm.
Tóm lại, nếu bạn đã dùng AI để code đều đặn và thấy mình cứ phải nhắc lại cùng một bài học, repo này đáng thử vì nó giải quyết đúng chỗ đó.
Câu hỏi thường gặp
Compound Engineering có miễn phí không?
Repo dùng giấy phép MIT nên bạn dùng và sửa tự do. Chi phí đáng kể là của công cụ AI bạn chạy plugin trên đó (Claude Code, Cursor, Codex…), README không nói gì thêm về giá của các công cụ đó.
Plugin này chạy trên công cụ nào?
README nói nó chạy trên 14 agent host, gồm Claude Code, Cursor, Codex, Kimi Code CLI, Cline, Grok Build CLI, Devin CLI, GitHub Copilot, Factory Droid, Qwen Code, OpenCode, Pi, oh-my-pi và Antigravity CLI. Mỗi công cụ có cách cài riêng, đều có lệnh mẫu trong README.
Tôi cần GPU hay cấu hình máy mạnh không?
Tư liệu README tôi có không nhắc yêu cầu phần cứng nào. Plugin là bộ skill chạy trong công cụ AI của bạn, nên phần nặng do công cụ đó xử lý.
Dùng được trên Windows không?
README không nêu riêng hệ điều hành. Các lệnh cài qua Claude Code, Cursor, Codex App đều là lệnh trong ứng dụng. Riêng cách cài Cline dùng script .sh, trên Windows bạn có thể cần Git Bash, và nên xem .cline/INSTALL.md trong repo.
Dữ liệu và code của tôi có an toàn không?
README tôi có chưa nói rõ về việc này. Repo có các tệp PRIVACY.md và SECURITY.md, bạn nên đọc trước khi dùng cho dự án nhạy cảm. Lưu ý /lfg có thể commit, push và mở PR, nên hãy thử trên dự án nhỏ trước.
Chạy lệnh gạch chéo như /ce-plan trong Codex thế nào?
Trong Codex, bạn gọi skill bằng dấu $, ví dụ $ce-plan và $lfg. Trong oh-my-pi, với skill chỉ gọi thủ công hoặc ẩn thì dùng dạng /skill:<tên>, ví dụ /skill:ce-polish.
Folder docs/solutions/ dùng để làm gì và đổi được không?
Đó là nơi /ce-compound ghi bài học để vòng sau đọc lại, còn docs/plans/ là nơi để kế hoạch. Đây là mặc định; nếu thư mục docs/ của bạn đã dùng cho nội dung khác, README nói có thể chuyển toàn bộ thư mục của plugin sang một gốc khác qua thiết lập docs_root.


