feat: skills - suggest auto-tmux worker assignments

skills/auto-tmux/AGENTS.md

@@ -18,6 +18,7 @@ skills/auto-tmux/
 │   ├── swarm-watch.sh
 │   ├── swarm-archive.sh
 │   ├── swarm-board.sh
+│   ├── swarm-assign.sh
 │   ├── safety-check.sh
 │   ├── render-swarm-prompt.sh
 │   ├── swarm-dispatch.sh
@@ -47,6 +48,7 @@ skills/auto-tmux/
 - `scripts/swarm-watch.sh` 是有限轮次巡检层，按间隔采集 pane 输出与 swarm report。
 - `scripts/swarm-archive.sh` 是归档层，打包 brief、snapshot 和 swarm state 供复盘交接。
 - `scripts/swarm-board.sh` 是看板层，将任务、依赖、锁和状态日志渲染为 Markdown。
+- `scripts/swarm-assign.sh` 是分配建议层，将 ready task 轮询映射到 worker pane。
 - `scripts/safety-check.sh` 是安全预检层，检查待发送 payload 的危险命令、敏感信息和大小。
 - `scripts/render-swarm-prompt.sh` 是提示词渲染层，生成 commander/worker/reviewer 协议文本。
 - `scripts/swarm-dispatch.sh` 是提示词下发层，默认写文件，显式 `--send` 后才发送到 pane。
@@ -59,4 +61,4 @@ skills/auto-tmux/
 - 上游来源：`tools/external/.tmux` 与 `tools/external/tmux`。
 - 下游使用：`SKILL.md` 和 `references/` 中的命令示例。
 - 验证入口：`skills/auto-skill/scripts/validate-skill.sh skills/auto-tmux --strict`。
-- 脚本验证：`skills/auto-tmux/scripts/validate-auto-tmux.sh`、`bash -n skills/auto-tmux/scripts/auto-tmux.sh`、`bash -n skills/auto-tmux/scripts/swarm-state.sh`、`bash -n skills/auto-tmux/scripts/swarm-brief.sh`、`bash -n skills/auto-tmux/scripts/swarm-watch.sh`、`bash -n skills/auto-tmux/scripts/swarm-archive.sh`、`bash -n skills/auto-tmux/scripts/swarm-board.sh`、`bash -n skills/auto-tmux/scripts/safety-check.sh`、`bash -n skills/auto-tmux/scripts/render-swarm-prompt.sh`、`bash -n skills/auto-tmux/scripts/swarm-dispatch.sh`、`skills/auto-tmux/scripts/auto-tmux-smoke-test.sh`。
+- 脚本验证：`skills/auto-tmux/scripts/validate-auto-tmux.sh`、`bash -n skills/auto-tmux/scripts/auto-tmux.sh`、`bash -n skills/auto-tmux/scripts/swarm-state.sh`、`bash -n skills/auto-tmux/scripts/swarm-brief.sh`、`bash -n skills/auto-tmux/scripts/swarm-watch.sh`、`bash -n skills/auto-tmux/scripts/swarm-archive.sh`、`bash -n skills/auto-tmux/scripts/swarm-board.sh`、`bash -n skills/auto-tmux/scripts/swarm-assign.sh`、`bash -n skills/auto-tmux/scripts/safety-check.sh`、`bash -n skills/auto-tmux/scripts/render-swarm-prompt.sh`、`bash -n skills/auto-tmux/scripts/swarm-dispatch.sh`、`skills/auto-tmux/scripts/auto-tmux-smoke-test.sh`。

skills/auto-tmux/README.md

@@ -25,6 +25,7 @@ bash -n skills/auto-tmux/scripts/swarm-brief.sh
 bash -n skills/auto-tmux/scripts/swarm-watch.sh
 bash -n skills/auto-tmux/scripts/swarm-archive.sh
 bash -n skills/auto-tmux/scripts/swarm-board.sh
+bash -n skills/auto-tmux/scripts/swarm-assign.sh
 bash -n skills/auto-tmux/scripts/safety-check.sh
 bash -n skills/auto-tmux/scripts/render-swarm-prompt.sh
 bash -n skills/auto-tmux/scripts/swarm-dispatch.sh

skills/auto-tmux/SKILL.md

