polyphony

Tổng quan về polyphony skill

polyphony là một skill điều phối đa tác nhân để chạy các luồng công việc song song trong các workspace được cô lập bằng container. Mỗi phiên có một Docker container và một nhánh git riêng, vì vậy skill này rất hữu ích khi bạn cần chạy đồng thời mà không vướng xung đột nhánh, lỗi trạng thái dùng chung, hay khâu dọn dẹp rối rắm.

polyphony skill dùng để làm gì

Hãy dùng polyphony skill khi công việc lớn hơn một prompt đơn lẻ nhưng vẫn hưởng lợi từ việc phân quyền có cấu trúc: phát triển tính năng song song, xác minh trong môi trường cô lập, triage issue, hoặc chạy nhiều hướng xử lý của agent trên cùng một codebase. Skill này được thiết kế cho những ai coi trọng luồng thực thi gọn gàng, định tuyến tác vụ có thể tái lập, và phối hợp đa tác nhân an toàn hơn.

Điểm khiến polyphony nổi bật

Khác biệt chính của polyphony nằm ở thiết kế workflow ưu tiên cô lập. Thay vì bảo một agent “làm tất cả”, nó tách riêng khám phá nhiệm vụ, định tuyến, cấp phát môi trường, runtime và xác minh, để mỗi worker hoạt động trong một workspace được kiểm soát. Cách tiếp cận polyphony for Multi-Agent Systems vì thế thực tế hơn khi bạn cần test độc lập và hành vi landing sạch sẽ hơn.

Phù hợp nhất và các đánh đổi

polyphony phù hợp nhất nếu môi trường của bạn đã hỗ trợ Docker hoặc OrbStack và bạn muốn orchestration bật sẵn thay vì một mẫu prompt dùng một lần. Skill này kém hữu ích hơn nếu bạn chỉ cần một câu trả lời chat đơn lẻ, không thể chạy container, hoặc muốn thiết lập tối thiểu mà không cần workflow hiểu repository.

Cách dùng polyphony skill

Cài đặt và tải polyphony

Cài polyphony skill vào thư mục skills của bạn, rồi dùng nó từ workflow trên máy chủ có hỗ trợ nạp skill. Tài liệu repository cho biết skill này được thiết kế để tự động tải khi có khả năng cô lập bằng container, và là mặc định cho /spawn-team. Nếu cấu hình của bạn khác, hãy kiểm tra trước rằng có quyền truy cập Docker, có thể tạo nhánh, và workspace mount hoạt động bình thường rồi hãy dựa vào skill này.

Bắt đầu từ đúng file

Khi dùng polyphony, hãy mở skills/polyphony/SKILL.md trước, rồi đọc các phần ngữ cảnh được liên kết hoặc nhắc tới theo đúng thứ tự skill sử dụng nội bộ: vòng đời tác vụ, kiến trúc, điều kiện tiên quyết, cấu hình, và mọi tham chiếu riêng của repository được nhúng trong file. Vì repo này không có helper script hay thư mục tham chiếu bổ sung, hành vi cốt lõi nằm ngay trong file skill, nên đọc kỹ là rất quan trọng.

Biến mục tiêu thô thành prompt có thể dùng được

Một prompt polyphony tốt nên nêu rõ: repo đích, số lượng agent song song bạn muốn, loại công việc mỗi agent chịu trách nhiệm, kỳ vọng về branch hoặc PR, và mọi ràng buộc về test, thông tin xác thực, hay dọn dẹp. Ví dụ, thay vì nói “sửa dự án này,” hãy yêu cầu “chia issue thành ba tác vụ agent cô lập: tái hiện, vá lỗi, và xác minh, dùng các Docker workspace riêng và báo cáo trạng thái landing theo từng branch.”

Cần nêu gì để đầu ra tốt hơn

