fleet-task-update
Update a Mission Control task status with proper workflow steps. Use when accepting, progressing, completing, or blocking a task. Triggers on: "update task", "accept task", "complete task", "task done
SKILL.md.agents/skills/fleet-task-update/SKILL.md
GitHubFleet Task Update
Update Mission Control task status following the fleet workflow.
When to Use
At every task lifecycle transition: accept → progress → complete/block.
Task States
inbox → in_progress → review → done
→ blocked (post comment explaining why)
Workflow
1. Accept Task (inbox → in_progress)
curl -s -X PATCH "$BASE_URL/api/v1/agent/boards/$BOARD_ID/tasks/$TASK_ID" \
-H "X-Agent-Token: $AUTH_TOKEN" -H "Content-Type: application/json" \
-d '{"status": "in_progress", "comment": "Starting work: <brief plan>."}'
2. Post Progress (while in_progress)
curl -s -X POST "$BASE_URL/api/v1/agent/boards/$BOARD_ID/tasks/$TASK_ID/comments" \
-H "X-Agent-Token: $AUTH_TOKEN" -H "Content-Type: application/json" \
-d '{"message": "Progress: <what was done so far>."}'
3. Complete Task (in_progress → review)
This is a multi-step process. Do ALL steps in order.
3a. Push branch to remote
git push -u origin fleet/<agent>/<task-short>
3b. Create Pull Request
gh pr create \
--title "fleet(<agent>): <task-title>" \
--body "## Fleet Task: <task-title>
**Task ID:** \`<task-id>\`
**Agent:** <agent-name>
**Board:** Fleet Operations
### Changes
$(git diff --stat origin/main..HEAD)
### Summary
<what was done and why>
---
Generated by [OpenClaw Fleet](https://github.com/cyberpunk042/openclaw-fleet)"
Save the PR URL from the output.
3c. Post completion comment with PR link
curl -s -X POST "$BASE_URL/api/v1/agent/boards/$BOARD_ID/tasks/$TASK_ID/comments" \
-H "X-Agent-Token: $AUTH_TOKEN" -H "Content-Type: application/json" \
-d '{"message": "**Completed**\n\nPR: <PR_URL>\nBranch: fleet/<agent>/<task-short>\nCommits: <N>\nFiles changed: <list>\n\nSummary: <what was done>."}'
3d. Update task status
curl -s -X PATCH "$BASE_URL/api/v1/agent/boards/$BOARD_ID/tasks/$TASK_ID" \
-H "X-Agent-Token: $AUTH_TOKEN" -H "Content-Type: application/json" \
-d '{"status": "review", "comment": "Ready for review. PR: <PR_URL>"}'
4. Report Blocker (when blocked)
Don't change status — post a comment explaining the blocker:
curl -s -X POST "$BASE_URL/api/v1/agent/boards/$BOARD_ID/tasks/$TASK_ID/comments" \
-H "X-Agent-Token: $AUTH_TOKEN" -H "Content-Type: application/json" \
-d '{"message": "**Blocked**: <reason>.\n\nNeeded: <what would unblock>."}'
Prerequisites
- Read TOOLS.md at session start for
AUTH_TOKEN,BASE_URL,BOARD_ID - Task ID comes from the task assignment message
- Always read the task description before starting work
Rules
- Always accept before doing work (inbox → in_progress)
- Always post a completion comment with branch/commits/files
- Never skip straight to done without posting what was done
- Never leave a task in_progress without progress comments
- If blocked, say WHY and what you need — don't silently fail