@@ -39,6 +39,7 @@ bash -n skills/auto-tmux/scripts/swarm-brief.sh
 bash -n skills/auto-tmux/scripts/swarm-watch.sh
 bash -n skills/auto-tmux/scripts/swarm-archive.sh
 bash -n skills/auto-tmux/scripts/swarm-board.sh
+bash -n skills/auto-tmux/scripts/swarm-assign.sh
 bash -n skills/auto-tmux/scripts/safety-check.sh
 bash -n skills/auto-tmux/scripts/render-swarm-prompt.sh
 bash -n skills/auto-tmux/scripts/swarm-dispatch.sh
@@ -119,6 +120,7 @@ skills/auto-tmux/scripts/swarm-brief.sh --session ai-hub --swarm-dir /tmp/ai_swa
 skills/auto-tmux/scripts/swarm-watch.sh --session ai-hub --swarm-dir /tmp/ai_swarm --iterations 3 --interval 10
 skills/auto-tmux/scripts/swarm-archive.sh --session ai-hub --swarm-dir /tmp/ai_swarm --out /tmp/ai-hub-handoff.tar.gz
 skills/auto-tmux/scripts/swarm-board.sh --dir /tmp/ai_swarm --out /tmp/ai-swarm-board.md
+skills/auto-tmux/scripts/swarm-assign.sh --swarm-dir /tmp/ai_swarm --session ai-hub --out /tmp/ai-swarm-assign.md
 ```
 
 **远程救援：发现等待输入即发送 y**
@@ -262,6 +264,7 @@ skills/auto-tmux/scripts/swarm-dispatch.sh --role worker --target <session>:<win
 - `scripts/swarm-watch.sh`: 有限轮次巡检 tmux 蜂群输出和状态报告
 - `scripts/swarm-archive.sh`: 打包 brief、snapshot 和 swarm state 的交接归档
 - `scripts/swarm-board.sh`: 渲染任务、依赖、锁和状态日志的 Markdown 看板
+- `scripts/swarm-assign.sh`: 根据 ready tasks 和 worker pane 生成只读分配建议
 - `scripts/safety-check.sh`: 发送/粘贴/分发前检查危险命令、敏感信息和过大 payload
 - `scripts/render-swarm-prompt.sh`: commander/worker/reviewer 提示词渲染脚本
 - `scripts/swarm-dispatch.sh`: 渲染并可选下发 commander/worker/reviewer 提示词
@@ -285,6 +288,6 @@ skills/auto-tmux/scripts/swarm-dispatch.sh --role worker --target <session>:<win
 4. ≥3 个端到端示例，含输入/步骤/验收。
 5. 长文档放在 `references/` 并可导航；无文档堆砌。
 6. 不确定项给出验证路径；禁止虚构 tmux 行为。
-7. `bash -n skills/auto-tmux/scripts/auto-tmux.sh`、`bash -n skills/auto-tmux/scripts/swarm-state.sh`、`bash -n skills/auto-tmux/scripts/swarm-brief.sh`、`bash -n skills/auto-tmux/scripts/swarm-watch.sh`、`bash -n skills/auto-tmux/scripts/swarm-archive.sh`、`bash -n skills/auto-tmux/scripts/swarm-board.sh`、`bash -n skills/auto-tmux/scripts/safety-check.sh`、`bash -n skills/auto-tmux/scripts/render-swarm-prompt.sh`、`bash -n skills/auto-tmux/scripts/swarm-dispatch.sh` 与 `bash -n skills/auto-tmux/scripts/validate-auto-tmux.sh` 通过。
+7. `bash -n skills/auto-tmux/scripts/auto-tmux.sh`、`bash -n skills/auto-tmux/scripts/swarm-state.sh`、`bash -n skills/auto-tmux/scripts/swarm-brief.sh`、`bash -n skills/auto-tmux/scripts/swarm-watch.sh`、`bash -n skills/auto-tmux/scripts/swarm-archive.sh`、`bash -n skills/auto-tmux/scripts/swarm-board.sh`、`bash -n skills/auto-tmux/scripts/swarm-assign.sh`、`bash -n skills/auto-tmux/scripts/safety-check.sh`、`bash -n skills/auto-tmux/scripts/render-swarm-prompt.sh`、`bash -n skills/auto-tmux/scripts/swarm-dispatch.sh` 与 `bash -n skills/auto-tmux/scripts/validate-auto-tmux.sh` 通过。
 8. `skills/auto-tmux/scripts/auto-tmux-smoke-test.sh` 通过或在无 tmux 环境下明确跳过。
 9. 运行 `skills/auto-tmux/scripts/validate-auto-tmux.sh` 和 `skills/auto-skill/scripts/validate-skill.sh skills/auto-tmux --strict` 通过。

skills/auto-tmux/references/automation.md

@@ -34,6 +34,7 @@
 | `swarm-watch.sh` | 有限轮次巡检 pane 输出和状态 | 不默认无限循环 |
 | `swarm-archive.sh` | 打包 brief、snapshot 和 state | 生成可交接 `.tar.gz` |
 | `swarm-board.sh` | 渲染任务、依赖、锁和状态日志 | 只读生成 Markdown 看板 |
+| `swarm-assign.sh` | 生成 ready task 到 worker pane 的分配建议 | 只读，不 claim，不发送 |
 | `swarm-dispatch.sh` | 渲染并可选下发提示词 | 默认只写文件，发送需 `--send` |
 | `validate-auto-tmux.sh` | 执行技能专属质量门禁 | 覆盖脚本、文档索引、strict 和 smoke |
 
@@ -100,6 +101,7 @@ skills/auto-tmux/scripts/swarm-brief.sh --session ai-hub --swarm-dir /tmp/ai_swa
 skills/auto-tmux/scripts/swarm-watch.sh --session ai-hub --swarm-dir /tmp/ai_swarm --iterations 3 --interval 10 -n 80
 skills/auto-tmux/scripts/swarm-archive.sh --session ai-hub --swarm-dir /tmp/ai_swarm --out /tmp/ai-hub-handoff.tar.gz
 skills/auto-tmux/scripts/swarm-board.sh --dir /tmp/ai_swarm --out /tmp/ai-swarm-board.md
+skills/auto-tmux/scripts/swarm-assign.sh --swarm-dir /tmp/ai_swarm --session ai-hub --out /tmp/ai-swarm-assign.md
 ```
 
 发送前对 payload 做安全预检：
