spawn

Tổng quan về spawn skill

spawn làm gì

spawn là một AgentHub skill dùng để khởi chạy nhiều coding agent chạy song song trên cùng một tác vụ trong session. Thay vì yêu cầu một assistant giải quyết vấn đề theo từng bước tuần tự, spawn skill tạo N subagent trong các git worktree tách biệt để chúng có thể thử các chiến lược khác nhau mà không ghi đè thay đổi của nhau.

Hãy dùng skill này khi bạn đã khởi tạo AgentHub session và muốn khám phá song song cho các công việc triển khai, refactor, kiểm thử, tối ưu hóa hoặc sửa lỗi.

Phù hợp nhất cho Agent Orchestration

spawn for Agent Orchestration hữu ích nhất khi tác vụ có nhiều hơn một hướng giải quyết hợp lý. Skill này phù hợp với đội nhóm hoặc lập trình viên làm việc độc lập muốn để agent khám phá các phương án, so sánh kết quả và giảm rủi ro bị “neo” vào cách triển khai đầu tiên.

Các trường hợp phù hợp gồm tinh chỉnh hiệu năng, refactor lớn, điều tra lỗi chập chờn, bổ sung test coverage còn thiếu, và những thay đổi mã nguồn mà các cách tiếp cận độc lập có thể làm lộ rõ tradeoff.

Điểm khác biệt của spawn skill

Điểm khác biệt chính là khả năng cô lập kết hợp với cạnh tranh có cấu trúc. Mỗi agent làm việc trong git worktree riêng, giúp các chỉnh sửa song song được tách bạch và an toàn hơn khi so sánh về sau. Skill cũng hỗ trợ các template như optimizer, refactorer, test-writer, và bug-fixer, nhờ đó prompt điều phối có thể khớp với loại tác vụ kỹ thuật thay vì chỉ dùng một chỉ dẫn chung chung kiểu “solve this”.

Những điều cần cân nhắc trước khi áp dụng

Skill này giả định rằng bạn đã sử dụng workflow AgentHub xung quanh nó. Đây không phải là một package độc lập có thể chạy ngay từ bất kỳ repository nào mà không cần thiết lập. Đường dẫn repository chỉ chứa SKILL.md, vì vậy người dùng nên hiểu rằng định nghĩa skill phụ thuộc vào các quy ước và tham chiếu lân cận của AgentHub, bao gồm cấu hình session và các file template nằm ngoài thư mục skill.

Cách sử dụng spawn skill

Bối cảnh cài đặt spawn

Cài skill từ source repository bằng lệnh:

npx skills add alirezarezvani/claude-skills --skill spawn

Sau khi cài đặt, hãy xác nhận rằng môi trường của bạn hỗ trợ các lệnh AgentHub và một session đã được khởi tạo. Lệnh mà skill cung cấp là:

/hub:spawn

Quyết định cài spawn nên dựa trên việc bạn có cần các agent song song được điều phối hay không, chứ không chỉ vì muốn thêm một prompt shortcut. Nếu workflow của bạn không dùng git worktree hoặc cơ chế điều phối theo session, hãy xem lại thiết lập AgentHub tổng thể trước khi dựa vào skill này.

Cách dùng spawn cơ bản

Các dạng lệnh thường dùng:

/hub:spawn
/hub:spawn 20260317-143022
/hub:spawn --template optimizer
/hub:spawn --template refactorer

Dùng /hub:spawn cho session mới nhất. Truyền session ID khi bạn cần nhắm tới một AgentHub session cụ thể. Thêm --template <name> khi tác vụ được hưởng lợi từ một mô hình vận hành chuyên biệt.

Ý định của các template được skill hỗ trợ gồm:

• optimizer: lặp lại các vòng chỉnh sửa/đánh giá/giữ lại-hoặc-loại bỏ
• refactorer: tái cấu trúc, chạy test và lặp lại cho đến khi pass
• test-writer: thêm test và đo mức cải thiện coverage
• bug-fixer: tái hiện lỗi, chẩn đoán, sửa và xác minh

Input giúp agent tạo kết quả tốt hơn

Một prompt sử dụng spawn hiệu quả bắt đầu trước cả câu lệnh: tác vụ của session cần đủ cụ thể để nhiều agent có thể hành động độc lập và so sánh kết quả. Hãy nêu rõ các file mục tiêu, tiêu chí chấp nhận, lệnh test, ràng buộc và định nghĩa “tốt hơn” là gì.

Mục tiêu session yếu:

Improve the API code.

Mục tiêu session tốt hơn:

Refactor the user lookup API to reduce duplicate database calls without changing response shape.
Focus on src/api/users.ts and src/services/user-cache.ts.
Run npm test -- users and npm run lint.
Preserve public types. Prefer minimal changes unless an agent can prove a cleaner design with tests.

