Skip to content

Adonis0123/adonis-skills / skills/agent-dispatch

agent-dispatch

Flagged

Choose the lightest agent setup for a coding, review, drafting or design-research task: do it yourself, fan out to 2-3 workers with independent parts across the Claude Code, Codex, Grok Build, Cursor or other CLIs and accounts on this machine, run a scoped architecture loop, or send one brief to independent researchers; pick a cross-model reviewer, test budget and cleanup; track dispatched work, external waits and user decisions on a Run Board. Use when work may need delegation, or the user asks to dispatch, fan out, parallelize, run several agents or accounts, get another AI's review or independent design opinions, or asks how dispatched work is going. Chinese triggers: 派活、并行、要不要多开几个 agent、分给多个 Claude 账号 / codex / grok、找另一个 AI 审、对比优秀设计、多方意见、进度看板、派出的任务进行到哪了。Not for unrelated read-only questions, trivial edits, research with no delegation, a single review of an existing diff (agentic-review-handoff), or the machine-wide session list (sideby sessions). Inside another named workflow, only size its workers.

FileKindSize
GLOSSARY.mdmarkdown2.1 KB
SKILL.mdskill md27.8 KB
evals/README.mdmarkdown7.6 KB
evals/README.zh-CN.mdmarkdown7.5 KB
evals/bench/compare.pyscript5.3 KB
evals/bench/run_bench.pyscript12.3 KB
evals/bench/tasks.jsonconfig6.6 KB
evals/bench/test_bench.pyscript4.4 KB
evals/build_plugin_eval.pyscript11.3 KB
evals/evals.jsonconfig31.4 KB
evals/results.mdmarkdown15.8 KB
evals/test_eval_harness.pyscript3.5 KB
evals/trigger-eval-set.jsonconfig1.6 KB
fixtures/probe-full.jsonconfig1.6 KB
fixtures/probe-single.jsonconfig690 B
fixtures/run-midrun/B9.jsonlother191 B
fixtures/run-midrun/deploy-log.txtmarkdown42 B
fixtures/run-midrun/run.jsonconfig1.8 KB
fixtures/run-sessions/B9.jsonlother191 B
fixtures/run-sessions/deploy-log.txtmarkdown42 B
fixtures/run-sessions/ended.jsonlother95 B
fixtures/run-sessions/run.jsonconfig2.1 KB
fixtures/run-sessions/sessions.jsonconfig804 B
fixtures/session-index.jsonconfig401 B
fixtures/sideby-stub/sessions.jsonconfig1.5 KB
fixtures/sideby-stub/sidebyexecutablescript4.1 KB
references/accounts.mdmarkdown10.4 KB
references/context-budget.mdmarkdown2.9 KB
references/fallbacks.mdmarkdown4.7 KB
references/launch.mdmarkdown16.1 KB
references/measure.mdmarkdown3.3 KB
references/research-brief.mdmarkdown1.3 KB
references/run-board.mdmarkdown48.7 KB
references/task-spec.mdmarkdown5.0 KB
scripts/board.cssother12.6 KB
scripts/board_interaction.jsscript3.7 KB
scripts/board_markdown.jsscript2.9 KB
scripts/board_render.pyscript17.2 KB
scripts/dispatch_board.pyscript95.3 KB
scripts/isolated_case.pyscript1.6 KB
scripts/probe_agents.pyscript12.9 KB
scripts/sideby_cli.pyscript3.2 KB
scripts/sideby_sessions.pyscript3.3 KB
scripts/test_billing_and_quota.pyscript10.9 KB
scripts/test_board_interaction.jsscript2.1 KB
scripts/test_board_markdown.jsscript2.9 KB
scripts/test_board_reload_state.jsscript2.7 KB
scripts/test_bug_regressions.pyscript4.7 KB
scripts/test_dispatch_board.pyscript68.9 KB
scripts/test_harness_limits.pyscript11.7 KB
scripts/test_lane_states.pyscript7.5 KB
scripts/test_probe_agents.pyscript19.2 KB
scripts/test_review_fixes.pyscript6.7 KB
scripts/test_rounds_and_watch.pyscript7.3 KB