@@ -253,6 +255,7 @@ bash -n skills/auto-tmux/scripts/swarm-brief.sh
 bash -n skills/auto-tmux/scripts/swarm-watch.sh
 bash -n skills/auto-tmux/scripts/swarm-archive.sh
 bash -n skills/auto-tmux/scripts/swarm-board.sh
+bash -n skills/auto-tmux/scripts/swarm-assign.sh
 bash -n skills/auto-tmux/scripts/safety-check.sh
 bash -n skills/auto-tmux/scripts/render-swarm-prompt.sh
 bash -n skills/auto-tmux/scripts/swarm-dispatch.sh

skills/auto-tmux/references/iteration-roadmap.md

@@ -26,13 +26,13 @@
 | 18 | `42bca78` | 结果归档 | `swarm-archive.sh` |
 | 19 | `07ac877` | 安全策略 | `safety-check.sh`、`safety-policy.md` |
 | 20 | `6d46748` | 状态可视化 | `swarm-board.sh` |
-| 21 | `本轮` | 依赖领取一致性 | `task-next` 尊重 `blocked-by` |
+| 21 | `d8e7d31` | 依赖领取一致性 | `task-next` 尊重 `blocked-by` |
+| 22 | `本轮` | worker 分配 | `swarm-assign.sh` |
 
 ## 后续候选方向
 
 | 优先级 | 方向 | 说明 |
 |:---|:---|:---|
-| P2 | worker 分配 | 根据 TODO 队列和空闲 pane 自动生成 dispatch 建议 |
 | P2 | replay 审计 | 从 record 日志生成复盘摘要 |
 | P3 | 远程 session | SSH 场景下的只读拓扑和安全边界 |
 | P3 | shell completion | 为常用子命令生成补全脚本 |

skills/auto-tmux/scripts/AGENTS.md

@@ -14,6 +14,7 @@ scripts/
 ├── swarm-watch.sh  # 有限轮次只读巡检和状态采样
 ├── swarm-archive.sh # 打包 brief、snapshot 和 swarm state
 ├── swarm-board.sh # 从 swarm state 渲染 Markdown 看板
