Xây dựng quy trình lập trình AI hiệu quả hơn với MCode Stack

MCode Stack là gì?

MCode Stack là bộ sưu tập mã nguồn mở gồm các quy trình, kỹ năng và danh sách kiểm tra được đội ngũ MiniMax Code sử dụng. Bộ sưu tập này biến các thói quen kỹ thuật thực tế thành những tệp SKILL.md có thể chạy và cài đặt trực tiếp trong MiniMax Code.

Kho lưu trữ này không phải là thư viện prompt chung chung hay danh sách tĩnh các phương pháp hay nhất. Các tài nguyên trong đó giải quyết những quyết định thường gặp khi phát triển có sự hỗ trợ của AI: khi nào nên giao việc cho tác vụ con, cách quản lý ngữ cảnh, lệnh nên chạy trong bao lâu, cách duy trì trạng thái giữa các phiên và cách độc lập đánh giá mã do AI viết.

MCode Stack chứa các quy trình và kỹ năng, không chứa mã nguồn của MiniMax Code.

Tính năng chính

• Kỹ năng có thể chạy: Gọi một kỹ năng theo tên hoặc để tác nhân tự tải kỹ năng dựa trên phần mô tả.
• Danh sách kiểm tra tương tác: Cho phép tác nhân kiểm tra dự án theo từng mục hoặc tự đọc các phiên bản văn bản thuần túy.
• Quy trình được ghi chép: Tìm hiểu cách những người đóng góp sử dụng MiniMax Code trong công việc hằng ngày.
• Đóng gói plugin: Cài đặt toàn bộ stack dưới dạng một plugin MiniMax Code.
• Hỗ trợ marketplace: Thêm kho lưu trữ này làm marketplace và quản lý các stack dưới dạng plugin có thể cài đặt khi tính năng này khả dụng.
• Định dạng di động: Định dạng SKILL.md phổ biến cho phép nhiều kỹ năng hoạt động với các tác nhân khác hỗ trợ kỹ năng.

Ronny Stack bao quát những gì?

Stack đầu tiên và đầy đủ nhất là stacks/ronny. 15 kỹ năng của stack được tổ chức theo các giai đoạn phổ biến trong công việc kỹ thuật.

• Lập kế hoạch và phân tách: Quyết định khi nào nên dùng tác vụ con, chia các thay đổi lớn thành những pull request nhỏ và viết mô tả thay đổi hữu ích.
• Ngữ cảnh và công cụ: Kiểm tra chi phí công cụ và xác định nội dung được đưa vào mọi yêu cầu.
• Phiên làm việc và lệnh dài: Quản lý việc nén ngữ cảnh, bộ nhớ, bàn giao, lệnh shell và tác vụ chạy nền.
• Đánh giá: Thực hiện đánh giá độc lập, đánh giá tình trạng mã, viết nhận xét đánh giá và phản hồi ý kiến.
• Thử nghiệm và sửa lỗi khẩn cấp: Chạy các thử nghiệm harness có kiểm soát, xem xét quỹ đạo của tác nhân và xử lý an toàn các thay đổi khẩn cấp.

Cài đặt một kỹ năng

Cài đặt một kỹ năng là cách phù hợp để đánh giá MCode Stack mà không cần kích hoạt toàn bộ bộ sưu tập. Ví dụ sau cài đặt long-command-check cho tất cả dự án.

git clone https://github.com/MiniMax-AI/mcode-stack.git ~/mcode-stack
mkdir -p ~/.agents/skills
cp -R ~/mcode-stack/stacks/ronny/skills/long-command-check ~/.agents/skills/

Khởi động một phiên MiniMax Code mới và nhập:

/skills

Kỹ năng đã cài đặt sẽ xuất hiện trong danh sách. Chạy trực tiếp bằng:

/long-command-check

Bạn cũng có thể mô tả một tác vụ liên quan và để tác nhân tải kỹ năng dựa trên phần mô tả.

Chọn thư mục kỹ năng của dự án hoặc toàn cục

MiniMax Code phát hiện các kỹ năng từ nhiều vị trí. Mỗi kỹ năng phải có thư mục con riêng chứa tệp SKILL.md.

