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 Compound Engineering cho Claude Code, Codex, Cursor và nhiều AI coding agent khác. Plugin biến một yêu cầu kỹ thuật thành quy trình brainstorm, plan, work, review và compound; cách cài phụ thuộc vào host bạn đang dùng.
compound-engineering-plugin là plugin chính thức của EveryInc cho các AI coding agent như Claude Code, Cursor, Codex và nhiều host khác. Plugin cung cấp 38 skill để biến công việc lập trình từ một yêu cầu rời rạc thành một vòng làm việc có cấu trúc: suy nghĩ, lập kế hoạch, triển khai, đơn giản hoá, review rồi lưu lại bài học.
Điểm đáng giá nhất là phần kiến thức sau mỗi thay đổi không bị mất. Skill ce-compound ghi lại các bài học vào dự án để lần brainstorm và lập kế hoạch sau có thêm ngữ cảnh. Cách này phù hợp với dev làm một mình, nhóm kỹ thuật nhỏ, người mới dùng AI để code và đội ngũ muốn các agent làm việc nhất quán hơn.
Repo hiện có khoảng 26061 sao và 2068 fork, dùng TypeScript và giấy phép MIT. README nói plugin chạy trên 14 agent host, trong đó có Claude Code, Cursor và Codex. README cũng cho biết dự án còn được cập nhật.
EveryInc/compound-engineering-plugin
Plugin gồm 38 skill giúp AI coding agent brainstorm, lập kế hoạch, viết code, review và lưu lại kiến thức cho lần sau.
I.compound-engineering-plugin làm được gì
Plugin tổ chức công việc kỹ thuật thành một vòng lặp có thể lặp lại. Bạn không chỉ hỏi agent viết code ngay, mà có thể yêu cầu nó làm rõ yêu cầu, tạo kế hoạch, thực hiện từng phần, kiểm tra kết quả và lưu lại kiến thức cho lần sau.
Brainstorm yêu cầu trước khi lập trình:
ce-brainstormhỏi đáp tương tác và tạo một kế hoạch thống nhất ở mức yêu cầu. Tính năng này hữu ích khi bạn mới chỉ có một ý tưởng như thêm retry cho background job nhưng chưa biết cần chốt những điều gì.Lập kế hoạch triển khai:
ce-planlàm giàu kế hoạch yêu cầu thành kế hoạch có thể triển khai. Nhờ vậy agent có thêm phạm vi, cách làm và các điểm cần kiểm tra trước khi sửa code.Thực hiện kế hoạch:
ce-workthực thi kế hoạch đã sẵn sàng. README cho biết skill này có thể làm việc native hoặc qua một author đủ điều kiện, đồng thời vẫn giữ phần kiểm tra, commit và shipping của host.Đơn giản hoá code mới viết:
ce-simplify-codetinh chỉnh code vừa tạo và loại bỏ test hoặc comment không hữu ích trước khi review. Đây là bước giúp phần thay đổi không phình to chỉ vì agent sinh quá nhiều mã phụ.Review trước khi merge:
ce-code-reviewthực hiện review nhiều agent dựa trên kế hoạch và chỉ báo cáo kết quả. Việc áp dụng thay đổi là một bước rõ ràng, giúp bạn kiểm soát các đề xuất trước khi chúng đi vào code.Lưu bài học vào dự án:
ce-compoundghi lại kiến thức vào thư mụcdocs/solutions/. Lần làm việc sau có thể đọc lại các bài học này thay vì khám phá cùng một quy tắc hoặc lỗi từ đầu.Chạy toàn bộ quy trình tự động:
lfgnhận một feature và chạy pipeline gần như hands-off. Theo README, nó chọn nguồn công việc đã được xác minh, thực hiện, simplify, review và áp dụng fix, ghi lại kiến thức, chạy browser test rồi commit. Nếu có remote, nó còn push, mở pull request và theo dõi CI trong giới hạn sửa lỗi; nó không merge nếu bạn chưa cấp quyền.Hỗ trợ các nhu cầu ngoài vòng lặp chính: Nhóm skill còn có
ce-debugđể bắt đầu từ bug,ce-ideateđể tìm ý tưởng,ce-explainđể hiểu một hành vi hiện có,ce-povđể xin khuyến nghị và ý kiến độc lập với câu lệnhoracle this, cùng các skill cho strategy, test, commit, pull request, handoff và polish.Cấu hình phạm vi tài liệu: Mặc định các artifact nằm ở
docs/solutions/vàdocs/plans/. Nếu thư mụcdocs/của dự án đang chứa nội dung được theo dõi, README nói bạn có thể chuyển toàn bộ thư mục artifact về một gốc tương đối khác bằng thiết lậpdocs_root.
II.Cần chuẩn bị gì
Bạn cần một AI coding agent được plugin hỗ trợ. README nêu các 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. Cách cài thay đổi theo từng host.
Bạn cũng cần quyền cài plugin hoặc marketplace trong host đó. Với Codex App, bạn cần mở khu vực Plugins và thêm marketplace tùy chỉnh. Với Cline, bạn cần bật tính năng Skills trong phần Settings của extension. Với các CLI, bạn cần có lệnh CLI tương ứng như codex, copilot, droid, qwen, pi, grok hoặc devin.
README không yêu cầu cài Node.js, Python, Bun hay một API key riêng cho plugin. Repo có package.json, bun.lock và mã TypeScript, nhưng phần hướng dẫn sử dụng plugin không bảo bạn chạy npm install hoặc bun install. Vì vậy, hãy cài qua host trước; không tự suy ra thêm bước cài dependency khi chưa cần.
Các skill có thể làm việc với repository Git hiện có. Nếu muốn dùng workflow đầy đủ như commit, push, mở pull request và theo dõi CI, dự án cần có remote phù hợp và quyền tương ứng. README nói lfg dừng ở local commit nếu không có remote.
Plugin có thể thao tác trên code, commit và trong một số workflow là push hoặc mở pull request. Hãy review kế hoạch và kết quả trước khi cho phép các hành động ảnh hưởng repository hoặc chi phí dịch vụ của bạn.
III.Cài đặt từng bước
- Chọn hostXác định bạn dùng Claude Code, Cursor, Codex hay một host được hỗ trợ
- Cài pluginDùng đúng lệnh hoặc giao diện cài đặt của host
- Khởi động lạiMở session mới hoặc restart host nếu README yêu cầu
- Thiết lập dự ánChạy /ce-setup trong repository muốn làm việc
- Chạy vòng lặp đầu tiênBắt đầu bằng brainstorm rồi plan, work và review
A.Chọn cách cài phù hợp với host
Không có một lệnh chung cho mọi host. Nếu bạn dùng Claude Code, mở Claude Code trong project rồi chạy hai lệnh sau:
/plugin marketplace add EveryInc/compound-engineering-plugin
/plugin install compound-engineeringNếu dùng Cursor, mở Cursor Agent chat và chạy:
/add-plugin compound-engineeringBạn cũng có thể tìm compound engineering trong plugin marketplace của Cursor. Grok Bot dùng tài khoản Cursor và thư viện plugin của Cursor, nên README nói bạn cài một lần trên tài khoản đó. Không chạy /add-plugin trong chat Grok Bot và không clone repo vào máy Grok Bot.
B.Cài trong Codex App
Codex App chưa liệt kê plugin này trong marketplace tích hợp sẵn. Trong Codex App, mở Plugins ở sidebar, bấm mũi tên cạnh Create, chọn Add marketplace, rồi nhập các giá trị sau:
Source: EveryInc/compound-engineering-plugin
Git ref: main
Sparse paths: để trốngBấm Add marketplace, tìm Compound Engineering, cài compound-engineering-plugin, rồi restart Codex. README nói bản cài trong Codex App đã tự chứa phần reviewer và research dưới dạng prompt asset cục bộ; không cần cài custom agent riêng.
C.Cài bằng Codex CLI
Đăng ký marketplace trước:
codex plugin marketplace add EveryInc/compound-engineering-pluginSau đó cài plugin:
codex plugin add compound-engineering@compound-engineering-pluginBạn cũng có thể chạy codex, mở /plugins, tìm marketplace Compound Engineering, chọn plugin rồi chọn Install. Sau khi cài xong, restart Codex.
Nếu dùng profile Codex không mặc định, README yêu cầu mọi bước liên quan đến Codex dùng cùng một CODEX_HOME. Ví dụ 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 marketplace chỉ làm plugin có thể được tìm thấy. Bước plugin add mới kích hoạt các skill cho profile đó. Trong Codex, README dùng cú pháp $skill-name, ví dụ $ce-plan và $lfg, thay cho cú pháp slash của một số host khác.
D.Cài cho Cline hoặc một CLI hỗ trợ GitHub
Với Cline, trước hết vào Settings -> Features -> Enable Skills để bật Skills trong extension. Sau đó clone repo và cài skill ở phạm vi toàn cục:
git clone https://github.com/EveryInc/compound-engineering-plugin
./compound-engineering-plugin/.cline/scripts/install-skills.sh --globalNếu chỉ muốn cài cho project hiện tại từ một checkout:
./compound-engineering-plugin/.cline/scripts/install-skills.sh --projectSau khi cài hoặc cập nhật, bắt đầu một Cline task mới. Với Copilot CLI, dùng:
/plugin marketplace add EveryInc/compound-engineering-plugin
/plugin install compound-engineering@compound-engineering-pluginHoặc chạy từ shell:
copilot plugin marketplace add EveryInc/compound-engineering-plugin
copilot plugin install compound-engineering@compound-engineering-pluginCác host khác cũng có lệnh riêng trong README. Grok Build CLI dùng grok plugin install EveryInc/compound-engineering-plugin; Devin CLI dùng devin plugins install EveryInc/compound-engineering-plugin; Qwen Code dùng qwen extensions install EveryInc/compound-engineering-plugin:compound-engineering; Pi dùng pi install git:github.com/EveryInc/compound-engineering-plugin.
Với OpenCode, thêm plugin vào mảng plugins của opencode.json:
{
"plugins": ["compound-engineering@git+https://github.com/EveryInc/compound-engineering-plugin.git"]
}README lưu ý OpenCode 1.x dùng khóa plugin ở dạng số ít. Sau khi sửa cấu hình, restart OpenCode. Không cần chạy Bun installer hoặc tạo bản sao skill thủ công.
E.Thiết lập trong repository
Mở AI coding agent tại repository bạn muốn làm việc, sau đó chạy:
/ce-setupSkill này báo các capability tùy chọn của tool, tạo .compound-engineering/config.yaml nếu file chưa có, làm mới example đã commit và gitignore một local override hiện có. Nếu chưa biết nên chạy skill nào tiếp theo, dùng:
/ce-helpNếu host của bạn dùng cú pháp Codex, hãy gọi skill theo dạng $ce-setup hoặc $ce-help theo quy tắc README dành cho Codex.
IV.Kiểm tra đã chạy được chưa
Cách kiểm tra đơn giản nhất là chạy /ce-setup trong một repository. Kết quả mong đợi theo README là skill báo các khả năng tool tùy chọn, tạo file .compound-engineering/config.yaml khi file còn thiếu, cập nhật example đã commit và gitignore phần override cục bộ nếu có.
Tiếp theo chạy /ce-help. Nếu plugin đã được nạp, host sẽ nhận diện skill trợ giúp và hướng dẫn bạn chọn bước tiếp theo. Bạn cũng có thể chạy vòng đầu tiên:
/ce-brainstorm make background job retries safer
/ce-planTrong Codex, dùng $ce-brainstorm make background job retries safer và $ce-plan. Nếu host nhận diện được hai skill và tạo được kế hoạch, phần cài đặt cơ bản đã hoạt động.
Khi dùng Cline, hãy bắt đầu một task mới sau khi cài hoặc cập nhật. Khi dùng Devin, Grok hoặc host có cơ chế nạp plugin lúc mở session, hãy mở session mới để skill xuất hiện. Nếu dùng Codex profile riêng, kiểm tra bạn đã dùng cùng CODEX_HOME ở bước marketplace và bước install.
V.Dùng vào việc thật
A.Chủ shop muốn thêm xử lý retry cho đơn hàng
Một chủ shop có ứng dụng nhận đơn từ nhiều kênh và muốn background job thử lại khi dịch vụ giao hàng tạm thời lỗi. Thay vì yêu cầu agent sửa ngay, hãy mở project và chạy:
/ce-brainstorm make background job retries saferAgent sẽ hỏi để làm rõ yêu cầu và tạo kế hoạch ở mức requirements. Sau đó chạy /ce-plan để biến kế hoạch thành các bước triển khai. Khi kế hoạch đủ rõ, dùng /ce-work, rồi /ce-simplify-code, /ce-code-review và /ce-compound.
Kết quả mong đợi là một thay đổi có quy trình rõ: yêu cầu được chốt trước, code được triển khai theo kế hoạch, kết quả được review và các bài học về retry được lưu lại cho lần sửa sau.
B.Nhân viên văn phòng cần hiểu một module cũ
Một nhân viên phụ trách vận hành gặp hành vi khó hiểu trong hệ thống nội bộ và cần biết vì sao module đó tồn tại trước khi nhờ dev sửa. Dùng skill ce-explain để hỏi agent giải thích behavior liên quan và lý do đằng sau nó.
Ví dụ câu hỏi:
/ce-explain how the invoice export behavior works and why it existsSau khi hiểu bối cảnh, người dùng có thể chuyển kết quả cho dev hoặc tiếp tục brainstorm một thay đổi cụ thể. Cách này phù hợp khi vấn đề chưa đủ rõ để lập tức tạo ticket triển khai.
C.Dev muốn tự động hoá một feature từ đầu đến cuối
Một dev đã mô tả feature bằng brainstorm và muốn agent chạy pipeline. Có thể bắt đầu bằng:
/ce-brainstorm describe the feature
/lfgTheo README, lfg chọn một work source đã được xác minh, thực hiện kế hoạch, simplify, chạy code review và áp dụng fix, ghi lại learning, chạy browser test rồi commit. Nếu repository có remote, workflow có thể push, mở pull request và theo dõi CI với repair loop có giới hạn. Nó không merge nếu bạn chưa cấp quyền.
D.Nhóm kỹ thuật muốn giảm việc học lại lỗi cũ
Sau một lần sửa lỗi, nhóm chạy /ce-compound để ghi lại bài học vào docs/solutions/. Ở lần brainstorm hoặc plan tiếp theo, các skill đọc phần kiến thức đã tích luỹ để có thêm grounding.
Ví dụ:
/ce-compoundKết quả quan trọng không chỉ là một bản sửa đã xong, mà là context có thể tái sử dụng. Đây là phần tạo ra hiệu ứng “compound” của plugin.
Một lần chạy dạy cho agent; lần thứ hai giúp agent nhớ bài học.
Ông T
VI.Lỗi hay gặp và cách xử lý
A.Cài plugin nhưng skill chưa xuất hiện
Nhiều host chỉ nạp plugin khi mở session. Với Cursor, Cline, Devin và Grok, hãy bắt đầu session hoặc task mới sau khi cài hay cập nhật. Với Codex, README cũng yêu cầu restart sau khi cài plugin.
B.Dùng sai cú pháp gọi skill
README dùng /skill-name cho các host slash-skill. Codex dùng $skill-name, ví dụ $ce-plan và $lfg. Nếu /ce-plan không được nhận trong Codex, hãy đổi sang cú pháp $ce-plan.
C.Chỉ đăng ký marketplace nhưng chưa cài plugin
Trong Codex CLI, codex plugin marketplace add ... chỉ làm marketplace có plugin. Bạn vẫn phải chạy codex plugin add compound-engineering@compound-engineering-plugin. Với profile riêng, hai lệnh phải dùng cùng CODEX_HOME.
D.Plugin vẫn ở phiên bản cũ sau khi cập nhật
Với Claude Code, README nhấn mạnh phải refresh marketplace trước khi update. Chạy lại lệnh thêm marketplace rồi mới cập nhật; chỉ chạy /plugin update có thể khiến bạn vẫn ở phiên bản cũ.
E.Cline không tải được skill
Kiểm tra Settings -> Features -> Enable Skills đã bật chưa. Sau đó xác nhận bạn chạy đúng script với --global hoặc --project, rồi bắt đầu một task Cline mới. Không nên tự tạo bản sao SKILL.md nếu chưa cần vì repo đã có script cài đặt cho Cline.
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 AI coding agent và muốn quy trình có điểm bắt đầu, kế hoạch, review và nơi lưu kiến thức rõ ràng. Plugin đặc biệt hợp với nhóm có nhiều thay đổi lặp lại, codebase lớn hoặc muốn agent hiểu dần các quy tắc riêng của repository.
Điểm mạnh là có 38 skill bao phủ cả vòng đời kỹ thuật, hỗ trợ nhiều host và dùng được với nhiều kiểu công việc: feature, bug, giải thích code, review, test, commit và pull request. Giấy phép MIT cũng phù hợp cho việc thử nghiệm và tích hợp trong dự án.
Giới hạn là cách cài không đồng nhất giữa các host. README không đưa ra yêu cầu phần cứng, API key hay bảng giá riêng, nên chưa thể kết luận plugin miễn phí hoàn toàn theo chi phí của từng host. Một số workflow có thể commit, push, mở pull request hoặc tương tác với CI; bạn vẫn cần xem lại quyền và kết quả trước khi cho chạy tự động.
Nếu bạn chỉ cần một prompt đơn giản để sinh code cho một thay đổi nhỏ, 38 skill có thể là nhiều hơn mức cần thiết. Nếu bạn chưa dùng AI coding agent nào được README hỗ trợ, hãy kiểm tra host hiện tại trước; plugin này không thay thế bản thân host. Với công việc kỹ thuật lặp lại và cần tích luỹ ngữ cảnh, đây là một plugin đáng thử.
Câu hỏi thường gặp
compound-engineering-plugin có miễn phí không?
Repo dùng giấy phép MIT. README không nêu bảng giá hoặc chi phí riêng cho plugin, nên chưa có thông tin để khẳng định toàn bộ chi phí sử dụng, bao gồm chi phí của AI coding agent hoặc dịch vụ liên quan.
Có cần GPU hoặc API key riêng không?
README không yêu cầu GPU và cũng không nêu API key riêng cho plugin. Bạn cần một agent host được hỗ trợ; yêu cầu tài khoản hoặc chi phí của host chưa được README này mô tả.
Có chạy được trên Windows không?
README liệt kê nhiều host và lệnh cài nhưng không nêu ma trận hệ điều hành. Vì vậy chưa có thông tin chính thức trong tư liệu được cung cấp để khẳng định riêng khả năng chạy trên Windows.
Plugin hỗ trợ những công cụ nào?
README nói 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.
Có cần cài Node.js, Python hoặc Bun trước không?
README không yêu cầu cài Node.js, Python hay Bun để cài plugin qua các host. Repo có package.json, bun.lock và mã TypeScript, nhưng tư liệu không hướng dẫn chạy npm install hoặc bun install.
Dùng plugin có an toàn cho repository không?
Plugin có các workflow có thể thực hiện code, commit, push, mở pull request và theo dõi CI khi điều kiện phù hợp. Nên review kế hoạch và kết quả, đồng thời kiểm tra quyền trước khi cho phép các thao tác ảnh hưởng repository.
Codex App và Codex CLI cài plugin có giống nhau không?
Không hoàn toàn giống. Codex App cần thêm marketplace tùy chỉnh từ giao diện Plugins, còn Codex CLI dùng lệnh marketplace add rồi plugin add; cả hai đều cần cài plugin thực sự và README yêu cầu restart sau khi cài.