+├── swarm-assign.sh # 生成 ready task 到 worker pane 的分配建议
 ├── safety-check.sh # 发送/粘贴/分发前的 payload 安全预检
 ├── render-swarm-prompt.sh # commander/worker/reviewer 提示词渲染
 ├── swarm-dispatch.sh # 渲染并可选下发蜂群提示词
@@ -34,6 +35,7 @@ scripts/
 - 巡检脚本必须是有限轮次，不允许默认无限循环。
 - 归档脚本只复制状态和只读证据，不修改 tmux pane 或 swarm state。
 - 看板脚本只读 `tasks.tsv`、`deps.tsv`、锁和状态日志，不改写状态目录。
+- 分配建议脚本只读任务和 pane 拓扑，不 claim 任务、不发送 prompt。
 - 安全预检脚本只能读取文本或文件，不控制 tmux，不写状态目录。
 - 状态脚本只能写入显式状态目录，不保存密钥、Token、密码或私密项目内容。
 - 自测脚本必须创建独立临时 tmux session，并在退出时清理。

skills/auto-tmux/scripts/README.md

@@ -10,6 +10,7 @@
 - [`swarm-watch.sh`](./swarm-watch.sh) - 有限轮次巡检蜂群 pane 输出和状态报告，形成连续证据。
 - [`swarm-archive.sh`](./swarm-archive.sh) - 打包 brief、snapshot 和 swarm state，生成可交接归档。
 - [`swarm-board.sh`](./swarm-board.sh) - 将 `tasks.tsv`、依赖、锁和状态日志渲染为 Markdown 看板。
+- [`swarm-assign.sh`](./swarm-assign.sh) - 根据 ready tasks 和 worker pane 生成只读分配建议。
 - [`safety-check.sh`](./safety-check.sh) - 发送、粘贴或分发前检查危险命令、敏感信息和过大 payload。
 - [`render-swarm-prompt.sh`](./render-swarm-prompt.sh) - commander、worker、reviewer 提示词渲染。
 - [`swarm-dispatch.sh`](./swarm-dispatch.sh) - 渲染提示词并可选发送到指定 pane，默认只写文件。
@@ -62,6 +63,9 @@ skills/auto-tmux/scripts/swarm-archive.sh --session ai-hub --swarm-dir /tmp/ai_s
 # 生成任务看板
 skills/auto-tmux/scripts/swarm-board.sh --dir /tmp/ai_swarm --out /tmp/ai-swarm-board.md
 
+# 生成 worker 分配建议
+skills/auto-tmux/scripts/swarm-assign.sh --swarm-dir /tmp/ai_swarm --session ai-hub --out /tmp/ai-swarm-assign.md
+
 # 初始化蜂群状态并添加任务
 skills/auto-tmux/scripts/swarm-state.sh init --dir /tmp/ai_swarm
 skills/auto-tmux/scripts/swarm-state.sh task-add --id task-001 --text "检查 README 链接"

skills/auto-tmux/scripts/auto-tmux-smoke-test.sh

@@ -10,6 +10,7 @@ SWARM_BRIEF="$SCRIPT_DIR/swarm-brief.sh"
 SWARM_WATCH="$SCRIPT_DIR/swarm-watch.sh"
 SWARM_ARCHIVE="$SCRIPT_DIR/swarm-archive.sh"
 SWARM_BOARD="$SCRIPT_DIR/swarm-board.sh"
+SWARM_ASSIGN="$SCRIPT_DIR/swarm-assign.sh"
 SAFETY_CHECK="$SCRIPT_DIR/safety-check.sh"
 SWARM_DISPATCH="$SCRIPT_DIR/swarm-dispatch.sh"
 SESSION="auto-tmux-smoke-$$"
@@ -21,13 +22,14 @@ BRIEF_DIR="/tmp/auto-tmux-smoke-brief-$$"
 WATCH_DIR="/tmp/auto-tmux-smoke-watch-$$"
 ARCHIVE_FILE="/tmp/auto-tmux-smoke-archive-$$.tar.gz"
 BOARD_FILE="/tmp/auto-tmux-smoke-board-$$.md"
