Files
vibe-coding-cn/skills/auto-tmux/scripts/AGENTS.md
T

25 lines
1.2 KiB
Markdown

# skills/auto-tmux/scripts
本目录承载 `auto-tmux` 的可执行脚本层。脚本必须安全封装 tmux 常用操作,减少手写 `capture-pane` / `send-keys` 时的误控风险。
## 目录结构
```text
scripts/
├── AGENTS.md # 本文件:脚本维护规则
├── README.md # 面向人类的脚本入口说明
├── auto-tmux.sh # 统一 tmux 自动化命令入口
├── swarm-state.sh # 蜂群状态、任务、锁和报告管理
└── auto-tmux-smoke-test.sh # 临时 tmux 会话端到端自测
```
## 维护规则
- 脚本必须使用 Bash 标准能力,不引入额外运行时依赖。
- 发送按键类功能必须先验证目标 pane 存在,并优先打印上下文。
- 捕获输出默认脱敏;只有显式 `--no-redact` 才允许输出原文。
- 批量救援必须通过 pattern 匹配触发,不允许无条件向所有 pane 发送输入。
- 状态脚本只能写入显式状态目录,不保存密钥、Token、密码或私密项目内容。
- 自测脚本必须创建独立临时 tmux session,并在退出时清理。
- 新增脚本后必须更新 `README.md``SKILL.md``references/index.md`,并运行 `bash -n` 与 skill strict 校验。