From 3174e5dd54dae458b8b0bc7ecff6c98f7ad4df97 Mon Sep 17 00:00:00 2001
From: tukuaiai <tukuaiai@users.noreply.github.com>
Date: Tue, 19 May 2026 13:16:03 +0800
Subject: [PATCH] feat: skills - graph auto-tmux task dependencies

---
 skills/auto-tmux/AGENTS.md                    |   4 +-
 skills/auto-tmux/README.md                    |   1 +
 skills/auto-tmux/SKILL.md                     |   5 +-
 skills/auto-tmux/references/automation.md     |   3 +
 .../auto-tmux/references/iteration-roadmap.md |   1 +
 skills/auto-tmux/scripts/AGENTS.md            |   2 +
 skills/auto-tmux/scripts/README.md            |   4 +
 .../auto-tmux/scripts/auto-tmux-smoke-test.sh |   8 +-
 skills/auto-tmux/scripts/auto-tmux.sh         |   2 +-
 skills/auto-tmux/scripts/swarm-deps-graph.sh  | 106 ++++++++++++++++++
 .../auto-tmux/scripts/validate-auto-tmux.sh   |   5 +
 11 files changed, 137 insertions(+), 4 deletions(-)
 create mode 100755 skills/auto-tmux/scripts/swarm-deps-graph.sh

diff --git a/skills/auto-tmux/AGENTS.md b/skills/auto-tmux/AGENTS.md
index 15eb929..f755de0 100644
--- a/skills/auto-tmux/AGENTS.md
+++ b/skills/auto-tmux/AGENTS.md
@@ -18,6 +18,7 @@ skills/auto-tmux/
 │   ├── swarm-watch.sh
 │   ├── swarm-archive.sh
 │   ├── swarm-board.sh
+│   ├── swarm-deps-graph.sh
 │   ├── swarm-assign.sh
 │   ├── swarm-health.sh
 │   ├── record-summary.sh
@@ -51,6 +52,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-deps-graph.sh` 是依赖可视化层，将 `deps.tsv` 渲染为 Mermaid 图。
 - `scripts/swarm-assign.sh` 是分配建议层，将 ready task 轮询映射到 worker pane。
 - `scripts/swarm-health.sh` 是健康检查层，汇总 tmux 和 swarm state 的只读报告包。
 - `scripts/record-summary.sh` 是复盘摘要层，将 pane 录制日志整理为 Markdown。
@@ -67,4 +69,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/swarm-assign.sh`、`bash -n skills/auto-tmux/scripts/swarm-health.sh`、`bash -n skills/auto-tmux/scripts/record-summary.sh`、`bash -n skills/auto-tmux/scripts/completion.bash`、`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-deps-graph.sh`、`bash -n skills/auto-tmux/scripts/swarm-assign.sh`、`bash -n skills/auto-tmux/scripts/swarm-health.sh`、`bash -n skills/auto-tmux/scripts/record-summary.sh`、`bash -n skills/auto-tmux/scripts/completion.bash`、`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`。
diff --git a/skills/auto-tmux/README.md b/skills/auto-tmux/README.md
index 9d9acbf..b72daf1 100644
--- a/skills/auto-tmux/README.md
+++ b/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-deps-graph.sh
 bash -n skills/auto-tmux/scripts/swarm-assign.sh
 bash -n skills/auto-tmux/scripts/swarm-health.sh
 bash -n skills/auto-tmux/scripts/record-summary.sh
diff --git a/skills/auto-tmux/SKILL.md b/skills/auto-tmux/SKILL.md
index cd63bf9..d13f3a6 100644
--- a/skills/auto-tmux/SKILL.md
+++ b/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-deps-graph.sh
 bash -n skills/auto-tmux/scripts/swarm-assign.sh
 bash -n skills/auto-tmux/scripts/swarm-health.sh
 bash -n skills/auto-tmux/scripts/record-summary.sh
@@ -123,6 +124,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-deps-graph.sh --dir /tmp/ai_swarm --out /tmp/ai-swarm-deps.md
 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-health.sh --session ai-hub --swarm-dir /tmp/ai_swarm --out /tmp/auto-tmux-health
 ```
@@ -270,6 +272,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-deps-graph.sh`: 渲染 `deps.tsv` 的 Mermaid 依赖图
 - `scripts/swarm-assign.sh`: 根据 ready tasks 和 worker pane 生成只读分配建议
 - `scripts/swarm-health.sh`: 汇总 tmux 与 swarm state 的只读健康检查报告包
 - `scripts/record-summary.sh`: 汇总 pane 录制日志并生成复盘摘要