Hãy cho skill các tín hiệu định tuyến cụ thể: mức độ ưu tiên của tác vụ, phụ thuộc giữa các phần việc, có phải đọc-only trước hay không, môi trường nào có thể provision an toàn, và điều gì được tính là xác minh. Điều này giúp orchestrator chọn RunSpec tốt hơn và giảm số lần spin container lãng phí. Với hướng dẫn polyphony, đầu vào hữu ích nhất không phải thêm nhiều văn bản; mà là ranh giới tác vụ rõ ràng hơn.

Câu hỏi thường gặp về polyphony skill

polyphony có chỉ dành cho thiết lập Docker không?

Về thực tế là đúng. polyphony skill giả định có sẵn container isolation, nên hỗ trợ Docker hoặc OrbStack là rào cản tiếp nhận chính. Nếu bạn không thể provision container, workflow sẽ mất phần lớn giá trị của nó.

polyphony có khác gì một prompt bình thường không?

Có. Một prompt bình thường chỉ yêu cầu agent hành động; còn polyphony định nghĩa cách nhiều lần chạy agent được nhận việc, định tuyến, cấp phát môi trường, xác minh và landing. Cấu trúc đó chính là điểm của polyphony skill, nhất là khi các branch độc lập và luồng thực thi sạch quan trọng hơn tốc độ đơn thuần.

Người mới có dùng polyphony được không?

Có, nếu họ đã có thể chạy container và đọc một file skill. Đường cong học tập chính không nằm ở viết prompt; mà là hiểu rằng polyphony mong đợi việc chia nhỏ tác vụ và chuẩn bị sẵn môi trường. Người mới thường đạt kết quả tốt hơn khi bắt đầu với một tác vụ nhỏ và một mục tiêu xác minh thật rõ.

Khi nào không nên dùng polyphony?

Đừng dùng polyphony cho các câu hỏi ngắn mang tính một lần, chỉnh sửa nhẹ, hoặc môi trường không có Docker. Đây cũng là lựa chọn kém phù hợp khi tác vụ còn mơ hồ và bạn chưa xác định rõ từng agent sẽ chịu trách nhiệm phần nào, vì overhead của orchestration có thể lớn hơn lợi ích.

Cách cải thiện polyphony skill

Đưa ranh giới tác vụ rõ hơn cho router

Mức cải thiện chất lượng lớn nhất trong polyphony đến từ việc chia nhỏ tác vụ rõ ràng hơn. Hãy nói phần việc nào là khám phá, phần việc nào thay đổi code, và phần việc nào chỉ để xác minh. Nếu muốn song song hóa, hãy định nghĩa cách chia việc một cách tường minh thay vì để hệ thống tự suy ra từ một mục tiêu mơ hồ.

Thêm các ràng buộc ảnh hưởng đến hành vi workspace

Hãy nêu quy tắc đặt tên branch, giới hạn mạng, kỳ vọng thời gian chạy test, và việc có cần secrets hay mounted identities hay không. Vì polyphony dùng các container cô lập và các branch độc lập, những ràng buộc này ảnh hưởng trực tiếp đến provisioning và việc run có thể hoàn tất mà không cần can thiệp thủ công hay không.

Yêu cầu xác minh, không chỉ yêu cầu triển khai

Một lỗi thường gặp là dừng lại ở “code đã thay đổi.” Cách dùng polyphony tốt hơn sẽ yêu cầu bước tái hiện, lệnh test, và tiêu chí landing cho từng nhánh agent. Điều này đặc biệt quan trọng khi nhiều worker có thể đi đến các giải pháp khác nhau và bạn cần một quyết định merge đáng tin cậy.

Lặp lại sau lần chạy đầu tiên

Nếu kết quả đầu tiên quá rộng, hãy thu hẹp nhiệm vụ và chạy lại với một tiêu chí thành công duy nhất. Nếu kết quả quá phân mảnh, giảm số agent song song và thêm phụ thuộc chặt hơn giữa các giai đoạn. Với polyphony, cải thiện thường đến từ đầu vào orchestration sắc hơn, chứ không phải từ prompt dài hơn.