+ASSIGN_FILE="/tmp/auto-tmux-smoke-assign-$$.md"
 DISPATCH_PROMPT="/tmp/auto-tmux-smoke-dispatch-$$.md"
 TASK_IMPORT_FILE="/tmp/auto-tmux-smoke-tasks-$$.txt"
 PASTE_FILE="/tmp/auto-tmux-smoke-paste-$$.txt"
 
 cleanup() {
   tmux kill-session -t "$SESSION" 2>/dev/null || true
-  rm -rf "$SWARM_DIR" "$DEP_SWARM_DIR" "$SNAPSHOT_DIR" "$RECORD_DIR" "$BRIEF_DIR" "$WATCH_DIR" "$ARCHIVE_FILE" "$BOARD_FILE" "$DISPATCH_PROMPT" "$TASK_IMPORT_FILE" "$PASTE_FILE"
+  rm -rf "$SWARM_DIR" "$DEP_SWARM_DIR" "$SNAPSHOT_DIR" "$RECORD_DIR" "$BRIEF_DIR" "$WATCH_DIR" "$ARCHIVE_FILE" "$BOARD_FILE" "$ASSIGN_FILE" "$DISPATCH_PROMPT" "$TASK_IMPORT_FILE" "$PASTE_FILE"
 }
 trap cleanup EXIT
 
@@ -43,6 +45,7 @@ bash -n "$SWARM_BRIEF"
 bash -n "$SWARM_WATCH"
 bash -n "$SWARM_ARCHIVE"
 bash -n "$SWARM_BOARD"
+bash -n "$SWARM_ASSIGN"
 bash -n "$SAFETY_CHECK"
 bash -n "$SWARM_DISPATCH"
 
@@ -132,6 +135,9 @@ test -s "$ARCHIVE_FILE"
 grep -q 'auto-tmux Swarm Board' "$BOARD_FILE"
 grep -q '## Ready TODO' "$BOARD_FILE"
 grep -q 'smoke-fail' "$BOARD_FILE"
+"$SWARM_ASSIGN" --swarm-dir "$SWARM_DIR" --session "$SESSION" --out "$ASSIGN_FILE" --limit 20 >/tmp/auto-tmux-smoke-assign.txt
+grep -q 'auto-tmux Swarm Assignment Suggestions' "$ASSIGN_FILE"
+grep -q 'swarm-dispatch.sh' "$ASSIGN_FILE"
 "$RENDER_PROMPT" commander --session "$SESSION" --swarm-dir "$SWARM_DIR" --task "smoke" >/tmp/auto-tmux-smoke-commander-prompt.md
 "$RENDER_PROMPT" worker --session "$SESSION" --target "$worker_target" --swarm-dir "$SWARM_DIR" --task "smoke" >/tmp/auto-tmux-smoke-worker-prompt.md
 "$SWARM_DISPATCH" --role worker --target "$worker_target" --session "$SESSION" --swarm-dir "$SWARM_DIR" --task "smoke" --out "$DISPATCH_PROMPT" >/tmp/auto-tmux-smoke-dispatch-render.txt

skills/auto-tmux/scripts/auto-tmux.sh

