Muse Code nâng cao: cấu hình dự án, tự viết skill, chia việc cho subagent và duyệt qua git

Cập nhật tháng 10/2026. Muse Code vẫn đang beta: tên lệnh, danh sách skill dựng sẵn và hành vi mặc định có thể đổi giữa các bản. Mọi chi tiết trong bài được đối chiếu với tài liệu tại dev.meta.ai/docs; trước khi áp dụng cho dự án khách, hãy chạy muse --help và /help để kiểm tra bản bạn đang dùng.

Bài Muse Code của Meta: cài đặt, đặt quyền an toàn và giao việc song song cho subagent đã đi qua phần nhập môn. Bài này đi tiếp: biến Muse Code thành công cụ của dự án, để ai trong đội mở kho mã cũng có cùng quy ước, cùng skill, cùng giới hạn quyền. Ví dụ xuyên suốt: kiểm tra toàn bộ trang dịch vụ của một website WordPress và dựng bộ test để lần sau khỏi kiểm tay.

1. Bốn lớp cấu hình của một dự án Muse Code

Theo trang cấu hình và trang mở rộng trong tài liệu chính thức, những gì Muse Code nạp khi mở một dự án chia thành các lớp sau:

Phần cá nhân nằm ở ~/.config/muse/settings.json: mô hình mặc định, hồ sơ quyền, máy chủ MCP, hook cá nhân. Tệp này bắt buộc có "schema_version": 1; không có tệp thì Muse Code dùng mặc định.

Lưu ý: quy ước, skill và hook của dự án chỉ nạp sau khi bạn tin cậy workspace, còn bộ nhớ đã commit thì nạp cả khi chưa tin cậy. Với kho mã lạ, đọc MEMORY.md trước.

2. Thiết lập dự án WordPress từng bước

3. Skills: dùng bản dựng sẵn và tự viết cho quy trình của đội

Bản hiện tại có sẵn vài skill gọi bằng lệnh gạch chéo, ví dụ /plan (lập kế hoạch, chờ duyệt), /grilling (hỏi từng câu để chốt yêu cầu), /grill-with-docs (như trên và ghi quyết định vào tệp bạn chỉ định) và /taste (tránh kiểu giao diện “trông như AI làm”). Danh sách đổi theo bản, nên tin vào muse skills list trên máy bạn.

Tự viết skill khi một quy trình lặp lại nhiều lần, ví dụ “rà một trang dịch vụ theo checklist công ty”: tạo .agents/skills/ra-trang-dich-vu/SKILL.md mô tả khi nào dùng, các bước, định dạng báo cáo, rồi kiểm tra bằng muse skills validate. Muse Code cũng quét .claude/skills, .codex/skills và có lệnh muse skills import --from claude để dùng lại skill sẵn có, đúng tinh thần bài CLAUDE.md và AGENTS.md cho dự án web.

4. Subagent fan-out: chia việc lớn cho nhiều agent

Fan-out: trong một lượt, agent chính sinh nhiều agent con, mỗi con một việc độc lập; agent chính theo dõi, nhắn hướng dẫn, huỷ và thu kết quả. Bạn xem bằng /subagents.

• Sức chứa: mặc định 8 agent chạy đồng thời tính cả agent gốc, chỉnh bằng agents.execution_capacity (1–64) trong settings. Sinh thêm thì xếp hàng chờ, không báo lỗi.
• Tách worktree: agent con có quyền ghi nên chạy trong worktree riêng; agent chỉ đọc thì không cần. Nếu bị từ chối với lỗi worktree_isolation_unavailable, khởi động lại bằng muse --subagent-worktree-isolation.
• Huỷ là “ngừng việc mới”, không phải hoàn tác. Agent con đang ghi dở vẫn có thể ghi xong; worktree không cần thì tự dọn.

5. Ví dụ: rà 12 trang dịch vụ và dựng bộ test

Tình huống minh hoạ: website WordPress của một công ty nội thất ở Hà Nội có 12 trang dịch vụ, sửa qua tay nhiều người. Đội web 3 người cần kiểm tiêu đề, mô tả SEO, nút liên hệ, alt ảnh, liên kết hỏng, hiển thị di động, trên bản staging.

