feat: skills - render auto-tmux swarm board

skills/auto-tmux/scripts/AGENTS.md

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

skills/auto-tmux/scripts/README.md

@@ -9,6 +9,7 @@
 - [`swarm-brief.sh`](./swarm-brief.sh) - 只读生成蜂群交接报告，汇总 doctor、topology、pane 输出和状态报告。
 - [`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 看板。
 - [`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，默认只写文件。
@@ -58,6 +59,9 @@ skills/auto-tmux/scripts/swarm-watch.sh --session ai-hub --swarm-dir /tmp/ai_swa
 # 打包交接归档
 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-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

@@ -9,6 +9,7 @@ RENDER_PROMPT="$SCRIPT_DIR/render-swarm-prompt.sh"
 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"
 SAFETY_CHECK="$SCRIPT_DIR/safety-check.sh"
 SWARM_DISPATCH="$SCRIPT_DIR/swarm-dispatch.sh"
 SESSION="auto-tmux-smoke-$$"
@@ -18,13 +19,14 @@ RECORD_DIR="/tmp/auto-tmux-smoke-record-$$"
 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"
 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" "$SNAPSHOT_DIR" "$RECORD_DIR" "$BRIEF_DIR" "$WATCH_DIR" "$ARCHIVE_FILE" "$DISPATCH_PROMPT" "$TASK_IMPORT_FILE" "$PASTE_FILE"
+  rm -rf "$SWARM_DIR" "$SNAPSHOT_DIR" "$RECORD_DIR" "$BRIEF_DIR" "$WATCH_DIR" "$ARCHIVE_FILE" "$BOARD_FILE" "$DISPATCH_PROMPT" "$TASK_IMPORT_FILE" "$PASTE_FILE"
 }
 trap cleanup EXIT
 
@@ -39,6 +41,7 @@ bash -n "$RENDER_PROMPT"
 bash -n "$SWARM_BRIEF"
 bash -n "$SWARM_WATCH"
 bash -n "$SWARM_ARCHIVE"
+bash -n "$SWARM_BOARD"
 bash -n "$SAFETY_CHECK"
 bash -n "$SWARM_DISPATCH"
 
@@ -114,6 +117,10 @@ grep -q 'auto-tmux Swarm Brief' "$BRIEF_DIR/brief.md"
 grep -q 'auto-tmux Swarm Watch' "$WATCH_DIR/index.md"
 "$SWARM_ARCHIVE" --session "$SESSION" --swarm-dir "$SWARM_DIR" --out "$ARCHIVE_FILE" -n 10 >/tmp/auto-tmux-smoke-archive.txt
 test -s "$ARCHIVE_FILE"
+"$SWARM_BOARD" --dir "$SWARM_DIR" --out "$BOARD_FILE" --limit 20 >/tmp/auto-tmux-smoke-board.txt
+grep -q 'auto-tmux Swarm Board' "$BOARD_FILE"
+grep -q '## Ready TODO' "$BOARD_FILE"
+grep -q 'smoke-fail' "$BOARD_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 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 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-board.sh

