From e84c40ce5d352a5f0d7b922ec6ffe4557ff9c32f Mon Sep 17 00:00:00 2001
From: tukuaiai <tukuaiai@users.noreply.github.com>
Date: Tue, 19 May 2026 14:43:03 +0800
Subject: [PATCH] docs: skills - add auto-tmux script cheatsheet

---
 skills/auto-tmux/AGENTS.md                    |  1 +
 skills/auto-tmux/SKILL.md                     |  1 +
 skills/auto-tmux/references/AGENTS.md         |  1 +
 skills/auto-tmux/references/README.md         |  1 +
 skills/auto-tmux/references/index.md          |  1 +
 .../auto-tmux/references/iteration-roadmap.md |  5 +-
 .../auto-tmux/references/script-cheatsheet.md | 55 +++++++++++++++++++
 .../auto-tmux/scripts/validate-auto-tmux.sh   |  4 ++
 8 files changed, 67 insertions(+), 2 deletions(-)
 create mode 100644 skills/auto-tmux/references/script-cheatsheet.md

diff --git a/skills/auto-tmux/AGENTS.md b/skills/auto-tmux/AGENTS.md
index a73aa4d..c57b8a9 100644
--- a/skills/auto-tmux/AGENTS.md
+++ b/skills/auto-tmux/AGENTS.md
@@ -51,6 +51,7 @@ skills/auto-tmux/
     ├── report-pack-review.md
     ├── reading-paths.md
     ├── incident-runbook.md
+    ├── script-cheatsheet.md
     ├── swarm-state.md
     ├── prompt-templates.md
     ├── ai-swarm-collaboration.md
diff --git a/skills/auto-tmux/SKILL.md b/skills/auto-tmux/SKILL.md
index a8745bd..d8cdf23 100644
--- a/skills/auto-tmux/SKILL.md
+++ b/skills/auto-tmux/SKILL.md
@@ -290,6 +290,7 @@ skills/auto-tmux/scripts/swarm-dispatch.sh --role worker --target <session>:<win
 - `references/report-pack-review.md`: report pack reviewer 最短验收路径
 - `references/reading-paths.md`: commander、worker、reviewer、operator 的角色化阅读路线
 - `references/incident-runbook.md`: 误发送、误广播、远程采集失败和敏感信息风险处理流程
+- `references/script-cheatsheet.md`: 观察、控制、协作、报告、审计和事故处理脚本速查
 - `references/swarm-state.md`: 蜂群状态、任务、锁和报告协议
 - `references/prompt-templates.md`: commander/worker/reviewer 提示词模板和下发方式
 - `references/ai-swarm-collaboration.md`: tmux 蜂群协作历史文档、架构模式、协议、案例和风险限制
diff --git a/skills/auto-tmux/references/AGENTS.md b/skills/auto-tmux/references/AGENTS.md
index 24c4dfb..8337072 100644
--- a/skills/auto-tmux/references/AGENTS.md
+++ b/skills/auto-tmux/references/AGENTS.md
@@ -13,4 +13,5 @@
 - report pack 审查路径写入 `report-pack-review.md`；新增报告文件时同步更新阅读顺序和通过标准。
 - 角色化阅读路线写入 `reading-paths.md`；新增关键 reference 时同步判断是否进入某个角色路径。
 - 操作事故处理流程写入 `incident-runbook.md`；新增控制类脚本时同步补事故处理路径。
+- 脚本场景速查写入 `script-cheatsheet.md`；新增脚本时必须放入对应场景分组。
 - 不确定的 tmux 行为必须给出验证命令，不编造。
diff --git a/skills/auto-tmux/references/README.md b/skills/auto-tmux/references/README.md
index 965708e..546d06e 100644
--- a/skills/auto-tmux/references/README.md
+++ b/skills/auto-tmux/references/README.md
@@ -14,6 +14,7 @@
 | [report-pack-review.md](./report-pack-review.md) | report pack reviewer 最短验收路径 |
 | [reading-paths.md](./reading-paths.md) | commander、worker、reviewer、operator 的角色化阅读路线 |
 | [incident-runbook.md](./incident-runbook.md) | 误发送、误广播、远程采集失败和敏感信息风险处理流程 |
