Kỹ thuật ghép nối (Compound Engineering): Chiến lược tối ưu hóa hiệu suất mô hình AI

Triết lý

Triết lý cốt lõi của compound engineering (kỹ thuật tích lũy) là mỗi đơn vị công việc kỹ thuật phải làm cho các đơn vị tiếp theo trở nên dễ dàng hơn—chứ không phải khó khăn hơn.

Hầu hết các codebase (cơ sở mã nguồn) đều trở nên khó làm việc hơn theo thời gian vì mỗi tính năng bạn thêm vào đều làm tăng thêm sự phức tạp. Sau 10 năm, các đội ngũ dành nhiều thời gian để "chiến đấu" với hệ thống của họ hơn là xây dựng trên đó, vì mỗi tính năng mới đều là một cuộc thương lượng với những tính năng cũ. Theo thời gian, codebase trở nên khó hiểu hơn, khó sửa đổi hơn và khó tin tưởng hơn.

Compound engineering đảo ngược hoàn toàn điều này. Thay vì các tính năng làm tăng sự phức tạp và tính mong manh, chúng dạy cho hệ thống những khả năng mới. Việc sửa lỗi giúp loại bỏ toàn bộ các nhóm lỗi trong tương lai. Khi được hệ thống hóa, các mô hình (patterns) trở thành công cụ cho công việc sau này. Theo thời gian, codebase trở nên dễ hiểu hơn, dễ sửa đổi hơn và dễ tin tưởng hơn.

Vòng lặp chính

Every vận hành năm sản phẩm—Cora, Monologue, Sparkle, Spiral và trang web Every.to của chúng tôi—với các đội ngũ kỹ thuật chủ yếu chỉ gồm một người. Hệ thống giúp điều này trở nên khả thi là một vòng lặp bốn bước tạo thành nền tảng của compound engineering:

Lập kế hoạch (Plan) → Thực hiện (Work) → Đánh giá (Review) → Tích lũy (Compound) → Lặp lại (Repeat)

Ba bước đầu tiên—lập kế hoạch, thực hiện và đánh giá—đã quá quen thuộc với bất kỳ lập trình viên nào. Chính bước thứ tư mới là thứ tách biệt compound engineering khỏi các phương pháp kỹ thuật khác. Đây là nơi các lợi ích được tích lũy. Nếu bỏ qua bước này, bạn chỉ đang thực hiện kỹ thuật truyền thống với sự hỗ trợ của AI.

Vòng lặp hoạt động giống nhau cho dù bạn đang sửa một lỗi trong năm phút hay xây dựng một tính năng trong vài ngày. Bạn chỉ cần dành nhiều hoặc ít thời gian hơn cho mỗi bước.

Các bước lập kế hoạch và đánh giá nên chiếm 80 phần trăm thời gian của một kỹ sư, còn thực hiện và tích lũy chiếm 20 phần trăm còn lại. Nói cách khác, phần lớn tư duy diễn ra trước và sau khi mã được viết.

1. Lập kế hoạch (Plan)

Lập kế hoạch biến một ý tưởng thành bản thiết kế, và kế hoạch tốt hơn sẽ tạo ra kết quả tốt hơn. Dưới đây là các hành động cần thực hiện và các câu hỏi cần tự đặt ra ở bước này:

2. Thực hiện (Work)

Việc thực thi tuân theo kế hoạch. Tác nhân (agent) thực hiện trong khi lập trình viên giám sát. Trong bước này, có một vài tác vụ nhỏ hơn:

Nếu bạn tin tưởng vào kế hoạch, không cần thiết phải theo dõi từng dòng mã.

3. Đánh giá (Review/assess)

Bước này giúp phát hiện các vấn đề trước khi chúng được triển khai. Quan trọng hơn, nó ghi lại những bài học cho chu kỳ tiếp theo, vốn trở thành cơ sở cho compound engineering. Dưới đây là các hành động diễn ra trong quá trình đánh giá:

4. Tích lũy (Compound - bước quan trọng nhất)

Phát triển truyền thống dừng lại ở bước ba, nhưng bước tích lũy mới là nơi tạo ra các giá trị gia tăng. Ba bước đầu tiên (lập kế hoạch, thực hiện, đánh giá) tạo ra một tính năng. Bước thứ tư tạo ra một hệ thống giúp xây dựng các tính năng tốt hơn mỗi lần.

Trong bước cuối cùng này, đây là những hành động bạn nên thực hiện:

Plugin

Quy trình làm việc của compound engineering được cung cấp dưới dạng một plugin. Hãy cài đặt nó, và toàn bộ hệ thống đã sẵn sàng để sử dụng.

Những gì có trong gói

Cài đặt

Dưới đây là hướng dẫn để thêm plugin vào một số công cụ lập trình AI phổ biến nhất. Không cần cấu hình gì thêm.

Claude Code

OpenCode (thử nghiệm)

Codex (thử nghiệm)

Nơi lưu trữ mọi thứ

CLAUDE.md là tệp quan trọng nhất mà tác nhân đọc trong mỗi phiên làm việc. Hãy đặt các tùy chọn, mô hình và ngữ cảnh dự án của bạn vào đây. Khi có sự cố xảy ra, hãy thêm ghi chú để tác nhân học hỏi.

docs/solutions/ xây dựng kiến thức nội bộ của bạn vì mỗi vấn đề được giải quyết sẽ trở thành tài liệu có thể tìm kiếm được. Các phiên làm việc trong tương lai sẽ tự động tìm thấy các giải pháp cũ.

todos/ theo dõi các mục công việc với mức độ ưu tiên và trạng thái. Khi bước đánh giá phát hiện ra vấn đề, hãy sử dụng chúng để quyết định xem điều gì đáng sửa, sau đó sử dụng các lệnh giải quyết để xử lý chúng.

Cấu trúc plugin

Bản thân plugin bao gồm:

Các lệnh cốt lõi

/workflows:brainstorm

Khi bạn không chắc chắn nên xây dựng cái gì, hãy bắt đầu từ đây.

Lệnh này giúp bạn động não các câu trả lời về việc xây dựng cái gì và lập kế hoạch cho cách xây dựng chúng. Sử dụng lệnh này khi các yêu cầu còn mơ hồ. Lệnh sẽ chạy quy trình nghiên cứu repo nhẹ, sau đó đặt câu hỏi từng cái một để làm rõ mục đích, người dùng, các ràng buộc và các trường hợp biên (edge cases). Sau đó, AI sẽ đề xuất các phương pháp tiếp cận và các quyết định sẽ được lưu lại trong docs/brainstorms/ để bàn giao cho /workflows:plan.

/workflows:plan