@@ -0,0 +1,189 @@
+#!/usr/bin/env bash
+# swarm-board: render swarm tasks, dependencies and locks as a Markdown board.
+set -euo pipefail
+
+usage() {
+  cat <<'EOF'
+swarm-board: render an auto-tmux swarm state directory as Markdown
+
+Usage:
+  swarm-board.sh [--dir DIR] [--out FILE] [--limit N]
+
+Defaults:
+  --dir   AUTO_TMUX_SWARM_DIR or /tmp/ai_swarm
+  --out   stdout
+  --limit 50 rows per section
+EOF
+}
+
+die() {
+  printf 'error: %s\n' "$*" >&2
+  exit 1
+}
+
+swarm_dir="${AUTO_TMUX_SWARM_DIR:-/tmp/ai_swarm}"
+out_file=""
+limit=50
+
+while [[ $# -gt 0 ]]; do
+  case "$1" in
+    --dir)
+      swarm_dir="${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"
+locks_dir="$swarm_dir/locks"
+status_log="$swarm_dir/status.log"
+
+[[ -f "$tasks_tsv" ]] || die "tasks file not found: $tasks_tsv"
+[[ -f "$deps_tsv" ]] || die "deps file not found: $deps_tsv"
+
+render_summary() {
+  awk -F '\t' '
+    NR > 1 {count[$2]++}
+    END {
+      print "| status | count |"
+      print "|:---|---:|"
+      n = split("TODO DOING DONE BLOCKED FAIL", order, " ")
+      for (i = 1; i <= n; i++) {
+        status = order[i]
+        print "| `" status "` | " (count[status] + 0) " |"
+      }
+    }
+  ' "$tasks_tsv"
+}
+
+render_ready() {
+  awk -F '\t' -v limit="$limit" '
+    function esc(value) {
+      gsub(/\|/, "\\|", value)
+      return value
+    }
+    FILENAME == ARGV[1] {
+      if (FNR == 1) next
+      status[$1] = $2
+      owner[$1] = $3
+      text[$1] = $4
+      result[$1] = $5
+      order[++n] = $1
+      next
+    }
+    FILENAME == ARGV[2] {
+      if (FNR == 1) next
+      if (status[$2] != "DONE") {
+        blocked[$1] = blocked[$1] ? blocked[$1] ", " $2 : $2
+      }
+      next
+    }
+    END {
+      print "| id | owner | text |"
+      print "|:---|:---|:---|"
+      shown = 0
+      for (i = 1; i <= n; i++) {
+        id = order[i]
+        if (status[id] == "TODO" && blocked[id] == "") {
+          print "| `" esc(id) "` | `" esc(owner[id]) "` | " esc(text[id]) " |"
+          shown++
+          if (shown >= limit) break
+        }
+      }
+      if (shown == 0) print "| - | - | - |"
+    }
+  ' "$tasks_tsv" "$deps_tsv"
+}
+
+render_status_section() {
+  local status="$1"
+  awk -F '\t' -v wanted="$status" -v limit="$limit" '
+    function esc(value) {
+      gsub(/\|/, "\\|", value)
+      return value
+    }
+    BEGIN {
+      print "| id | owner | text | result |"
+      print "|:---|:---|:---|:---|"
+    }
+    NR > 1 && $2 == wanted {
+      print "| `" esc($1) "` | `" esc($3) "` | " esc($4) " | " esc($5) " |"
+      shown++
+      if (shown >= limit) exit
+    }
+    END {
+      if (shown == 0) print "| - | - | - | - |"
+    }
+  ' "$tasks_tsv"
+}
+
+render_locks() {
+  printf '| lock | owner | created_at |\n'
+  printf '|:---|:---|:---|\n'
+  if [[ ! -d "$locks_dir" ]] || ! find "$locks_dir" -mindepth 1 -maxdepth 1 -type d -name '*.lock.d' -print -quit | grep -q .; then
+    printf '| - | - | - |\n'
+    return 0
+  fi
+  find "$locks_dir" -mindepth 1 -maxdepth 1 -type d -name '*.lock.d' -print | sort | while read -r path; do
+    printf '| `%s` | `%s` | %s |\n' \
+      "$(basename "$path" .lock.d)" \
+      "$(cat "$path/owner" 2>/dev/null || printf unknown)" \
+      "$(cat "$path/created_at" 2>/dev/null || printf unknown)"
+  done
+}
+
+render_recent_status() {
+  if [[ -s "$status_log" ]]; then
+    tail -n 20 "$status_log" | sed 's/^/- /'
+  else
+    printf -- '- no status log\n'
+  fi
+}
+
+render_board() {
+  printf '# auto-tmux Swarm Board\n\n'
+  printf -- '- dir: `%s`\n' "$swarm_dir"
+  printf -- '- created_at: `%s`\n\n' "$(date -Is)"
+
+  printf '## Summary\n\n'
+  render_summary
+  printf '\n## Ready TODO\n\n'
+  render_ready
+
+  local status
+  for status in TODO DOING BLOCKED FAIL DONE; do
+    printf '\n## %s\n\n' "$status"
+    render_status_section "$status"
+  done
+
+  printf '\n## Locks\n\n'
+  render_locks
+  printf '\n## Recent Status\n\n'
+  render_recent_status
+}
+
+if [[ -n "$out_file" ]]; then
+  mkdir -p "$(dirname "$out_file")"
+  render_board > "$out_file"
+  printf 'swarm board written: %s\n' "$out_file"
+else
+  render_board
+fi

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

@@ -82,6 +82,7 @@ scripts=(
   "$script_dir/swarm-brief.sh"
   "$script_dir/swarm-watch.sh"
   "$script_dir/swarm-archive.sh"
+  "$script_dir/swarm-board.sh"
   "$script_dir/safety-check.sh"
   "$script_dir/render-swarm-prompt.sh"
   "$script_dir/swarm-dispatch.sh"
@@ -98,6 +99,7 @@ run_gate "swarm-state help" "$script_dir/swarm-state.sh" help
 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 "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
@@ -112,6 +114,7 @@ require_contains "$skill_dir/SKILL.md" "scripts/validate-auto-tmux.sh"
 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/safety-check.sh"
 require_contains "$skill_dir/SKILL.md" "scripts/swarm-dispatch.sh"
 require_contains "$skill_dir/references/index.md" "automation.md"
@@ -122,11 +125,13 @@ require_contains "$script_dir/README.md" "validate-auto-tmux.sh"
 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" "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" "safety-check.sh"
 
 if [[ -x "$repo_root/skills/auto-skill/scripts/validate-skill.sh" ]]; then