+| [script-cheatsheet.md](./script-cheatsheet.md) | 观察、控制、协作、报告、审计和事故处理脚本速查 |
 | [swarm-state.md](./swarm-state.md) | 蜂群状态、任务、锁和报告协议 |
 | [prompt-templates.md](./prompt-templates.md) | commander/worker/reviewer 提示词模板和下发方式 |
 | [ai-swarm-collaboration.md](./ai-swarm-collaboration.md) | tmux 蜂群协作完整说明、架构模式、协议、案例和风险限制 |
diff --git a/skills/auto-tmux/references/index.md b/skills/auto-tmux/references/index.md
index 8bb3e48..5095f38 100644
--- a/skills/auto-tmux/references/index.md
+++ b/skills/auto-tmux/references/index.md
@@ -11,6 +11,7 @@
 - `report-pack-review.md`：report pack reviewer 最短验收路径
 - `reading-paths.md`：commander、worker、reviewer、operator 的角色化阅读路线
 - `incident-runbook.md`：误发送、误广播、远程采集失败和敏感信息风险处理流程
+- `script-cheatsheet.md`：观察、控制、协作、报告、审计和事故处理脚本速查
 - `swarm-state.md`：蜂群状态、任务、锁和报告协议
 - `prompt-templates.md`：commander/worker/reviewer 提示词模板和下发方式
 - `ai-swarm-collaboration.md`：tmux 蜂群协作完整说明、架构模式、协议、案例和风险限制
diff --git a/skills/auto-tmux/references/iteration-roadmap.md b/skills/auto-tmux/references/iteration-roadmap.md
index 4d422db..a59679a 100644
--- a/skills/auto-tmux/references/iteration-roadmap.md
+++ b/skills/auto-tmux/references/iteration-roadmap.md
@@ -52,13 +52,14 @@
 | 44 | `d448fdb` | report pack 自检文档 | `report-pack-review.md` |
 | 45 | `63d7831` | 文档摘要索引 | `reading-paths.md` |
 | 46 | `07d4850` | 操作事故 runbook | `incident-runbook.md` |
-| 47 | `本轮` | 事故报告脚本 | `incident-report.sh` |
+| 47 | `d6a309f` | 事故报告脚本 | `incident-report.sh` |
+| 48 | `本轮` | 脚本清单速查 | `script-cheatsheet.md` |
 
 ## 后续候选方向
 
 | 优先级 | 方向 | 说明 |
 |:---|:---|:---|
-| P3 | 脚本清单速查 | 为所有脚本补一页按场景分类的命令速查 |
+| P3 | 最终一致性审计 | 对 roadmap、脚本索引和 references 做一次收尾一致性检查 |
 
 ## 每轮验收清单
 
