feat: skills - expand auto-tmux prompt tooling

skills/auto-tmux/references/README.md

@@ -9,6 +9,7 @@
 | [api.md](./api.md) | tmux / oh-my-tmux 常用命令与配置速查 |
 | [automation.md](./automation.md) | `auto-tmux.sh` 脚本子命令、安全模型和 AI 蜂群协作流程 |
 | [swarm-state.md](./swarm-state.md) | 蜂群状态、任务、锁和报告协议 |
+| [prompt-templates.md](./prompt-templates.md) | commander/worker/reviewer 提示词模板和下发方式 |
 | [ai-swarm-collaboration.md](./ai-swarm-collaboration.md) | tmux 蜂群协作完整说明、架构模式、协议、案例和风险限制 |
 | [examples.md](./examples.md) | 巡检、救援、审计和多 AI 工作台示例 |
 | [troubleshooting.md](./troubleshooting.md) | 常见故障与修复路径 |

skills/auto-tmux/references/ai-swarm-collaboration.md

@@ -22,6 +22,7 @@ tmux 蜂群协作的核心是：让 AI 不再只是孤立会话，而是通过 t
 | 感知 | `capture-pane` / `auto-tmux.sh capture` | 读取指定终端输出 |
 | 控制 | `send-keys` / `auto-tmux.sh send` | 向指定终端发送按键或命令 |
 | 巡检 | `auto-tmux.sh scan` | 批量检查多个 pane 状态 |
+| 广播 | `auto-tmux.sh broadcast` | 受控批量下发同一指令 |
 | 救援 | `auto-tmux.sh rescue` | 对等待确认、卡住或异常的 pane 做最小干预 |
 | 记录 | `pipe-pane` / `auto-tmux.sh record` | 保留长任务审计日志 |
 | 协调 | `swarm-state.sh` + 明确 target | 任务同步、分工、加锁、避免冲突 |
@@ -291,6 +292,12 @@ skills/auto-tmux/scripts/auto-tmux.sh rescue -t "$target" --pattern "(y/n)" --re
 
 ### 7.1 Worker 模板
 
+推荐直接渲染：
+
+```bash
+skills/auto-tmux/scripts/render-swarm-prompt.sh worker --target <target> --task "只处理指定子任务"
+```
+
 ```markdown
 你是 tmux AI 蜂群中的 worker。
 
@@ -304,6 +311,12 @@ skills/auto-tmux/scripts/auto-tmux.sh rescue -t "$target" --pattern "(y/n)" --re
 
 ### 7.2 Commander 模板
 
+推荐直接渲染：
+
+```bash
+skills/auto-tmux/scripts/render-swarm-prompt.sh commander --session ai-hub --task "拆分并推进任务"
+```
+
 ```markdown
 你是 tmux AI 蜂群中的 commander。
 

skills/auto-tmux/references/automation.md

@@ -14,9 +14,11 @@
 
 | 子命令 | 用途 | 风险控制 |
 |:---|:---|:---|
+| `doctor` | 检查 tmux、脚本、资产、session 健康状态 | 只读诊断 |
 | `topology` | 列出 session/window/pane 拓扑 | 只读 |
 | `capture` | 读取指定 pane 最近输出 | 默认脱敏，可保存到文件 |
 | `send` | 向指定 pane 发送文本或按键 | 先打印上下文，危险文本需 `--force` |
+| `broadcast` | 向指定 session 全部 pane 发送文本或按键 | 必须显式 session，支持 `--dry-run` |
 | `rescue` | pattern 命中后发送确认 | 不命中不发送 |
 | `scan` | 批量巡检 pane 输出 | 可按 session 限定范围 |
 | `record` | 开启/停止 pane 输出审计日志 | 文件写入到显式目录 |
@@ -26,6 +28,12 @@
 
 ## 典型流程
 
+### 0. 诊断环境
+
+```bash
+skills/auto-tmux/scripts/auto-tmux.sh doctor --session ai-hub
+```
+
 ### 1. 建立 AI 工作台
 
 ```bash
@@ -56,6 +64,12 @@ skills/auto-tmux/scripts/auto-tmux.sh scan --session ai-hub --pattern "ERROR|Tra
 skills/auto-tmux/scripts/auto-tmux.sh scan --session ai-hub --save-dir /tmp/auto-tmux-scan
 ```
 
+受控广播前先预览：
+
+```bash
+skills/auto-tmux/scripts/auto-tmux.sh broadcast --session ai-hub --text "pwd" --enter --dry-run
+```
+
 生成完整证据快照：
 
 ```bash
@@ -165,8 +179,10 @@ skills/auto-tmux/scripts/swarm-state.sh report
 ```bash
 bash -n skills/auto-tmux/scripts/auto-tmux.sh
 bash -n skills/auto-tmux/scripts/swarm-state.sh