Mẫu 1: Chốt tiêu chí trước khi làm

Mẫu 2: Rà song song, chỉ đọc

Mẫu 3: Dựng bộ test, mỗi phần một nhánh

Kết quả: một báo cáo có bằng chứng và ba nhánh test để duyệt riêng. Lỗi nội dung do người sửa trên WordPress.

6. Tích hợp git: duyệt và gộp kết quả

Worktree của agent con nằm dưới .muse/worktrees/, tạo từ HEAD của agent chính và tự xoá nếu sạch; thư mục làm việc của bạn không đổi trong lúc chúng chạy. Lệnh shell không ghi được vào .git, .muse, .agents.

Quy trình duyệt: xem /subagents, đọc git diff từng worktree so với commit gốc, chạy lại test trên máy, gộp từng nhánh một.

Khi bộ test ổn, có thể chạy trong CI bằng muse exec --prompt-file ./task.txt kèm --max-model-steps. Mã thoát 0 chỉ nghĩa là lượt chạy kết thúc, không phải việc làm đúng, nên luôn chặn bằng test của bạn. Trong CI dùng --disable-approval (vẫn giữ sandbox); --yolo chỉ cho container dùng xong bỏ.

7. Lỗi thường gặp

• Quên schema_version trong settings: mọi lệnh báo lỗi tệp cấu hình. Thêm "schema_version": 1 ở cấp gốc.
• Skill dự án không xuất hiện: chưa tin cậy workspace, hoặc mở phiên trước khi thêm skill. Kiểm tra bằng muse skills list rồi mở phiên mới.
• Fan-out những việc đụng cùng tệp: gộp sẽ xung đột. Chỉ chia việc độc lập và có giới hạn rõ; việc tuần tự làm ở luồng chính.
• Dùng hook để “chặn cho chắc”: hook chạy ngoài sandbox, viết sai có thể gây hại hơn. Ưu tiên quy tắc duyệt và sandbox trước.

8. Bài tập thực hành

1. Chọn một website WordPress có bản staging, đưa child theme và thư mục test vào git, chạy muse init, viết .agents/AGENTS.md với 3 quy tắc không được nới.
2. Viết skill ra-trang-dich-vu trong .agents/skills/, chạy muse skills validate và bật cho dự án.
3. Chạy lần lượt Mẫu 1, 2, 3 với 4–6 trang dịch vụ thật, ghi lại các lệnh bạn đã chọn “luôn cho phép”.
4. Duyệt từng nhánh test bằng git diff, gộp nhánh đạt, rồi thử sai một tiêu đề trên staging xem test có bắt được không.

Muốn so Muse Code với các công cụ khác cho cùng tình huống, đọc thêm So sánh trợ lý lập trình AI cho đội nhỏ.

Thuật ngữ cần biết

• Fan-out: kiểu chia việc trong đó một agent chính sinh nhiều agent con chạy song song rồi gom kết quả (Meta cookbook).
• Git worktree: nhiều thư mục làm việc dùng chung một kho git, mỗi thư mục ở một nhánh hoặc commit riêng (git-scm.com).
• Hook: lệnh tự chạy khi một sự kiện xảy ra trong phiên, như trước hoặc sau khi agent dùng công cụ (tài liệu Muse Code).
• Guardrail: quy tắc và tệp được bảo vệ để agent không tự nới giới hạn của chính nó (Immutable guardrails).

Tìm hiểu thêm

• Cấu hình, tệp quy ước và bộ nhớ
• Mở rộng: skills, hook, MCP, subagent, chạy không giao diện
• Quyền, chế độ duyệt và sandbox
• Các skill dựng sẵn
• Playwright: bắt đầu viết test giao diện

Câu hỏi thường gặp

Muốn đội kỹ thuật dùng agent lập trình có quy ước chung, skill riêng và quy trình duyệt rõ ràng? Tham khảo chương trình đào tạo và triển khai AI của PDL.