@@ -297,6 +300,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/swarm-assign.sh`、`bash -n skills/auto-tmux/scripts/swarm-health.sh`、`bash -n skills/auto-tmux/scripts/record-summary.sh`、`bash -n skills/auto-tmux/scripts/completion.bash`、`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-deps-graph.sh`、`bash -n skills/auto-tmux/scripts/swarm-assign.sh`、`bash -n skills/auto-tmux/scripts/swarm-health.sh`、`bash -n skills/auto-tmux/scripts/record-summary.sh`、`bash -n skills/auto-tmux/scripts/completion.bash`、`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` 通过。
diff --git a/skills/auto-tmux/references/automation.md b/skills/auto-tmux/references/automation.md
index fc5ce49..0338e32 100644
--- a/skills/auto-tmux/references/automation.md
+++ b/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-deps-graph.sh` | 渲染任务依赖图 | 只读生成 Mermaid |
 | `swarm-assign.sh` | 生成 ready task 到 worker pane 的分配建议 | 只读，不 claim，不发送 |
 | `swarm-health.sh` | 汇总 tmux 与 swarm state 健康报告 | 只读，不自动修复 |
 | `record-summary.sh` | 汇总 pane 录制日志 | 只读，输出默认脱敏 |
@@ -104,6 +105,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-deps-graph.sh --dir /tmp/ai_swarm --out /tmp/ai-swarm-deps.md
 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-health.sh --session ai-hub --swarm-dir /tmp/ai_swarm --out /tmp/auto-tmux-health
 ```
@@ -260,6 +262,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-deps-graph.sh
 bash -n skills/auto-tmux/scripts/swarm-assign.sh
 bash -n skills/auto-tmux/scripts/swarm-health.sh
 bash -n skills/auto-tmux/scripts/record-summary.sh
diff --git a/skills/auto-tmux/references/iteration-roadmap.md b/skills/auto-tmux/references/iteration-roadmap.md
index 64dd1d5..2738d2c 100644
--- a/skills/auto-tmux/references/iteration-roadmap.md
+++ b/skills/auto-tmux/references/iteration-roadmap.md
@@ -31,6 +31,7 @@
 | 23 | `004d942` | replay 审计 | `record-summary.sh` |
 | 24 | `16afbee` | 健康检查 | `swarm-health.sh` |
 | 25 | `38ccefe` | shell completion | `completion.bash` |
+| 26 | `本轮` | 依赖可视化 | `swarm-deps-graph.sh` |
 
 ## 后续候选方向
 
diff --git a/skills/auto-tmux/scripts/AGENTS.md b/skills/auto-tmux/scripts/AGENTS.md
index 17ba113..16f1f0f 100644
--- a/skills/auto-tmux/scripts/AGENTS.md
+++ b/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-deps-graph.sh # 从 deps.tsv 渲染 Mermaid 依赖图
 ├── swarm-assign.sh # 生成 ready task 到 worker pane 的分配建议
 ├── swarm-health.sh # 汇总只读健康检查报告包
 ├── record-summary.sh # 汇总 pipe-pane 录制日志
@@ -38,6 +39,7 @@ scripts/
 - 巡检脚本必须是有限轮次，不允许默认无限循环。
 - 归档脚本只复制状态和只读证据，不修改 tmux pane 或 swarm state。
 - 看板脚本只读 `tasks.tsv`、`deps.tsv`、锁和状态日志，不改写状态目录。
+- 依赖图脚本只读 `tasks.tsv` 和 `deps.tsv`，不改写状态目录。
 - 分配建议脚本只读任务和 pane 拓扑，不 claim 任务、不发送 prompt。
 - 健康检查脚本只读 tmux 与 swarm state，失败项写入报告，不做自动修复。
 - 录制摘要脚本只读 record 日志，输出默认脱敏，不修改日志源文件。
diff --git a/skills/auto-tmux/scripts/README.md b/skills/auto-tmux/scripts/README.md
index f701238..da2e88e 100644
--- a/skills/auto-tmux/scripts/README.md
+++ b/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-deps-graph.sh`](./swarm-deps-graph.sh) - 将 `deps.tsv` 渲染为 Mermaid 依赖图。
 - [`swarm-assign.sh`](./swarm-assign.sh) - 根据 ready tasks 和 worker pane 生成只读分配建议。
 - [`swarm-health.sh`](./swarm-health.sh) - 汇总 doctor、topology、scan、validate、metrics、board 和 assign。
 - [`record-summary.sh`](./record-summary.sh) - 汇总 `record start` 产生的 pane 日志，生成复盘摘要。
