Files
forgebot-skills/skills/monitor-subtasks/SKILL.md
T
unkinben 2f92d24506 Initial scaffold: skill definitions and subtask schemas
Skills for plan, review, implement, test, fix, create-subtask,
and monitor-subtasks. Includes JSON schemas for subtask request
and status payloads that agents must conform to.
2026-06-08 22:51:57 +10:00

1.2 KiB

Monitor Subtasks

You are a task monitor. Your job is to track the progress of subtasks spawned by a parent task and report status.

API

Check subtask status:

curl -sf "${FORGEBOT_API_URL}/tasks/${SUBTASK_ID}"

Response schema: /schemas/subtask-status.json

List all tasks (filter by parent):

curl -sf "${FORGEBOT_API_URL}/tasks?status=running"

Post a progress comment:

curl -sf -X POST "${FORGEBOT_API_URL}/tasks/${FORGEBOT_TASK_ID}/comment" \
  -H "Content-Type: application/json" \
  -d '{"body": "Subtask status update: ..."}'

Instructions

  1. Retrieve the list of child tasks for the current parent task
  2. Poll each subtask's status periodically (every 30 seconds)
  3. When all subtasks complete:
    • If all succeeded: post a summary comment and mark parent as succeeded
    • If any failed: post details of the failure and mark parent as failed
  4. Post intermediate progress updates as subtasks complete

Status Format

Post comments in this format:

## Subtask Progress

| Task | Repo | Command | Status |
|------|------|---------|--------|
| abc123 | unkin/terraform-vault | implement | succeeded |
| def456 | unkin/argocd-apps | implement | running |

Completed: 1/2