Adonis0123/adonis-skills / skills/agent-dispatch
agent-dispatch
FlaggedChoose 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.
scripts/test_probe_agents.py
View on GitHub#!/usr/bin/env python3
"""Tests for agent-dispatch probe discovery."""
from __future__ import annotations
import json
import os
import sys
import tempfile
import unittest
from unittest import mock
SCRIPT_DIR = os.path.dirname(os.path.abspath(__file__))
if SCRIPT_DIR not in sys.path:
sys.path.insert(0, SCRIPT_DIR)
from isolated_case import IsolatedTestCase
import probe_agents
class TestProbeAgents(IsolatedTestCase):
def setUp(self):
super().setUp()
patch = mock.patch.object(probe_agents.SessionReader, "read", return_value=None)
patch.start()
self.addCleanup(patch.stop)
def test_accounts_file_with_two_pools(self):
with tempfile.TemporaryDirectory() as tmpdir:
acc_file = os.path.join(tmpdir, "accounts.json")
with open(acc_file, "w", encoding="utf-8") as f:
json.dump(
{
"accounts": [
{"product": "claude", "command": "claude", "pool": "personal"},
{"product": "claude", "command": "CLAUDE_CONFIG_DIR=~/.claude-work claude", "pool": "work"},
]
},
f,
)
with mock.patch.dict(
os.environ,
{
"AGENT_DISPATCH_ACCOUNTS": acc_file,
"PATH": tmpdir,
},
clear=True,
):
with mock.patch("probe_agents.ADAPTERS", []):
result = probe_agents.probe()
self.assertEqual(result["source"], "accounts_file")
self.assertIn("claude", result["products"])
self.assertEqual(result["products"]["claude"]["quota_pools"], 2)
self.assertEqual(len(result["products"]["claude"]["accounts"]), 2)
self.assertEqual(result["products"]["claude"]["accounts"][0]["command"], "claude")
self.assertEqual(result["products"]["claude"]["accounts"][0]["pool"], "personal")
self.assertEqual(
result["products"]["claude"]["accounts"][1]["command"],
"CLAUDE_CONFIG_DIR=~/.claude-work claude",
)
self.assertEqual(result["products"]["claude"]["accounts"][1]["pool"], "work")
# 2 pools x 3 sessions, minus the coordinator, capped at 3
self.assertEqual(result["max_parallel_workers"], 3)
def test_same_pool_counted_once(self):
with tempfile.TemporaryDirectory() as tmpdir:
acc_file = os.path.join(tmpdir, "accounts.json")
with open(acc_file, "w", encoding="utf-8") as f:
json.dump(
{
"accounts": [
{"product": "claude", "command": "claude", "pool": "shared"},
{"product": "claude", "command": "CLAUDE_CONFIG_DIR=~/.claude-alt claude", "pool": "shared"},
]
},
f,
)
with mock.patch.dict(
os.environ,
{
"AGENT_DISPATCH_ACCOUNTS": acc_file,
"PATH": tmpdir,
},
clear=True,
):
with mock.patch("probe_agents.ADAPTERS", []):
result = probe_agents.probe()
self.assertIn("claude", result["products"])
self.assertEqual(result["products"]["claude"]["quota_pools"], 1)
self.assertEqual(len(result["products"]["claude"]["accounts"]), 2)
# one pool still hosts 2 workers beside the coordinator
self.assertEqual(result["max_parallel_workers"], 2)
def test_path_only_fallback(self):
with tempfile.TemporaryDirectory() as tmpdir:
bin_dir = os.path.join(tmpdir, "bin")
os.makedirs(bin_dir)
fake_claude = os.path.join(bin_dir, "claude")
with open(fake_claude, "w", encoding="utf-8") as f:
f.write("#!/bin/sh\nexit 0\n")
os.chmod(fake_claude, 0o755)
with mock.patch.dict(
os.environ,
{
"HOME": os.path.join(tmpdir, "home"),
"XDG_CONFIG_HOME": os.path.join(tmpdir, "config"),
"PATH": bin_dir,
},
clear=True,
):
result = probe_agents.probe()
self.assertEqual(result["source"], "path")
self.assertEqual(result["code_products"], ["claude"])
self.assertEqual(result["max_parallel_workers"], 2)
self.assertEqual(result["products"]["claude"]["quota_pools"], 1)
self.assertEqual(result["products"]["claude"]["accounts"][0]["command"], "claude")
self.assertIn("single-product: reviewer is a fresh session of the same product", result["fallback"][0])
def test_api_key_accounts_excluded_from_manager_kept_in_accounts_file(self):
# 1. Manager adapter excludes API-key accounts
manager_data = {
"accounts": [
{
"family": "claude",
"ref": "claude:acc1",
"hostInstalled": True,
"login": "logged-in",
"kind": "subscription",
},
{
"family": "claude",
"ref": "claude:acc2",
"hostInstalled": True,
"login": "not-needed",
"kind": "api",
},
{
"family": "claude",
"ref": "claude:acc3",
"hostInstalled": True,
"login": "logged-in",
"kind": "api",
},
]
}
with mock.patch("shutil.which", return_value="/usr/local/bin/manager"):
with mock.patch("sideby_cli.bounded_run") as mock_run:
mock_run.return_value = mock.Mock(
stdout=json.dumps(manager_data), returncode=0
)
manager_adapter = probe_agents.ADAPTERS[0]
mgr_result = manager_adapter()
self.assertIsNotNone(mgr_result)
accounts, _ = mgr_result
# Only subscription account kept; api accounts excluded
self.assertEqual(len(accounts), 1)
self.assertEqual(accounts[0]["product"], "claude")
self.assertIn("claude:acc1", accounts[0]["command"])
# 2. When listed in accounts file, API-key account is kept
with tempfile.TemporaryDirectory() as tmpdir:
acc_file = os.path.join(tmpdir, "accounts.json")
with open(acc_file, "w", encoding="utf-8") as f:
json.dump(
{
"accounts": [
{"product": "claude", "command": "CLAUDE_API_KEY=test claude", "pool": "api"}
]
},
f,
)
with mock.patch.dict(
os.environ,
{
"AGENT_DISPATCH_ACCOUNTS": acc_file,
"PATH": tmpdir,
},
clear=True,
):
with mock.patch("probe_agents.ADAPTERS", []):
result = probe_agents.probe()
self.assertIn("claude", result["products"])
self.assertEqual(len(result["products"]["claude"]["accounts"]), 1)
self.assertEqual(result["products"]["claude"]["accounts"][0]["command"], "CLAUDE_API_KEY=test claude")
self.assertEqual(result["products"]["claude"]["accounts"][0]["pool"], "api")
def _probe_with_file(self, payload: dict, env: dict | None = None) -> dict:
with tempfile.TemporaryDirectory() as tmpdir:
acc_file = os.path.join(tmpdir, "accounts.json")
with open(acc_file, "w", encoding="utf-8") as f:
json.dump(payload, f)
with mock.patch.dict(
os.environ,
{"AGENT_DISPATCH_ACCOUNTS": acc_file, "PATH": tmpdir, **(env or {})},
clear=True,
):
with mock.patch("probe_agents.ADAPTERS", []):
return probe_agents.probe()
FOUR_CLAUDE = {
"accounts": [
{"id": "claude:001", "product": "claude", "command": "sideby run claude:001", "pool": "p1"},
{"id": "claude:main", "product": "claude", "command": "sideby run claude:main", "pool": "p1"},
{"id": "claude:002", "product": "claude", "command": "sideby run claude:002", "pool": "p2"},
{"id": "claude:003", "product": "claude", "command": "sideby run claude:003", "pool": "p3"},
{"id": "codex:002", "product": "codex", "command": "sideby run codex:002", "pool": "c2"},
]
}
def test_default_three_sessions_per_pool_capped_batch(self):
result = self._probe_with_file(self.FOUR_CLAUDE)
self.assertEqual(result["sessions_per_pool"], 3)
self.assertEqual(result["allow"], [])
# 3 claude pools + 1 codex pool, coordinator keeps one, capped at 3
self.assertEqual(result["max_parallel_workers"], 3)
self.assertEqual(result["products"]["claude"]["accounts"][0]["id"], "claude:001")
def test_sessions_per_pool_from_file_lifts_cap(self):
payload = {**self.FOUR_CLAUDE, "sessions_per_pool": 2}
result = self._probe_with_file(payload)
self.assertEqual(result["sessions_per_pool"], 2)
# 4 pools x 2 sessions, minus the coordinator's own slot
self.assertEqual(result["max_parallel_workers"], 7)
def test_sessions_per_pool_env_overrides_file_and_ignores_bad_values(self):
payload = {**self.FOUR_CLAUDE, "sessions_per_pool": 3}
result = self._probe_with_file(payload, {"AGENT_DISPATCH_SESSIONS_PER_POOL": "2"})
self.assertEqual(result["sessions_per_pool"], 2)
result = self._probe_with_file(payload, {"AGENT_DISPATCH_SESSIONS_PER_POOL": "zero"})
self.assertEqual(result["sessions_per_pool"], 3)
result = self._probe_with_file({**self.FOUR_CLAUDE, "sessions_per_pool": 0})
self.assertEqual(result["sessions_per_pool"], 3)
# an explicit 1 keeps the old one-session-per-pool behavior
result = self._probe_with_file(self.FOUR_CLAUDE, {"AGENT_DISPATCH_SESSIONS_PER_POOL": "1"})
self.assertEqual(result["sessions_per_pool"], 1)
self.assertEqual(result["max_parallel_workers"], 3)
def test_one_pool_with_several_sessions_runs_in_parallel(self):
payload = {
"accounts": [{"id": "claude:001", "product": "claude", "command": "claude", "pool": "p1"}],
"sessions_per_pool": 2,
}
result = self._probe_with_file(payload)
self.assertEqual(result["max_parallel_workers"], 1)
self.assertTrue(any("share one rate limit" in f for f in result["fallback"]))
self.assertFalse(any("one after another" in f for f in result["fallback"]))
def test_allow_list_in_file_filters_accounts(self):
payload = {**self.FOUR_CLAUDE, "allow": ["claude:001", "claude:003"]}
result = self._probe_with_file(payload)
self.assertEqual(result["code_products"], ["claude"])
ids = [a["id"] for a in result["products"]["claude"]["accounts"]]
self.assertEqual(ids, ["claude:001", "claude:003"])
self.assertEqual(result["products"]["claude"]["quota_pools"], 2)
self.assertEqual(result["max_parallel_workers"], 3)
self.assertEqual(result["allow_unmatched"], [])
def test_allow_env_overrides_file_and_reports_unmatched(self):
payload = {**self.FOUR_CLAUDE, "allow": ["claude:001"]}
result = self._probe_with_file(payload, {"AGENT_DISPATCH_ALLOW": "claude:002, codex cc009"})
self.assertEqual(result["allow"], ["claude:002", "codex", "cc009"])
self.assertEqual([a["id"] for a in result["products"]["claude"]["accounts"]], ["claude:002"])
# a bare product name allows every account of that product
self.assertEqual([a["id"] for a in result["products"]["codex"]["accounts"]], ["codex:002"])
self.assertEqual(result["allow_unmatched"], ["cc009"])
def test_allow_accepts_short_commands_from_manager_and_file(self):
manager_aliases = {
"cc001": "claude:001",
"codex002": "codex:002",
"cc002": "claude:999",
}
payload = {**self.FOUR_CLAUDE, "aliases": {"cc002": "claude:002"}}
with mock.patch("probe_agents.from_sideby_aliases", return_value=manager_aliases):
result = self._probe_with_file(payload, {"AGENT_DISPATCH_ALLOW": "cc001 cc002 codex002 cc009"})
# the accounts file's alias wins over the manager's for the same name
self.assertEqual([a["id"] for a in result["products"]["claude"]["accounts"]], ["claude:001", "claude:002"])
self.assertEqual([a["id"] for a in result["products"]["codex"]["accounts"]], ["codex:002"])
self.assertEqual(result["allow"], ["cc001", "cc002", "codex002", "cc009"])
self.assertEqual(result["allow_unmatched"], ["cc009"])
def test_sideby_aliases_parsed_from_config_json(self):
config = {
"schemaVersion": 1,
"key": "aliases",
"value": {"cc008": "claude:008", "pi-glm": {"account": "pi:main", "args": []}, "bad": 3},
}
with mock.patch("shutil.which", return_value="/usr/local/bin/sideby"):
with mock.patch("sideby_cli.bounded_run") as mock_run:
mock_run.return_value = mock.Mock(stdout=json.dumps(config), returncode=0)
aliases = probe_agents.from_sideby_aliases()
self.assertEqual(aliases, {"cc008": "claude:008", "pi-glm": "pi:main"})
self.assertEqual(mock_run.call_args[0][0], ["sideby", "config", "get", "aliases", "--json"])
class BusySessionTests(IsolatedTestCase):
def test_busy_account_still_has_slots_by_default(self):
# A busy account is not a full account: it takes another headless session.
sessions = {'schemaVersion':1, 'problems':[], 'sessions':[{'account':'claude:001','sessionId':'loop-a','status':'busy'}]}
accounts = [{'id':'claude:001', 'product':'claude', 'command':'cc001', 'pool':'p1'}]
with mock.patch.dict(os.environ, {}, clear=True), mock.patch.object(probe_agents, 'read_accounts_file', return_value={'accounts':accounts}), mock.patch.object(probe_agents, 'ADAPTERS', []), mock.patch.object(probe_agents.shutil, 'which', return_value=None):
result = probe_agents.probe(sessions=sessions)
self.assertEqual(result['busy_sessions']['p1'], ['loop-a'])
self.assertEqual(result['available_slots']['p1'], 2)
self.assertEqual(result['max_parallel_workers'], 1)
def test_busy_pool_capacity(self):
sessions = {'schemaVersion':1, 'problems':[], 'sessions':[{'account':'claude:002','sessionId':'user-chat','status':'busy'}]}
accounts = [{'id':f'claude:00{i}', 'product':'claude', 'command':f'cc00{i}', 'pool':f'p{i}'} for i in range(1,4)]
with mock.patch.dict(os.environ, {'AGENT_DISPATCH_SESSIONS_PER_POOL':'1'}, clear=True), mock.patch.object(probe_agents, 'read_accounts_file', return_value={'accounts':accounts}), mock.patch.object(probe_agents, 'ADAPTERS', []), mock.patch.object(probe_agents.shutil, 'which', return_value=None):
result = probe_agents.probe(sessions=sessions)
self.assertEqual(result['busy_sessions']['p2'], ['user-chat'])
self.assertEqual(result['available_slots']['p2'], 0)
self.assertEqual(result['max_parallel_workers'], 1)
self.assertTrue(any('p2' in f for f in result['fallback']))
class CoordinatorSessionTests(IsolatedTestCase):
def test_coordinator_not_reserved_twice(self):
accounts = [{"id":f"claude:00{i}","product":"claude","command":f"cc00{i}","pool":f"p{i}"} for i in range(1,4)]
sessions = {"sessions":[{"account":"claude:001","sessionId":"coordinator","status":"busy"}, {"account":"claude:002","sessionId":"user-chat","status":"busy"}]}
for key in ("AGENT_DISPATCH_COORDINATOR_SESSION", "CLAUDE_CODE_SESSION_ID", "CODEX_THREAD_ID"):
with self.subTest(key=key), mock.patch.dict(os.environ,{key:"coordinator","AGENT_DISPATCH_SESSIONS_PER_POOL":"1"},clear=True), mock.patch.object(probe_agents,'read_accounts_file',return_value={"accounts":accounts}), mock.patch.object(probe_agents,'ADAPTERS',[]), mock.patch.object(probe_agents.shutil,'which',return_value=None):
result = probe_agents.probe(sessions=sessions)
self.assertEqual(result["busy_sessions"]["p1"], [])
self.assertEqual(result["busy_sessions"]["p2"], ["user-chat"])
self.assertEqual(result["max_parallel_workers"], 1)
class DetectCoordinatorTests(IsolatedTestCase):
"""One `ps` listing, walked in memory; only a non-guessed session on an ancestor matches."""
PS = "1 0\n100 1\n200 100\n300 200\n400 100\n"
SESSIONS = {"schemaVersion": 1, "problems": [], "sessions": [
{"account": "claude:001", "sessionId": "host-session", "status": "busy", "pid": 200, "guessed": False},
{"account": "claude:002", "sessionId": "other", "status": "busy", "pid": 400, "guessed": False},
{"account": "codex:main", "sessionId": "maybe", "status": "busy", "pid": 100, "guessed": True},
]}
def runner_for(self, calls, ps=PS, sessions=None):
import subprocess as sp
payload = json.dumps(self.SESSIONS if sessions is None else sessions)
def runner(argv, **kwargs):
calls.append(argv)
out = payload if argv[0] == "sideby" else ps
return sp.CompletedProcess(argv, 0, out, "")
return runner
def test_walks_ancestors_with_one_ps_call(self):
import sideby_sessions
calls = []
found = sideby_sessions.detect_coordinator(runner=self.runner_for(calls), pid=300)
self.assertEqual(found, "host-session")
self.assertEqual([c[0] for c in calls], ["sideby", "ps"])
def test_ignores_guessed_and_unrelated_sessions(self):
import sideby_sessions
# 400 itself hosts a session; its ancestors (100, guessed; 1) do not count.
self.assertEqual(sideby_sessions.detect_coordinator(runner=self.runner_for([]), pid=400), "other")
# 100 is only a guessed session: never matched by account or guess.
self.assertIsNone(sideby_sessions.detect_coordinator(runner=self.runner_for([]), pid=100))
# A failing ps listing yields nothing rather than a wrong match.
import subprocess as sp
def failing(argv, **kwargs):
if argv[0] == "ps":
return sp.CompletedProcess(argv, 1, "", "denied")
return sp.CompletedProcess(argv, 0, json.dumps(self.SESSIONS), "")
self.assertIsNone(sideby_sessions.detect_coordinator(runner=failing, pid=300))
def test_parent_map_and_cycles(self):
import sideby_sessions
parents = sideby_sessions.parent_map("5 6\nbad line\n6 5\n7 x\n")
self.assertEqual(parents, {5: 6, 6: 5})
self.assertEqual(sideby_sessions.ancestors_of(5, parents), [5, 6])
if __name__ == "__main__":
unittest.main()
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| finishing-a-development-branchobra/superpowersUse when implementation is complete, all tests pass, and you need to decide how to integrate the work | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| systematic-debuggingobra/superpowersUse when encountering any bug, test failure, or unexpected behavior, before proposing fixes | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| test-driven-developmentobra/superpowersUse when implementing any feature or bugfix, before writing implementation code | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| 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: 197k | Updated | Claude CodeCodex | Verified | Install |