@@ -153,7 +153,7 @@ cmd_doctor() {
     status_line "WARN" "tmux server has no reachable session yet"
   fi
 
-  for script in auto-tmux.sh swarm-state.sh swarm-brief.sh swarm-watch.sh swarm-archive.sh swarm-board.sh safety-check.sh render-swarm-prompt.sh swarm-dispatch.sh auto-tmux-smoke-test.sh validate-auto-tmux.sh; do
+  for script in auto-tmux.sh swarm-state.sh swarm-brief.sh swarm-watch.sh swarm-archive.sh swarm-board.sh swarm-assign.sh safety-check.sh render-swarm-prompt.sh swarm-dispatch.sh auto-tmux-smoke-test.sh validate-auto-tmux.sh; do
     if [[ -x "$script_dir/$script" ]]; then
       status_line "OK" "script executable: $script"
     else

skills/auto-tmux/scripts/swarm-assign.sh

@@ -0,0 +1,158 @@
+#!/usr/bin/env bash
+# swarm-assign: generate read-only task-to-pane dispatch suggestions.
+set -euo pipefail
+
+usage() {
+  cat <<'EOF'
+swarm-assign: suggest ready task assignments for auto-tmux workers
+
+Usage:
+  swarm-assign.sh [--swarm-dir DIR] [--session NAME] [--out FILE] [--limit N]
+
+Defaults:
+  --swarm-dir AUTO_TMUX_SWARM_DIR or /tmp/ai_swarm
+  --session   omitted; use placeholder targets
+  --out       stdout
+  --limit     20 suggestions
+
+This script is read-only. It does not claim tasks and does not send prompts.
+EOF
+}
+
+die() {
+  printf 'error: %s\n' "$*" >&2
+  exit 1
+}
+
+swarm_dir="${AUTO_TMUX_SWARM_DIR:-/tmp/ai_swarm}"
+session=""
+out_file=""
+limit=20
+
+while [[ $# -gt 0 ]]; do
+  case "$1" in
+    --swarm-dir|--dir)
+      swarm_dir="${2:-}"
+      shift 2
+      ;;
+    --session)
+      session="${2:-}"
+      shift 2
+      ;;
+    --out)
+      out_file="${2:-}"
+      shift 2
+      ;;
+    --limit)
+      limit="${2:-}"
+      shift 2
+      ;;
+    -h|--help)
+      usage
+      exit 0
+      ;;
+    *)
+      die "unknown option: $1"
+      ;;
+  esac
+done
+
+[[ "$limit" =~ ^[0-9]+$ ]] || die "--limit must be a number"
+
+tasks_tsv="$swarm_dir/tasks.tsv"
+deps_tsv="$swarm_dir/deps.tsv"
+[[ -f "$tasks_tsv" ]] || die "tasks file not found: $tasks_tsv"
+[[ -f "$deps_tsv" ]] || die "deps file not found: $deps_tsv"
+
+tmp_dir="$(mktemp -d)"
+cleanup() {
+  rm -rf "$tmp_dir"
+}
+trap cleanup EXIT
+
+ready_tsv="$tmp_dir/ready.tsv"
+panes_tsv="$tmp_dir/panes.tsv"
+
+awk -F '\t' -v limit="$limit" '
+  FILENAME == ARGV[1] {
+    if (FNR == 1) next
+    status[$1] = $2
+    owner[$1] = $3
+    text[$1] = $4
+    order[++n] = $1
+    next
+  }
+  FILENAME == ARGV[2] {
+    if (FNR == 1) next
+    if (status[$2] != "DONE") blocked[$1] = 1
+    next
+  }
+  END {
+    shown = 0
+    for (i = 1; i <= n; i++) {
+      id = order[i]
+      if (status[id] == "TODO" && blocked[id] != 1) {
+        print id "\t" owner[id] "\t" text[id]
+        shown++
+        if (shown >= limit) break
+      }
+    }
+  }
+' "$tasks_tsv" "$deps_tsv" > "$ready_tsv"
+
+if [[ -n "$session" ]]; then
+  command -v tmux >/dev/null 2>&1 || die "tmux is required when --session is used"
+  tmux has-session -t "$session" 2>/dev/null || die "session not found: $session"
+  tmux list-panes -t "$session" -F '#S:#{window_index}.#{pane_index}\t#{window_name}\t#{pane_current_command}' |
+    awk -F '\t' 'tolower($2) ~ /worker/ {print; next} {other[++n] = $0} END {for (i = 1; i <= n; i++) print other[i]}' > "$panes_tsv"
+else
+  printf '<target-pane>\tworker\tunknown\n' > "$panes_tsv"
+fi
+
+render_assignments() {
+  printf '# auto-tmux Swarm Assignment Suggestions\n\n'
+  printf -- '- swarm_dir: `%s`\n' "$swarm_dir"
+  printf -- '- session: `%s`\n' "${session:-<not provided>}"
+  printf -- '- created_at: `%s`\n\n' "$(date -Is)"
+  printf 'This is a read-only planning report. It does not claim tasks and does not send prompts.\n\n'
+
+  printf '## Suggestions\n\n'
+  printf '| task | current owner | target | command |\n'
+  printf '|:---|:---|:---|:---|\n'
+
+  if [[ ! -s "$ready_tsv" ]]; then
+    printf '| - | - | - | no ready TODO task |\n'
+    return 0
+  fi
+
+  awk -F '\t' -v swarm_dir="$swarm_dir" '
+    FILENAME == ARGV[1] {
+      pane[++pane_count] = $1
+      next
+    }
+    FILENAME == ARGV[2] {
+      task_count++
+      idx = ((task_count - 1) % pane_count) + 1
+      target = pane[idx]
+      task_text = $3
+      gsub(/"/, "\\\"", task_text)
+      cmd = "skills/auto-tmux/scripts/swarm-dispatch.sh --role worker --target " target " --swarm-dir " swarm_dir " --task \"" $1 ": " task_text "\" --send --dry-run"
+      gsub(/\|/, "\\|", $3)
+      gsub(/\|/, "\\|", cmd)
+      print "| `" $1 "` | `" $2 "` | `" target "` | `" cmd "` |"
+    }
+  ' "$panes_tsv" "$ready_tsv"
+
+  printf '\n## Ready Tasks\n\n'
+  printf '| id | owner | text |\n'
+  printf '|:---|:---|:---|\n'
+  awk -F '\t' '{gsub(/\|/, "\\|", $3); print "| `" $1 "` | `" $2 "` | " $3 " |"}' "$ready_tsv"
+}
+
+if [[ -n "$out_file" ]]; then
+  mkdir -p "$(dirname "$out_file")"
+  render_assignments > "$out_file"
+  printf 'swarm assignments written: %s\n' "$out_file"
+else
+  render_assignments
+fi