Thư mục dành riêng cho dự án:

• .minimax/skills/
• .claude/skills/
• .agents/skills/

Thư mục toàn cục:

• ~/.agents/skills/
• ~/.claude/skills/
• ~/.codex/skills/

Sử dụng thư mục dự án khi một kỹ năng chỉ nên áp dụng cho một kho lưu trữ. Sử dụng thư mục toàn cục khi muốn kỹ năng khả dụng trong mọi dự án.

Cài đặt toàn bộ stack dưới dạng plugin

Để sử dụng toàn bộ Ronny stack cục bộ, trước tiên hãy xác định thư mục plugin của MiniMax Code:

mcode plugin marketplace list

Sao chép toàn bộ thư mục stacks/ronny vào thư mục plugin cục bộ được hiển thị bởi lệnh đó. Sau đó mở /plugins trong MiniMax Code và nhấn Ctrl+R để làm mới bảng điều khiển.

Plugin cục bộ được cài đặt ngay khi thư mục của plugin xuất hiện. Trong bảng plugin, nhấn Space để bật hoặc tắt plugin.

Lệnh mcode plugin add chỉ cài đặt từ danh mục chính thức. Lệnh này không chấp nhận URL GitHub hoặc đường dẫn cục bộ.

Cài đặt qua marketplace

Kho lưu trữ này cũng có thể hoạt động như một marketplace plugin. Trong MiniMax Code dành cho máy tính, mở Plugins, chọn Add marketplace và nhập:

MiniMax-AI/mcode-stack

Sau đó, mỗi stack sẽ xuất hiện dưới dạng plugin có thể cài đặt, cập nhật hoặc gỡ cài đặt. Hỗ trợ marketplace đang được triển khai dần, vì vậy tùy chọn này có thể chưa xuất hiện trong mọi phiên bản MiniMax Code.

Sử dụng danh mục trong Claude Code

Có thể thêm cùng danh mục plugin này trong Claude Code:

/plugin marketplace add MiniMax-AI/mcode-stack
/plugin install ronny@mcode-stack

Mức độ tương thích có thể khác nhau tùy kỹ năng, nhưng định dạng SKILL.md dùng chung được thiết kế để hoạt động trên các tác nhân hỗ trợ kỹ năng.

Ví dụ sử dụng cơ bản

Kiểm tra lệnh chạy lâu

Trước khi bắt đầu một quá trình build, kiểm thử, di chuyển hoặc tác vụ nền có thể chạy chậm, hãy gọi:

/long-command-check

Kỹ năng này áp dụng một cuộc kiểm tra gồm mười điểm cho các lệnh shell dài và tác vụ chạy nền. Hãy sử dụng các phát hiện để quyết định cách lệnh nên chạy và cách theo dõi tiến trình của lệnh.

Quyết định Có Sử dụng Tác nhân Phụ Hay Không

Khi một tác vụ có thể được thực hiện song song nhưng bạn không chắc việc ủy quyền có hữu ích hay không, hãy chạy:

/subagent-split-check

Kỹ năng này giúp quyết định công việc nên được giao cho tác nhân phụ hay tiếp tục trong vòng lặp chính. Nó hỗ trợ nguyên tắc rộng hơn của kho lưu trữ về việc quản lý ngữ cảnh trước khi bổ sung thêm tác nhân.

Chuẩn bị Bàn giao Phiên

Đối với công việc phải tiếp tục trong một phiên mới, hãy gọi:

/handoff-doc

Tài liệu bàn giao được tạo ra giúp phiên khác tiếp tục công việc với trạng thái cần thiết. Hãy kết hợp tài liệu này với /long-session-check khi quyết định nên tóm tắt, ghi thông tin vào tệp, thu gọn phiên hiện tại hay bắt đầu lại.

Đánh giá trong Ngữ cảnh Sạch

Hãy sử dụng:

/independent-review

Kỹ năng này đánh giá một thay đổi bằng ngữ cảnh sạch chứa diff, yêu cầu và kết quả kiểm thử. Để đánh giá rộng hơn về tình trạng mã, bao quát thiết kế, chức năng, độ phức tạp, kiểm thử và rủi ro phê duyệt, hãy sử dụng:

