team-composition-patterns

## Tổng quan về kỹ năng team-composition-patterns
team-composition-patterns là kỹ năng ra quyết định để thiết kế đội đa tác tử trong Claude Code Agent Teams, bao gồm heuristics về quy mô đội, chọn subagent_type theo vai trò và lựa chọn display mode. Phù hợp nhất cho builder cần cấu hình đội lặp lại cho review, debug hoặc delivery tính năng, thay vì kiểu “spawn vài agent” tùy hứng.

### team-composition-patterns giúp bạn quyết định điều gì
Kỹ năng này giải quyết ba rào cản khi áp dụng: dùng bao nhiêu agent, subagent_type nào phù hợp từng vai trò, và display mode nào hợp với môi trường (tmux, iTerm2, in‑process).

### Tình huống phù hợp nhất và kết quả mong đợi
Dùng khi bạn cần đội hình nhất quán cho các tác vụ như code review, điều tra lỗi, hoặc triển khai tính năng, và muốn có team preset tái sử dụng thay vì nghĩ lại vai trò mỗi lần.

### Điểm khác biệt so với prompt chung chung
Không giống các prompt kiểu “create a team”, kỹ năng này chuẩn hóa heuristics về kích cỡ đội, cấu hình preset và ma trận quyết định subagent_type gắn với năng lực từng agent.

### Khi không phù hợp
Nếu bạn không dùng Claude Code Agent Teams hoặc chỉ cần một trợ lý cho tác vụ đơn giản, kỹ năng này sẽ tạo thêm overhead mà không rõ lợi ích.

## Cách dùng kỹ năng team-composition-patterns
### Cài đặt team-composition-patterns và điểm vào chính
Cài kỹ năng bằng: `npx skills add https://github.com/wshobson/agents --skill team-composition-patterns`. Hướng dẫn cốt lõi nằm ở `plugins/agent-teams/skills/team-composition-patterns/SKILL.md`.

### Đọc các file này trước khi quyết định áp dụng
Bắt đầu với `SKILL.md`, sau đó đọc `references/agent-type-selection.md` để hiểu ma trận quyết định subagent_type và `references/preset-teams.md` để xem các đội preset và task template có sẵn.

### Các input mà kỹ năng cần bạn cung cấp
Cung cấp loại tác vụ (review/debug/feature/migration), mức độ phức tạp, ràng buộc môi trường (CI vs local), và liệu agent có cần quyền ghi hay không. Những yếu tố này ánh xạ trực tiếp tới quy mô đội và lựa chọn subagent_type.

### Biến mục tiêu thô thành prompt mạnh
Yếu: “spawn a team to review this PR.”  
Mạnh: “Review 6-file diff touching auth and caching; prioritize security and performance; local dev; need file:line findings and fixes.” Điều này giúp kỹ năng chọn preset team review và các chiều đánh giá phù hợp.

### Dùng heuristics quy mô đội để tránh thiếu/thừa agent
Khớp độ phức tạp với quy mô đội: simple (1–2), moderate (2–3), complex (3–4+). Đội lớn hữu ích khi cần nhiều chiều đánh giá (security + performance + architecture), không chỉ vì code nhiều.

### Dùng ma trận quyết định agent type
Sử dụng `references/agent-type-selection.md` để chọn subagent_type. Ví dụ: code review → `agent-teams:team-reviewer`; bug investigation → `agent-teams:team-debugger`; khám phá kiến trúc không chỉnh sửa → Plan hoặc Explore.

### Ưu tiên áp dụng preset team composition
Các định nghĩa preset team (review/debug) là con đường nhanh nhất tạo giá trị. Chúng gồm vai trò thành viên, trọng tâm đánh giá và task template có cấu trúc để mỗi agent có một chiều rõ ràng và định dạng output nhất quán.

### Chọn display mode theo môi trường
Nếu cần nhiều output đồng thời và bạn chịu được nhiều pane terminal, nên dùng tmux. Với thiết lập nhẹ hơn, iTerm2 hoặc in‑process giúp giảm ma sát.

### Quy trình gợi ý khi dùng team-composition-patterns
1) Phân loại tác vụ và độ phức tạp.  
2) Chọn preset team hoặc tự ghép team theo các chiều.  
3) Gán subagent_type cho từng vai trò.  
4) Chọn display mode theo môi trường.  
5) Cung cấp task template có cấu trúc cho từng teammate.

## FAQ về kỹ năng team-composition-patterns
### Kỹ năng team-composition-patterns chỉ dùng cho Claude Code Agent Teams?
Đúng. Nó được thiết kế quanh các khái niệm như subagent_type và display mode. Nếu không có môi trường đó, hướng dẫn sẽ kém khả dụng.

### Nó khác gì so với prompt “create a team” thông thường?
Nó đưa ra quy tắc quyết định quy mô đội, ma trận chọn agent type, và các preset team kèm task template—những thứ mà prompt chung thường không có.

### Có thân thiện với người mới không?
Có, nếu bạn theo các preset team. Ma trận quyết định có thể hơi dày, nhưng giúp tránh lỗi phổ biến như gán quyền ghi cho agent chỉ dùng để khám phá.

### Khi nào nên tránh dùng?
Tránh dùng cho tác vụ một lần, rủi ro thấp, nơi một agent tổng quát là đủ. Overhead điều phối có thể vượt lợi ích.

### Có hỗ trợ workflow tùy biến như migration hay audit không?
Có. Kỹ năng có đề cập rõ các workflow không chuẩn; bạn sẽ tự xây đội bằng cách kết hợp các chiều và chọn subagent_type phù hợp.

## Cách cải thiện kỹ năng team-composition-patterns
### Cung cấp chiều tác vụ rõ ràng để thiết kế đội tốt hơn
Nêu rõ các chiều review (security, performance, architecture, testing). Các chiều rõ ràng giúp kỹ năng ánh xạ đúng preset reviewer roles và giảm trùng lặp.

### Tránh các failure mode phổ biến
Failure mode: chọn sai subagent_type (ví dụ dùng Plan cho tác vụ cần chỉnh sửa). Cách sửa là nói rõ agent có cần ghi file không và dùng ma trận quyết định.

### Dùng bối cảnh input mạnh hơn để cải thiện output
Thêm chỉ báo phạm vi như “multi-file change”, “cross-cutting concern”, hoặc “CI-only environment.” Chúng làm thay đổi khuyến nghị về quy mô đội và display mode.

### Lặp lại sau đề xuất đội đầu tiên
Nếu kết quả hời hợt, thêm một chiều còn thiếu (ví dụ accessibility) hoặc tăng quy mô đội thêm một. Nếu phản hồi bị trùng, giảm quy mô đội hoặc thu hẹp phạm vi.

### Tạo template tái sử dụng cho tổ chức của bạn
Điều chỉnh các preset task template trong `references/preset-teams.md` theo quy ước repo của bạn (file path, định dạng output, mức độ severity). Điều này biến hướng dẫn team-composition-patterns thành workflow nội bộ đáng tin cậy.

### Dùng team-composition-patterns cho quyết định điều phối Agent Orchestration
Khi điều phối nhiều tác vụ song song, dùng kỹ năng này để chuẩn hóa vai trò và năng lực, đảm bảo phối hợp đúng reviewer, debugger, implementer và lead agent cho từng luồng.