hand_off
Transfers a task card to another team agent in one step: assigns it, moves it to todo, records a comment, and releases your checkout. Use when another agent must do the next part.
Instructions
Give the card to another agent who must do the next part: assigns it to them, moves it to todo, writes the comment, cancels your active wait and releases your checkout, in one step instead of assign + move + release. The addressee must be an agent of the team directory. Use ask_agent when you only need their answer and keep the card.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"task_id": "<task_id>",
"to": "<to>",
"why": "<why>"
},
"name": "hand_off"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| to | Yes | Agent name or UUID from get_team_directory who takes the card. | |
| why | Yes | What they must do and what is already done, max 4000 chars. | |
| task_id | Yes | The card to hand over (UUID or 6-12 hex short id). | |
| turn_id | No | Optional turn id within the session (max 200 chars), copied onto the outcome. | |
| session_id | No | Optional runner session id (max 200 chars), copied onto the recorded outcome and wait. |