/engineering-code-review

Mẹo Quy trình Nâng cao

Kết hợp Kỹ năng theo Giai đoạn Phát triển

Thay vì chạy mọi kỹ năng cho mọi tác vụ, hãy chọn kỹ năng dựa trên giai đoạn hiện tại của công việc.

1. Lập kế hoạch: Bắt đầu với subagent-split-check và engineering-small-prs.
2. Kiểm soát ngữ cảnh: Sử dụng tool-budget-audit và context-tax-audit.
3. Duy trì tính liên tục: Áp dụng long-session-check, handoff-doc và long-command-check.
4. Đánh giá: Chạy independent-review và engineering-code-review, sau đó sử dụng các kỹ năng nhận xét đánh giá và phản hồi khi cần.
5. Đánh giá các thay đổi: Sử dụng harness-experiment và trajectory-review để xem xét cả kết quả lẫn quá trình tác nhân đã thực hiện.

Kiểm tra các Tệp Quy trình

Một stack có thể chứa các kỹ năng, danh sách kiểm tra và tệp WORKFLOW.md. Kỹ năng là các tài nguyên có thể thực thi, còn WORKFLOW.md giải thích cách tác giả của stack làm việc với tác nhân. Hãy đọc quy trình trước khi áp dụng toàn bộ stack để hiểu cách các thành phần của nó kết hợp với nhau.

Giữ Thí nghiệm trong Kiểm soát

Kỹ năng harness-experiment nhấn mạnh các đánh giá quy mô nhỏ, mỗi lần chỉ thay đổi một yếu tố, chạy lặp lại và kiểm tra những tác vụ có kết quả thay đổi. Hãy kết hợp với trajectory-review để xem xét cách tác nhân đạt được kết quả thay vì chỉ xem một bài kiểm thử có đạt hay không.

Điều chỉnh Stack theo Quy trình của Bạn

Dự án xem kỹ thuật harness là một phương pháp không ngừng phát triển. Bạn có thể sao chép các kỹ năng vào các thư mục dành riêng cho dự án, điều chỉnh chúng cho môi trường của mình hoặc tập hợp một nhóm con tập trung thay vì cài đặt mọi thứ. Hãy dựa các thay đổi trên việc sử dụng thực tế, thay vì biến stack thành một bộ sưu tập các prompt giả định.

Đóng góp Stack của Bạn

Kho lưu trữ hoan nghênh các stack dựa trên quy trình làm việc hằng ngày trong thực tế với MiniMax Code hoặc các tác nhân khác.

1. Sao chép templates/stack-template/ vào community/<your-id>/.
2. Viết WORKFLOW.md giải thích những gì bạn giao cho tác nhân và những gì bạn tự theo dõi.
3. Thêm ít nhất một kỹ năng hoặc danh sách kiểm tra mà bạn thực sự sử dụng.
4. Xác thực đóng góp bằng:

node scripts/check.mjs

Mở một pull request chứa kết quả xác thực và bản ghi ngắn về việc sử dụng thực tế. Xem CONTRIBUTING.md để biết đầy đủ yêu cầu đóng góp.

Ghi chú về Giấy phép

MCode Stack nhìn chung được cung cấp theo Giấy phép MIT, trừ khi NOTICE.md của một stack có quy định khác. Sáu kỹ năng engineering-* được điều chỉnh từ Google Engineering Practices, và phần nội dung đã điều chỉnh đó vẫn thuộc CC-BY 3.0.

Kết luận

MCode Stack biến các thói quen kỹ thuật có sự hỗ trợ của AI đã được chứng minh thành những quy trình có thể chạy trực tiếp. Hãy bắt đầu với một kỹ năng, chẳng hạn long-command-check, sau đó áp dụng một stack plugin đầy đủ nếu quy trình phù hợp với nhu cầu của bạn. Bằng cách kết hợp lập kế hoạch, kiểm soát ngữ cảnh, quản lý phiên, đánh giá độc lập và thí nghiệm có kiểm soát, bạn có thể thiết lập một quy trình kỷ luật hơn cho mã do AI viết.