@@ -66,6 +67,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
 
+# 生成依赖图
+skills/auto-tmux/scripts/swarm-deps-graph.sh --dir /tmp/ai_swarm --out /tmp/ai-swarm-deps.md
+
 # 生成 worker 分配建议
 skills/auto-tmux/scripts/swarm-assign.sh --swarm-dir /tmp/ai_swarm --session ai-hub --out /tmp/ai-swarm-assign.md
 
diff --git a/skills/auto-tmux/scripts/auto-tmux-smoke-test.sh b/skills/auto-tmux/scripts/auto-tmux-smoke-test.sh
index c7cdaae..9356db6 100755
--- a/skills/auto-tmux/scripts/auto-tmux-smoke-test.sh
+++ b/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_DEPS_GRAPH="$SCRIPT_DIR/swarm-deps-graph.sh"
 SWARM_ASSIGN="$SCRIPT_DIR/swarm-assign.sh"
 SWARM_HEALTH="$SCRIPT_DIR/swarm-health.sh"
 RECORD_SUMMARY="$SCRIPT_DIR/record-summary.sh"
@@ -26,6 +27,7 @@ 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"
+DEPS_GRAPH_FILE="/tmp/auto-tmux-smoke-deps-graph-$$.md"
 ASSIGN_FILE="/tmp/auto-tmux-smoke-assign-$$.md"
 HEALTH_DIR="/tmp/auto-tmux-smoke-health-$$"
 DISPATCH_PROMPT="/tmp/auto-tmux-smoke-dispatch-$$.md"
@@ -34,7 +36,7 @@ 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" "$RECORD_SUMMARY_FILE" "$BRIEF_DIR" "$WATCH_DIR" "$ARCHIVE_FILE" "$BOARD_FILE" "$ASSIGN_FILE" "$HEALTH_DIR" "$DISPATCH_PROMPT" "$TASK_IMPORT_FILE" "$PASTE_FILE"
+  rm -rf "$SWARM_DIR" "$DEP_SWARM_DIR" "$SNAPSHOT_DIR" "$RECORD_DIR" "$RECORD_SUMMARY_FILE" "$BRIEF_DIR" "$WATCH_DIR" "$ARCHIVE_FILE" "$BOARD_FILE" "$DEPS_GRAPH_FILE" "$ASSIGN_FILE" "$HEALTH_DIR" "$DISPATCH_PROMPT" "$TASK_IMPORT_FILE" "$PASTE_FILE"
 }
 trap cleanup EXIT
 
@@ -50,6 +52,7 @@ bash -n "$SWARM_BRIEF"
 bash -n "$SWARM_WATCH"
 bash -n "$SWARM_ARCHIVE"
 bash -n "$SWARM_BOARD"
+bash -n "$SWARM_DEPS_GRAPH"
 bash -n "$SWARM_ASSIGN"
 bash -n "$SWARM_HEALTH"
 bash -n "$RECORD_SUMMARY"
