Điều phối teammate trực tiếp với ak:team

Dùng ak:team khi các teammate session độc lập cần phối hợp qua lead, shared work state và direct message. Skill giữ decomposition, ownership, integration, verification, shutdown cùng cleanup thuộc trách nhiệm lead.

Chọn ak:team cho live collaboration

Dùng ak:team khi

• Ba hoặc nhiều workstream độc lập hưởng lợi từ context riêng.
• Reviewer cần specialty khác nhau và finding phải được hòa giải.
• Debugger cần challenge các hypothesis cạnh tranh, có thể kiểm thử.
• Cross-layer implementation tách được thành ownership không chồng lấn.
• Teammate cần direct communication liên tục thay vì một final handoff.

Chọn workflow khác khi

• Một focused test, lint, scout hoặc review có thể trả thẳng cho caller. Dùng ordinary subagent hoặc Skill có ownership.
• Công việc là chuỗi tuần tự plan-to-code-to-test.
• Job cần live runtime diversity, headless capture, resumable state và arbiter. Dùng ak:orchestrate.
• Nhiều writer cần cùng tệp và không thể tách an toàn.

Chuẩn bị runtime và workspace

Trước khi bắt đầu:

• Hoàn thành Làm quen và xác nhận Engineer Kit đã được cài cho runtime cùng scope đang dùng.
• Xác minh live runtime cung cấp team creation, shared work, delegation, messaging, waiting, shutdown và cleanup.
• Xác định một outcome, acceptance criteria, project instruction, report hoặc plan destination và Git authority boundary.
• Chia implementation file thành ownership không chồng lấn trước khi spawn writer.
• Dùng Git repository khi implementation teammate cần worktree.

Capability name, parameter, model routing, limit, permission, isolation và cleanup behavior hiện tại phải được khám phá trong lần chạy.

Chạy Skill

/ak:team review "Review the checkout change for security, accessibility, and failure-path coverage; return evidence only" --reviewers 3 --delegate

/ak:team review "Review the checkout change for security, accessibility, and failure-path coverage; return evidence only" --reviewers 3 --delegate

Mô tả team rõ ràng

Một team request hữu ích gồm:

• Outcome: Nêu combined result lead phải giao.
• Workstreams: Nêu research angle, review focus, hypothesis hoặc implementation group độc lập.
• Ownership: Giao tệp hoặc glob riêng cho từng writer.
• Dependencies: Nêu verification hoặc integration work nào chờ implementation scope nào.
• Evidence: Xác định report, diff, test hoặc finding format cần từ từng teammate.
• Authority boundary: Nêu có cho phép commit, push, merge, external service, credential, destructive action hoặc deployment không.

Teammate không kế thừa toàn bộ conversation của lead. Mỗi teammate chỉ nhận workspace, instruction, active requirement, ownership, dependency và acceptance criteria cần cho scope của mình.

Hiểu team lifecycle

1. Lead phân rã request. Lead tạo work thực sự độc lập với output rõ và ownership không chồng lấn.
2. Lead khám phá và tạo team. Thiếu lifecycle capability sẽ dừng workflow; không kích hoạt hidden substitute.
3. Lead đăng ký shared work. Mỗi item có acceptance criteria, dependency, owner và durable destination.
4. Lead spawn teammate. Scope độc lập chạy concurrent. Concurrent writer dùng isolation được yêu cầu khi khả dụng và vẫn giữ ownership riêng.
5. Lead coordinate qua live state và message. Idle nghĩa là đang chờ, không phải hoàn tất. Stale owner được liên hệ trước reassignment.
6. Lead chỉ integration prerequisite đã hoàn tất. Trong delegate mode, teammate được giao thực hiện implementation command và integration work.
7. Lead xác minh combined result. Completion message là handoff, không phải proof; integrated check cùng review vẫn chạy.
8. Lead shutdown và cleanup. Lead yêu cầu graceful shutdown, chờ acknowledgement hoặc blocked handoff rồi dùng live cleanup capability.

Giữ quyền phê duyệt và an toàn ở bạn

Worktree isolation không thay ownership và không phải operating-system sandbox. Nếu hai teammate cần cùng tệp, dừng và tái cấu trúc work hoặc giao một integration owner.

--delegate giới hạn lead; cờ không mở rộng authority của teammate. Nêu rõ teammate có được commit hoặc push không. Không suy ra publication, deployment, credential use, destructive change hay access tệp không liên quan từ team request hoặc worktree flag.

Khi bật plan approval, teammate giữ read-only đến khi lead chấp nhận scope, ownership, validation, risk và rollback note qua live approval surface.

Xác minh kết quả

Một team run hoàn tất nên cung cấp:

• Shared work item với owner, dependency, status và acceptance criteria.
• Một report hoặc change set có giới hạn cho mỗi teammate.
• Evidence-based review finding hoặc debugging hypothesis, gồm disagreement đã giải quyết hoặc được giữ lại.
• Integrated test cùng review cho implementation work.
• Documentation-impact decision rõ cho template cook.
• Final synthesis với completed, blocked, reassigned work cùng unresolved question.
• Graceful teammate shutdown và live team cleanup, hoặc cleanup error chính xác cùng recovery guidance hiện tại.

Xem teammate message là progress evidence. Chỉ shared state, artifact đã kiểm tra và integrated verification mới thiết lập completion.

Xử lý sự cố hoặc tiếp tục

So sánh ak:orchestrate cho captured headless job, hoặc tiếp tục với Engineer Kit và Runtime adapter.

Biết các giới hạn hiện tại

• Chỉ các adapter được hỗ trợ mới chiếu Skill này, và Skill cần live team surface. Codex không chiếu Skill; runtime khác abort khi thiếu live capability bắt buộc.
• Model list, limit, permission, isolation, display mode, memory, resume và cleanup behavior do runtime sở hữu và phải được kiểm tra trực tiếp.
• Persistent teammate memory chỉ dùng khi runtime cung cấp và project policy cho phép.
• Parallelism chỉ giúp khi scope độc lập; coordination có thể tốn hơn short sequential work.