skills/auto-tmux/scripts/validate-auto-tmux.sh

@@ -83,6 +83,7 @@ scripts=(
   "$script_dir/swarm-watch.sh"
   "$script_dir/swarm-archive.sh"
   "$script_dir/swarm-board.sh"
+  "$script_dir/swarm-assign.sh"
   "$script_dir/safety-check.sh"
   "$script_dir/render-swarm-prompt.sh"
   "$script_dir/swarm-dispatch.sh"
@@ -100,6 +101,7 @@ run_gate "swarm-brief help" "$script_dir/swarm-brief.sh" --help
 run_gate "swarm-watch help" "$script_dir/swarm-watch.sh" --help
 run_gate "swarm-archive help" "$script_dir/swarm-archive.sh" --help
 run_gate "swarm-board help" "$script_dir/swarm-board.sh" --help
+run_gate "swarm-assign help" "$script_dir/swarm-assign.sh" --help
 run_gate "safety-check help" "$script_dir/safety-check.sh" --help
 run_gate "safety-check clean text" "$script_dir/safety-check.sh" --text "make test"
 if "$script_dir/safety-check.sh" --text "rm -rf /tmp/example" >/tmp/auto-tmux-validate-gate.log 2>&1; then
@@ -115,6 +117,7 @@ require_contains "$skill_dir/SKILL.md" "scripts/swarm-brief.sh"
 require_contains "$skill_dir/SKILL.md" "scripts/swarm-watch.sh"
 require_contains "$skill_dir/SKILL.md" "scripts/swarm-archive.sh"
 require_contains "$skill_dir/SKILL.md" "scripts/swarm-board.sh"
+require_contains "$skill_dir/SKILL.md" "scripts/swarm-assign.sh"
 require_contains "$skill_dir/SKILL.md" "scripts/safety-check.sh"
 require_contains "$skill_dir/SKILL.md" "scripts/swarm-dispatch.sh"
 require_contains "$skill_dir/references/index.md" "automation.md"
@@ -126,12 +129,14 @@ require_contains "$script_dir/README.md" "swarm-dispatch.sh"
 require_contains "$script_dir/README.md" "swarm-watch.sh"
 require_contains "$script_dir/README.md" "swarm-archive.sh"
 require_contains "$script_dir/README.md" "swarm-board.sh"
+require_contains "$script_dir/README.md" "swarm-assign.sh"
 require_contains "$script_dir/README.md" "safety-check.sh"
 require_contains "$script_dir/AGENTS.md" "validate-auto-tmux.sh"
 require_contains "$script_dir/AGENTS.md" "swarm-dispatch.sh"
 require_contains "$script_dir/AGENTS.md" "swarm-watch.sh"
 require_contains "$script_dir/AGENTS.md" "swarm-archive.sh"
 require_contains "$script_dir/AGENTS.md" "swarm-board.sh"
+require_contains "$script_dir/AGENTS.md" "swarm-assign.sh"
 require_contains "$script_dir/AGENTS.md" "safety-check.sh"
 
 if [[ -x "$repo_root/skills/auto-skill/scripts/validate-skill.sh" ]]; then