+bash -n skills/auto-tmux/scripts/render-swarm-prompt.sh
 skills/auto-tmux/scripts/auto-tmux.sh help
 skills/auto-tmux/scripts/swarm-state.sh help
+skills/auto-tmux/scripts/render-swarm-prompt.sh commander --session ai-hub --task "smoke"
 skills/auto-tmux/scripts/auto-tmux-smoke-test.sh
 skills/auto-skill/scripts/validate-skill.sh skills/auto-tmux --strict
 ```

skills/auto-tmux/references/index.md

@@ -6,6 +6,7 @@
 - `api.md`：tmux/oh-my-tmux 常用命令、同步广播、安全写法
 - `automation.md`：`scripts/auto-tmux.sh` 子命令、安全模型与 AI 蜂群协作流程
 - `swarm-state.md`：蜂群状态、任务、锁和报告协议
+- `prompt-templates.md`：commander/worker/reviewer 提示词模板和下发方式
 - `ai-swarm-collaboration.md`：tmux 蜂群协作完整说明、架构模式、协议、案例和风险限制
 - `examples.md`：蜂群巡检脚本、自动救援脚本、Skill Seeker 抓取示例
 - `troubleshooting.md`：常见报错与修复路径

skills/auto-tmux/references/prompt-templates.md

@@ -0,0 +1,92 @@
+# Swarm Prompt Templates
+
+`scripts/render-swarm-prompt.sh` 用于渲染 tmux 蜂群协作的 commander、worker 和 reviewer 提示词。它把常用协作协议固化成可复制模板，避免每次手写时遗漏边界、状态、锁和验收要求。
+
+## 子命令
+
+| 角色 | 命令 | 用途 |
+|:---|:---|:---|
+| commander | `render-swarm-prompt.sh commander` | 任务拆分、巡检、救援、验收 |
+| worker | `render-swarm-prompt.sh worker` | 执行单一子任务并回报证据 |
+| reviewer | `render-swarm-prompt.sh reviewer` | 独立审查 worker 产出 |
+
+## Commander Prompt
+
+```bash
+skills/auto-tmux/scripts/render-swarm-prompt.sh commander \
+  --session ai-hub \
+  --swarm-dir /tmp/ai_swarm \
+  --task "重构 README 实验性方法入口"
+```
+
+适用场景：
+
+- 开始一个多 worker 协作任务。
+- 需要统一任务拆分、锁、巡检和验收。
+- 需要让 commander 只做调度，不直接混入 worker 实现。
+
+## Worker Prompt
+
+先获取 worker target：
+
+```bash
+target="$(tmux list-panes -t ai-hub:worker1 -F '#S:#I.#P' | head -n 1)"
+```
+
+渲染 worker 提示词：
+
+```bash
+skills/auto-tmux/scripts/render-swarm-prompt.sh worker \
+  --session ai-hub \
+  --target "$target" \
+  --swarm-dir /tmp/ai_swarm \
+  --task "只检查 docs/research/README.md 的链接和锚点"
+```
+
+适用场景：
+
+- 给某个 worker 下发边界清晰的单一任务。
+- 需要强制 worker 在修改前加锁，完成后写状态和结果。
+- 需要让 worker 汇报修改文件、验证结果、风险和下一步。
+
+## Reviewer Prompt
+
+```bash
+skills/auto-tmux/scripts/render-swarm-prompt.sh reviewer \
+  --session ai-hub \
+  --swarm-dir /tmp/ai_swarm \
+  --task "审查本轮 auto-tmux 脚本和文档改动"
+```
+
+适用场景：
+
+- worker 完成后，需要另一个 AI 做独立审查。
+- 需要重点检查 correctness、越界修改、缺失测试、文档不同步。
+- 需要避免同一上下文自我确认。
+
+## 推荐下发方式
+
+渲染到临时文件：
+
+```bash
+skills/auto-tmux/scripts/render-swarm-prompt.sh worker \
+  --target "$target" \
+  --task "运行 make test 并分析失败" \
+  > /tmp/worker-prompt.md
+```
+
+发送到 worker：
+
+```bash
+skills/auto-tmux/scripts/auto-tmux.sh send \
+  -t "$target" \
+  --text "$(cat /tmp/worker-prompt.md)" \
+  --enter
+```
+
+## 注意事项
+
+- Prompt 只定义职责和边界，不替代测试、lint、diff、CI 等硬门禁。
+- commander、worker、reviewer 应使用不同 pane，避免角色混淆。
+- 长任务必须配合 `record` 或 `snapshot` 保留证据。
+- 多 worker 修改同一资源前必须配合 `swarm-state.sh lock-acquire`。