mirror of
https://github.com/tradecatlabs/vibe-coding-cn.git
synced 2026-08-10 01:20:59 +00:00
tukuaiai
66 lines
3.1 KiB
Markdown
66 lines
3.1 KiB
Markdown
# auto-tmux
|
|
|
|
`auto-tmux` 是 tmux 自动化操控技能，用于读取 pane 输出、发送按键、批量巡检、救援卡住的终端，以及组织多 AI 终端协作。
|
|
|
|
## 入口
|
|
|
|
- [SKILL.md](./SKILL.md) - 技能触发条件、命令片段、规则和质量门禁。
|
|
- [scripts/](./scripts/) - 安全封装的 tmux 自动化脚本。
|
|
- [references/](./references/) - tmux / oh-my-tmux 参考、示例和故障排查。
|
|
- [assets/](./assets/) - 指向仓库外部 submodule 的只读软链接入口。
|
|
|
|
## 资产来源
|
|
|
|
| 入口 | 指向 | 用途 |
|
|
|:---|:---|:---|
|
|
| `assets/oh-my-tmux` | `tools/external/.tmux` | gpakosz/oh-my-tmux 配置参考 |
|
|
| `assets/tmux-src` | `tools/external/tmux` | tmux 上游源码参考 |
|
|
|
|
## 快速验证
|
|
|
|
```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/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-export.sh
|
|
bash -n skills/auto-tmux/scripts/swarm-timeline.sh
|
|
bash -n skills/auto-tmux/scripts/swarm-blockers.sh
|
|
bash -n skills/auto-tmux/scripts/swarm-results.sh
|
|
bash -n skills/auto-tmux/scripts/swarm-report-pack.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/remote-readonly.sh
|
|
bash -n skills/auto-tmux/scripts/record-summary.sh
|
|
bash -n skills/auto-tmux/scripts/check-jsonl.sh
|
|
bash -n skills/auto-tmux/scripts/review-checklist.sh
|
|
bash -n skills/auto-tmux/scripts/verify-report-pack.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
|
|
skills/auto-tmux/scripts/auto-tmux.sh help
|
|
skills/auto-tmux/scripts/swarm-state.sh help
|
|
skills/auto-tmux/scripts/swarm-brief.sh --help
|
|
skills/auto-tmux/scripts/safety-check.sh --text "make test"
|
|
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-tmux/scripts/validate-auto-tmux.sh
|
|
skills/auto-skill/scripts/validate-skill.sh skills/auto-tmux --strict
|
|
```
|
|
|
|
## 使用边界
|
|
|
|
- 优先使用 `scripts/auto-tmux.sh`，需要低层调试时再直接使用 tmux 原生命令。
|
|
- 发送按键前必须先 `capture-pane` 复核目标上下文；脚本会默认打印最近上下文。
|
|
- 发送长文本、粘贴文件或下发 prompt 前先运行 `scripts/safety-check.sh`。
|
|
- SSH/远程场景默认只读，先用 `scripts/remote-readonly.sh` 采集证据，再按 `references/session-safety.md` 判断是否需要人工确认升级。
|
|
- 批量操作前必须先列出 session/window/pane 白名单。
|
|
- 多 worker 并发前用 `swarm-state.sh` 管理任务、锁和状态，避免重复修改同一资源。
|
|
- 不在未知 pane 中发送破坏性命令。
|
|
- 不在本目录复制或修改上游 tmux / oh-my-tmux 源码。
|