diff --git a/skills/auto-tmux/references/script-cheatsheet.md b/skills/auto-tmux/references/script-cheatsheet.md
new file mode 100644
index 0000000..6e016c7
--- /dev/null
+++ b/skills/auto-tmux/references/script-cheatsheet.md
@@ -0,0 +1,55 @@
+# auto-tmux Script Cheatsheet
+
+本文件按场景组织脚本入口，适合已经知道目标、只需要快速选命令的人。
+
+## 观察与取证
+
+```bash
+skills/auto-tmux/scripts/auto-tmux.sh topology --session ai-hub
+skills/auto-tmux/scripts/auto-tmux.sh inspect -t ai-hub:1.0 -n 80
+skills/auto-tmux/scripts/auto-tmux.sh snapshot --session ai-hub --dir /tmp/auto-tmux-snapshot
+skills/auto-tmux/scripts/remote-readonly.sh --host user@example.com --session ai-hub --out /tmp/auto-tmux-remote
+```
+
+## 控制与救援
+
+```bash
+skills/auto-tmux/scripts/safety-check.sh --text "make test"
+skills/auto-tmux/scripts/auto-tmux.sh send -t ai-hub:1.0 --text "make test" --enter
+skills/auto-tmux/scripts/auto-tmux.sh rescue -t ai-hub:1.0 --pattern "(y/n)" --reply y --dry-run
+skills/auto-tmux/scripts/swarm-dispatch.sh --role worker --target ai-hub:1.0 --task "run tests" --send --dry-run
+```
+
+## 状态与协作
+
+```bash
+skills/auto-tmux/scripts/swarm-state.sh init --dir /tmp/ai_swarm
+skills/auto-tmux/scripts/swarm-state.sh task-ready --dir /tmp/ai_swarm
+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
+```
+
+## 报告与交付
+
+```bash
+skills/auto-tmux/scripts/swarm-board.sh --dir /tmp/ai_swarm --out /tmp/ai-swarm-board.md
+skills/auto-tmux/scripts/swarm-results.sh --dir /tmp/ai_swarm --out /tmp/ai-swarm-results.md --jsonl /tmp/ai-swarm-results.jsonl
+skills/auto-tmux/scripts/swarm-report-pack.sh --dir /tmp/ai_swarm --session ai-hub --out /tmp/ai-swarm-report-pack --tar
+skills/auto-tmux/scripts/verify-report-pack.sh --pack /tmp/ai-swarm-report-pack
+```
+
+## 审计与事故
+
+```bash
+skills/auto-tmux/scripts/check-jsonl.sh /tmp/ai-swarm-results.jsonl --require-key type --require-key id --require-key status
+skills/auto-tmux/scripts/review-checklist.sh --pack /tmp/ai-swarm-report-pack --strict
+skills/auto-tmux/scripts/incident-report.sh --type mis-send --out /tmp/auto-tmux-incident.md
+```
+
+## 技能门禁
+
+```bash
+skills/auto-tmux/scripts/validate-auto-tmux.sh
+skills/auto-skill/scripts/validate-skill.sh skills/auto-tmux --strict
+make test
+```
diff --git a/skills/auto-tmux/scripts/validate-auto-tmux.sh b/skills/auto-tmux/scripts/validate-auto-tmux.sh
index d2949ab..f6f6f67 100755
--- a/skills/auto-tmux/scripts/validate-auto-tmux.sh
+++ b/skills/auto-tmux/scripts/validate-auto-tmux.sh
@@ -240,6 +240,7 @@ require_contains "$skill_dir/references/index.md" "jsonl-schema.md"
 require_contains "$skill_dir/references/index.md" "report-pack-review.md"
 require_contains "$skill_dir/references/index.md" "reading-paths.md"
 require_contains "$skill_dir/references/index.md" "incident-runbook.md"
+require_contains "$skill_dir/references/index.md" "script-cheatsheet.md"
 require_contains "$skill_dir/references/README.md" "swarm-state.md"
 require_contains "$skill_dir/references/README.md" "safety-policy.md"
 require_contains "$skill_dir/references/README.md" "session-safety.md"
@@ -247,6 +248,7 @@ require_contains "$skill_dir/references/README.md" "jsonl-schema.md"
 require_contains "$skill_dir/references/README.md" "report-pack-review.md"
 require_contains "$skill_dir/references/README.md" "reading-paths.md"
 require_contains "$skill_dir/references/README.md" "incident-runbook.md"
+require_contains "$skill_dir/references/README.md" "script-cheatsheet.md"
 require_contains "$skill_dir/references/jsonl-schema.md" "swarm-result"
 require_contains "$skill_dir/references/jsonl-schema.md" "remote-readonly"
 require_contains "$skill_dir/references/report-pack-review.md" "verify-report-pack.sh"
@@ -254,6 +256,8 @@ require_contains "$skill_dir/references/reading-paths.md" "Commander"
 require_contains "$skill_dir/references/reading-paths.md" "Reviewer"
 require_contains "$skill_dir/references/incident-runbook.md" "误发送"
 require_contains "$skill_dir/references/incident-runbook.md" "误广播"
+require_contains "$skill_dir/references/script-cheatsheet.md" "verify-report-pack.sh"
+require_contains "$skill_dir/references/script-cheatsheet.md" "incident-report.sh"
 require_contains "$skill_dir/references/session-safety.md" "remote-readonly.sh"
 require_contains "$skill_dir/references/session-safety.md" "远程默认只读"
 require_contains "$skill_dir/references/session-safety.md" "metadata.jsonl"