@@ -148,6 +151,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_DEPS_GRAPH" --dir "$SWARM_DIR" --out "$DEPS_GRAPH_FILE" >/tmp/auto-tmux-smoke-deps-graph.txt
+grep -q 'auto-tmux Swarm Dependency Graph' "$DEPS_GRAPH_FILE"
+grep -q 'task_dep_a --> task_dep_b' "$DEPS_GRAPH_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"
diff --git a/skills/auto-tmux/scripts/auto-tmux.sh b/skills/auto-tmux/scripts/auto-tmux.sh
index 44d7967..f33218f 100755
--- a/skills/auto-tmux/scripts/auto-tmux.sh
+++ b/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 swarm-assign.sh swarm-health.sh record-summary.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-deps-graph.sh swarm-assign.sh swarm-health.sh record-summary.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
diff --git a/skills/auto-tmux/scripts/swarm-deps-graph.sh b/skills/auto-tmux/scripts/swarm-deps-graph.sh
new file mode 100755
index 0000000..df2d6de
--- /dev/null
+++ b/skills/auto-tmux/scripts/swarm-deps-graph.sh
@@ -0,0 +1,106 @@
+#!/usr/bin/env bash
+# swarm-deps-graph: render swarm task dependencies as Markdown + Mermaid.
+set -euo pipefail
+
+usage() {
+  cat <<'EOF'
+swarm-deps-graph: render auto-tmux task dependencies
+
+Usage:
+  swarm-deps-graph.sh [--dir DIR] [--out FILE]
+
+Defaults:
+  --dir AUTO_TMUX_SWARM_DIR or /tmp/ai_swarm
+  --out stdout
+
+This script is read-only. It does not mutate swarm state.
+EOF
+}
+
+die() {
+  printf 'error: %s\n' "$*" >&2
+  exit 1
+}
+
+swarm_dir="${AUTO_TMUX_SWARM_DIR:-/tmp/ai_swarm}"
+out_file=""
+
+while [[ $# -gt 0 ]]; do
+  case "$1" in
+    --dir|--swarm-dir)
+      swarm_dir="${2:-}"
+      shift 2
+      ;;
+    --out)
+      out_file="${2:-}"
+      shift 2
+      ;;
+    -h|--help)
+      usage
+      exit 0
+      ;;
+    *)
+      die "unknown option: $1"
+      ;;
+  esac
+done
+
+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"
+
+render_graph() {
+  printf '# auto-tmux Swarm Dependency Graph\n\n'
+  printf -- '- dir: `%s`\n' "$swarm_dir"
+  printf -- '- created_at: `%s`\n\n' "$(date -Is)"
+
+  printf '## Mermaid\n\n'
+  printf '```mermaid\n'
+  printf 'flowchart TD\n'
+  awk -F '\t' '
+    function node_id(id) {
+      gsub(/[^A-Za-z0-9_]/, "_", id)
+      return "task_" id
+    }
+    function label(value) {
+      gsub(/"/, "\\\"", value)
+      return value
+    }
+    FILENAME == ARGV[1] {
+      if (FNR == 1) next
+      id = $1
+      status[id] = $2
+      text[id] = $4
+      print "  " node_id(id) "[\"" label(id ": " $2) "\"]"
+      next
+    }
+    FILENAME == ARGV[2] {
+      if (FNR == 1) next
+      print "  " node_id($2) " --> " node_id($1)
+      has_dep = 1
+      next
+    }
+    END {
+      if (!has_dep) print "  empty[\"no dependencies\"]"
+    }
+  ' "$tasks_tsv" "$deps_tsv"
+  printf '```\n\n'
+
+  printf '## Dependencies\n\n'
+  printf '| task | blocked_by |\n'
+  printf '|:---|:---|\n'
+  awk -F '\t' '
+    NR == 1 {next}
+    {print "| `" $1 "` | `" $2 "` |"; found = 1}
+    END {if (!found) print "| - | - |"}
+  ' "$deps_tsv"
+}
+
+if [[ -n "$out_file" ]]; then
+  mkdir -p "$(dirname "$out_file")"
+  render_graph > "$out_file"
+  printf 'swarm dependency graph written: %s\n' "$out_file"
+else
+  render_graph
+fi
diff --git a/skills/auto-tmux/scripts/validate-auto-tmux.sh b/skills/auto-tmux/scripts/validate-auto-tmux.sh
index 7c6927d..9cf7a2d 100755
--- a/skills/auto-tmux/scripts/validate-auto-tmux.sh
+++ b/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-deps-graph.sh"
   "$script_dir/swarm-assign.sh"
   "$script_dir/swarm-health.sh"
   "$script_dir/record-summary.sh"
@@ -106,6 +107,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-deps-graph help" "$script_dir/swarm-deps-graph.sh" --help
 run_gate "swarm-assign help" "$script_dir/swarm-assign.sh" --help
 run_gate "swarm-health help" "$script_dir/swarm-health.sh" --help
 run_gate "record-summary help" "$script_dir/record-summary.sh" --help
@@ -124,6 +126,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-deps-graph.sh"
 require_contains "$skill_dir/SKILL.md" "scripts/swarm-assign.sh"
 require_contains "$skill_dir/SKILL.md" "scripts/swarm-health.sh"
 require_contains "$skill_dir/SKILL.md" "scripts/record-summary.sh"
@@ -139,6 +142,7 @@ 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-deps-graph.sh"
 require_contains "$script_dir/README.md" "swarm-assign.sh"
 require_contains "$script_dir/README.md" "swarm-health.sh"
 require_contains "$script_dir/README.md" "record-summary.sh"
@@ -149,6 +153,7 @@ 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-deps-graph.sh"
 require_contains "$script_dir/AGENTS.md" "swarm-assign.sh"
 require_contains "$script_dir/AGENTS.md" "swarm-health.sh"
 require_contains "$script_dir/AGENTS.md" "record-summary.sh"