Cách viết này cho các agent được spawn một mục tiêu chung, đồng thời vẫn chừa không gian cho những chiến lược khác nhau.

Các file nên đọc trước khi chạy

Bắt đầu với SKILL.md trong engineering/agenthub/skills/spawn. Sau đó kiểm tra các tài liệu AgentHub lân cận được skill tham chiếu, đặc biệt là tài liệu thiết lập session và agent-templates.md nếu có trong repository đã cài. Những chi tiết quan trọng nhất cần xác minh là cách đặt tên session, cách chọn N agent, worktree được tạo ở đâu, và quy trình so sánh cuối cùng hoặc chọn phương án để merge diễn ra như thế nào.

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

Khi nào nên dùng spawn thay vì prompt thông thường?

Dùng spawn khi việc khám phá song song thực sự có giá trị. Một prompt thông thường thường là đủ cho các chỉnh sửa nhỏ, thay đổi tài liệu hoặc tác vụ chỉ có một đáp án rõ ràng. spawn skill phù hợp hơn khi các chiến lược triển khai, thiết kế test hoặc giả thuyết debug khác nhau có thể dẫn tới kết quả khác biệt đáng kể.

spawn có thân thiện với người mới không?

Chỉ thân thiện với người mới nếu bạn đã hiểu workflow AgentHub xung quanh và hành vi cơ bản của git worktree. Bản thân câu lệnh khá đơn giản, nhưng mô hình vận hành thì nâng cao hơn: nhiều agent sẽ tạo ra các thay đổi riêng biệt cần được review, kiểm thử và lựa chọn.

Điều gì có thể cản trở việc dùng spawn thành công?

Các rào cản chính gồm AgentHub session chưa được khởi tạo, định nghĩa tác vụ không rõ ràng, thiếu lệnh test, và repository không an toàn cho các thay đổi song song qua worktree. Một giới hạn khác là thư mục skill rất tối giản; ngữ cảnh điều phối hữu ích nằm trong hệ thống AgentHub rộng hơn, vì vậy không nên đánh giá nó như một công cụ hoàn toàn tự chứa.

Khi nào spawn là lựa chọn không phù hợp?

Tránh dùng spawn cho xử lý secrets, các thao tác production không thể đảo ngược, sửa lỗi một dòng rất nhỏ, hoặc các tác vụ mà việc nhiều agent làm trùng lặp tạo thêm nhiễu thay vì insight. Skill này cũng không phù hợp khi bạn không thể chạy test hoặc so sánh kết quả, vì giá trị của các agent song song phụ thuộc vào việc lựa chọn dựa trên bằng chứng.

Cách cải thiện spawn skill

Làm cho prompt spawn dễ so sánh hơn

Để có kết quả tốt hơn từ spawn, hãy xác định các thước đo thành công mà mọi agent đều có thể tối ưu theo. Tiêu chí so sánh tốt có thể gồm test pass, runtime giảm, diff nhỏ hơn, ranh giới API rõ hơn, coverage cải thiện, hoặc bằng chứng tái hiện lỗi. Nếu không có tiêu chí chung, các kết quả song song sẽ rất khó đánh giá.

Chủ động phân công các chiến lược khác nhau

Hướng dẫn template của skill phát huy tốt nhất khi mỗi agent nhận một chiến lược khác nhau. Với một lỗi cần sửa, một agent có thể bắt đầu từ việc tái hiện lỗi, agent khác từ lịch sử git gần đây, và agent khác từ test cho các điều kiện biên. Với tối ưu hóa, một agent có thể giảm allocation, agent khác thử cache, và agent khác thay đổi độ phức tạp thuật toán. Sự đa dạng chính là mục đích của spawn skill.

Tránh các lỗi thường gặp

Các lỗi thường gặp gồm spawn agent trên mục tiêu mơ hồ, để tất cả agent đi theo cùng một kế hoạch, bỏ qua bước xác minh, và merge phương án trông có vẻ lớn nhất thay vì phương án có bằng chứng tốt nhất. Hãy giới hạn phạm vi tác vụ, yêu cầu lệnh test, và đề nghị agent tóm tắt cách tiếp cận, tradeoff, file đã thay đổi và kết quả xác minh.

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

Sau lần chạy đầu tiên, hãy so sánh các worktree trước khi merge. Giữ lại ứng viên mạnh nhất, loại bỏ các branch yếu, hoặc chạy vòng spawn thứ hai dựa trên những gì bạn đã học được. Một chỉ dẫn follow-up hữu ích là:

Use the best result from agent 2 as the baseline.
Spawn new agents to improve reliability and reduce diff size.
All agents must preserve the public API and run the same test command.

Cách này biến spawn từ một cuộc thi một lần thành một vòng lặp điều phối agent thực tế.