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

skills/auto-tmux/scripts

本目录承载 auto-tmux 的可执行脚本层。脚本必须安全封装 tmux 常用操作，减少手写 capture-pane / send-keys 时的误控风险。

目录结构

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 校验。