docs: skills - add auto-tmux script cheatsheet

This commit is contained in:
tukuaiai
2026-05-19 14:43:03 +08:00
parent fc1ecaf6f3
commit e84c40ce5d
8 changed files with 67 additions and 2 deletions
+1
View File
@@ -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
+1
View File
@@ -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 蜂群协作历史文档、架构模式、协议、案例和风险限制
+1
View File
@@ -13,4 +13,5 @@
- report pack 审查路径写入 `report-pack-review.md`;新增报告文件时同步更新阅读顺序和通过标准。
- 角色化阅读路线写入 `reading-paths.md`;新增关键 reference 时同步判断是否进入某个角色路径。
- 操作事故处理流程写入 `incident-runbook.md`;新增控制类脚本时同步补事故处理路径。
- 脚本场景速查写入 `script-cheatsheet.md`;新增脚本时必须放入对应场景分组。
- 不确定的 tmux 行为必须给出验证命令,不编造。
+1
View File
@@ -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 蜂群协作完整说明、架构模式、协议、案例和风险限制 |
+1
View File
@@ -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 蜂群协作完整说明、架构模式、协议、案例和风险限制
@@ -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 做一次收尾一致性检查 |
## 每轮验收清单
@@ -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
```
@@ -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"