scripts/sideby_sessions.py

View on GitHub
"""Optional sideby protocol. No shell, persistent cache, or clipboard writes."""
import os
import subprocess
import time
import threading
from sideby_cli import bounded_run, read_json


class SessionReader:
    def __init__(self, runner=None):
        self.runner = runner
        self.checked = None
        self.cached = None
        self.worker = None

    def read(self, now=None, background=False):
        now = time.monotonic() if now is None else now
        if self.checked is not None and now - self.checked < 15:
            return self.cached
        if self.worker and self.worker.is_alive():
            return self.cached
        self.checked = now
        if background:
            self.worker = threading.Thread(target=self._refresh, daemon=True)
            self.worker.start()
        else:
            self._refresh()
        return self.cached

    def close(self):
        if self.worker:
            self.worker.join()

    def _refresh(self):
        # Keep caching policy here; the adapter owns transport and validation.
        data = read_json(['sessions'], runner=self.runner)
        if data is not None:
            self.cached = data
        return self.cached


def parent_map(ps_output):
    """`pid ppid` lines from `ps -axo pid=,ppid=` as {pid: ppid}; malformed lines are skipped."""
    parents = {}
    for line in ps_output.splitlines():
        parts = line.split()
        if len(parts) < 2:
            continue
        try:
            parents[int(parts[0])] = int(parts[1])
        except ValueError:
            continue
    return parents


def ancestors_of(pid, parents, limit=64):
    """`pid` and its parents up to init, in order; stops on a cycle or an unknown pid."""
    chain = []
    while pid > 1 and pid not in chain and len(chain) < limit:
        chain.append(pid)
        pid = parents.get(pid, 0)
    return chain


def detect_coordinator(runner=bounded_run, pid=None):
    """Match only a Live Session owned by this process's ancestry, never account.

    One `ps` listing replaces one `ps` per ancestor: the chain is walked in memory.
    """
    try:
        data = read_json(['sessions'], runner=runner, timeout=5)
        if data is None:
            return None
        listing = runner(['ps', '-axo', 'pid=,ppid='], capture_output=True, text=True, timeout=5)
        if listing.returncode:
            return None
        ancestors = ancestors_of(os.getpid() if pid is None else pid, parent_map(listing.stdout))
        by_pid = {}
        for session in data.get('sessions', []):
            if isinstance(session, dict) and session.get('guessed') is False and isinstance(session.get('sessionId'), str) and isinstance(session.get('pid'), int):
                by_pid.setdefault(session['pid'], session['sessionId'])
        for pid in ancestors:
            if pid in by_pid:
                return by_pid[pid]
    except (OSError, ValueError, TypeError, subprocess.SubprocessError):
        pass
    return None


def session_label(session, fallback_title):
    """Prefer sideby's canonical label; support older producers in one place."""
    return session.get('label') or ' · '.join((session.get('accountLabel') or '账号未知',
                                              session.get('title') or fallback_title,
                                              session['sessionId'][:8]))
finishing-a-development-branchobra/superpowersUse when implementation is complete, all tests pass, and you need to decide how to integrate the workStars: 322kUpdated Claude CodeCodexVerifiedInstall
systematic-debuggingobra/superpowersUse when encountering any bug, test failure, or unexpected behavior, before proposing fixesStars: 322kUpdated Claude CodeCodexVerifiedInstall
test-driven-developmentobra/superpowersUse when implementing any feature or bugfix, before writing implementation codeStars: 322kUpdated Claude CodeCodexVerifiedInstall
skill-creatoranthropics/skillsCreate new skills, modify and improve existing skills, and measure skill performance. Use when users want to create a skill from scratch, edit, or optimize an existing skill, run evals to test a skill, benchmark skill performance with variance analysis, or optimize a skill's description for better triggering accuracy.Stars: 197kUpdated Claude CodeCodexVerifiedInstall