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

GitHub

Fleet 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