Skip to main content

coding-assign

Balance-assign a pending issue to a coding worker (vm01-vm0N) based on current workload.

Jump to install

Source facts

Repository
okou-ai/team-skills
Last source activity
April 2, 2026 at 03:32
Detected SKILL.md language
English
Stars
1
Forks
2

Install options

The review-first prompt is selected by default. You can switch to a direct command or download a local copy.

Review the source files

Read SKILL.md and any companion files shown by SkillsMP before deciding whether to install.

Showing SKILL.md

SKILL.md
Source instructions · Read-only preview
name
coding-assign
description
Balance-assign a pending issue to a coding worker (vm01-vm0N) based on current workload.
context
fork
# Coding Assign Assigns the current working issue to a coding worker label (`vm01`–`vm0N`) using load balancing, ensuring even distribution of issues across workers. ## Arguments Your args are: `$ARGUMENTS` The first argument is the **maximum number of workers** (optional, defaults to **4**). For example, `coding-assign 8` means workers `vm01` through `vm08`. ```bash # Example: /coding-assign 8 MAX_WORKERS=8 # Example: /coding-assign (no args — defaults to 4) MAX_WORKERS=4 ``` If no argument is provided, default to `MAX_WORKERS=4` (uniform distribution across `vm01`–`vm04`). ## Prerequisites This skill expects a **current working issue** in the conversation context. If no issue has been discussed, ask the user for the issue number. --- ## Workflow ### Step 1: Parse Arguments and Identify Issue 1. Parse the max worker count from arguments. 2. Identify the current issue number from conversation context. 3. Validate both are present. ```bash MAX_WORKERS=<parsed from args> ISSUE=<from conversation context> ``` ### Step 2: Get Current User ```bash ME=$(gh api user --jq '.login') ``` ### Step 3: Count Issues and PRs Per Worker Fetch all lane data in a single parallel call: ```bash FIRST_LANE=$(printf "vm%02d" 1) LAST_LANE=$(printf "vm%02d" $MAX_WORKERS) LANES=$(${CLAUDE_PLUGIN_ROOT}/scripts/lane-status.sh "${FIRST_LANE}-${LAST_LANE}" --user "$ME") ``` This queries all lanes **in parallel** and returns issue/PR counts per lane. Extract the load per lane: ```bash echo "$LANES" | jq '.[] | {lane, issue_count, pr_count, total}' ``` ### Step 4: Select Least-Loaded Worker Pick the worker label with the lowest total (issues + PRs). Prefer workers with **zero** total items. If there's a tie, pick the lowest-numbered worker. ### Step 5: Update Issue Labels 1. **Remove `pending` label** (if present): ```bash gh issue edit $ISSUE --remove-label "pending" ``` 2. **Add the selected worker label**: ```bash gh issue edit $ISSUE --add-label "$SELECTED_LABEL" ``` 3. **Ensure the label exists** — if the label doesn't exist yet, create it: ```bash gh label create "$SELECTED_LABEL" --description "Coding worker $SELECTED_LABEL" --color 0E8A16 2>/dev/null || true ``` ### Step 6: Report Output a summary: ``` Issue #<NUMBER> assigned to worker <LABEL> Worker load (issues + PRs): vm01: 3 (issues: 2, PRs: 1) vm02: 0 (issues: 0, PRs: 0) <-- assigned here vm03: 3 (issues: 1, PRs: 2) ... ``` --- ## Key Rules - **Always pick the least-loaded worker** — balance is the primary goal - **Break ties by lowest number** — prefer `vm01` over `vm02` when equal - **Remove `pending` label** — the issue is no longer waiting for human input - **Create labels on demand** — if `vm0N` label doesn't exist, create it - **One label per issue** — do not add multiple worker labels; if the issue already has a different worker label, remove it first
View on GitHub