Bot GitHub tự hành: đỉnh cao không phải là làm nhiều, mà là biết khi nào không nên làm
Recipe GitHub agent trong cookbook ghép triage, review PR và tự động sửa bug vào GitHub Actions, chạy trên OpenCode và Muse Spark. Nhưng thứ đáng học nhất lại là các hàng rào an toàn.
Con bot này làm được gì
Recipe này dựng một bot GitHub Actions tự hành với bốn nhiệm vụ: triage issue, review pull request, phát hiện “AI slop” (code AI kém chất lượng), và tự mở PR sửa bug — tất cả chạy trên OpenCode với Muse Spark làm model, thông qua khả năng tương thích drop-in của Model API với các agent CLI sẵn có. Điểm quan trọng: mọi thứ chạy ngay trong Actions của chính repository của bạn, không phải trên hạ tầng của ai khác.
Sự kiềm chế là một yêu cầu thiết kế
Điều tách recipe này khỏi kiểu dự án ngây thơ “nối LLM vào webhook rồi xong” là phần lớn thiết kế xoay quanh việc không hành động. Agent review mang theo một danh sách “NOT slop” tường minh — các tiêu chí về những thay đổi nó không được phép gắn cờ, để không báo động giả trên những pattern hoàn toàn hợp lệ. Triage không bao giờ đóng issue; quyết định đó thuộc về con người. Agent sửa bug sẽ không mở PR nếu chưa tái hiện được bug trước đã. Meta nói thẳng: kích hoạt quá tay được coi là một failure mode, không phải chuyện nhỏ để cho qua.
Còn có cả kỷ luật trích dẫn: chức năng hỏi đáp chỉ được trả lời dựa trên các file trong repository, phải đính kèm trích dẫn file-và-mục cho từng khẳng định, và phải từ chối bịa khi câu trả lời không có trong repo. Với một con bot phát ngôn thay mặt dự án của bạn trên các thread công khai, “có căn cứ hoặc im lặng” là chính sách duy nhất có thể bảo vệ được.
AGENTS.md: một file cai quản cả đội
Mọi agent trong recipe đều tự động nạp một file AGENTS.md dùng chung, chứa ngữ cảnh của repository — để agent không phải đoán mò convention — cùng các quy tắc bảo mật mà tất cả cùng kế thừa. Meta gọi đây là file quan trọng nhất cần chỉnh lại cho dự án của riêng bạn: phiên bản đi kèm là một ví dụ mẫu cho stack Python/pytest/uv, được viết ra để bạn viết lại theo stack của mình, nhưng phần SECURITY phải giữ nguyên từng chữ.
Triển khai theo từng pha, quyền ghi phải tự kiếm
Hướng dẫn triển khai là một chiếc thang tin cậy bốn bậc. Pha một: review PR và triage, chỉ đọc — kiểm chứng chất lượng trên traffic thật với vùng ảnh hưởng bằng không. Pha hai: lệnh /oc tường minh, để maintainer chủ động gọi agent khi cần. Pha ba: tự động sửa bug nhưng phải qua cổng label. Pha bốn: gia cố — branch protection, CODEOWNERS, các cổng CI. Quyền ghi phải được kiếm bằng thành tích, không bao giờ được cấp từ ngày đầu. Đây cũng chính là triết lý trong câu chuyện auditability của Muse Code: mức tự chủ chỉ được mở rộng nhanh đúng bằng tốc độ mở rộng của khả năng kiểm chứng.
Meta đã kiểm chứng nó thế nào
Một chi tiết đáng bê nguyên về dùng: recipe được kiểm chứng bằng cách chạy các agent thật ở chế độ headless trên những kịch bản issue và PR viết sẵn — dựng lại prompt của Action với một gh giả trên PATH để không đụng vào repository thật — rồi đọc kết quả chúng tạo ra. Hãy test bot của bạn theo đúng cách bạn test bất kỳ automation nào chưa đáng tin: nhốt trong lồng kính trước khi cho gặp production. Recipe chạy được nằm trong cookbook, mục use cases.