From 7f7d75d70cc3f7fce36bd269b36e7f4a49a0ef1c Mon Sep 17 00:00:00 2001
From: tukuaiai <tukuaiai@users.noreply.github.com>
Date: Tue, 19 May 2026 14:52:50 +0800
Subject: [PATCH] docs: skills - close out auto-tmux iteration set

---
 skills/auto-tmux/AGENTS.md                    |  2 +
 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 +
 .../references/iteration-closeout.md          | 58 +++++++++++++++++++
 .../auto-tmux/references/iteration-roadmap.md |  5 +-
 .../auto-tmux/scripts/validate-auto-tmux.sh   |  4 ++
 8 files changed, 71 insertions(+), 2 deletions(-)
 create mode 100644 skills/auto-tmux/references/iteration-closeout.md

diff --git a/skills/auto-tmux/AGENTS.md b/skills/auto-tmux/AGENTS.md
index 80b72f3..6b69887 100644
--- a/skills/auto-tmux/AGENTS.md
+++ b/skills/auto-tmux/AGENTS.md
@@ -56,6 +56,8 @@ skills/auto-tmux/
     ├── swarm-state.md
     ├── prompt-templates.md
     ├── ai-swarm-collaboration.md
+    ├── iteration-roadmap.md
+    ├── iteration-closeout.md
     ├── examples.md
     └── troubleshooting.md
 ```
diff --git a/skills/auto-tmux/SKILL.md b/skills/auto-tmux/SKILL.md
index 0b945c4..405db95 100644
--- a/skills/auto-tmux/SKILL.md
+++ b/skills/auto-tmux/SKILL.md
@@ -295,6 +295,7 @@ skills/auto-tmux/scripts/swarm-dispatch.sh --role worker --target <session>:<win
 - `references/prompt-templates.md`: commander/worker/reviewer 提示词模板和下发方式
 - `references/ai-swarm-collaboration.md`: tmux 蜂群协作历史文档、架构模式、协议、案例和风险限制
 - `references/iteration-roadmap.md`: 多轮迭代记录、能力层和后续候选方向
+- `references/iteration-closeout.md`: 50 轮迭代后的能力收尾、验证链路和维护边界
 - `references/examples.md`: 蜂群协议脚本与长示例
 - `references/troubleshooting.md`: 典型故障到修复路径
 - `scripts/auto-tmux.sh`: 安全封装的 tmux 自动化脚本入口
diff --git a/skills/auto-tmux/references/AGENTS.md b/skills/auto-tmux/references/AGENTS.md
index 8337072..ef1def7 100644
--- a/skills/auto-tmux/references/AGENTS.md
+++ b/skills/auto-tmux/references/AGENTS.md
@@ -14,4 +14,5 @@
 - 角色化阅读路线写入 `reading-paths.md`；新增关键 reference 时同步判断是否进入某个角色路径。
 - 操作事故处理流程写入 `incident-runbook.md`；新增控制类脚本时同步补事故处理路径。
 - 脚本场景速查写入 `script-cheatsheet.md`；新增脚本时必须放入对应场景分组。
+- 多轮迭代收尾写入 `iteration-closeout.md`；后续新增能力时同步更新能力层和维护边界。
 - 不确定的 tmux 行为必须给出验证命令，不编造。
diff --git a/skills/auto-tmux/references/README.md b/skills/auto-tmux/references/README.md
index 546d06e..f7b604c 100644
--- a/skills/auto-tmux/references/README.md
+++ b/skills/auto-tmux/references/README.md
@@ -19,5 +19,6 @@
 | [prompt-templates.md](./prompt-templates.md) | commander/worker/reviewer 提示词模板和下发方式 |
 | [ai-swarm-collaboration.md](./ai-swarm-collaboration.md) | tmux 蜂群协作完整说明、架构模式、协议、案例和风险限制 |
 | [iteration-roadmap.md](./iteration-roadmap.md) | 多轮迭代记录、能力层和后续候选方向 |
+| [iteration-closeout.md](./iteration-closeout.md) | 50 轮迭代后的能力收尾、验证链路和维护边界 |
 | [examples.md](./examples.md) | 巡检、救援、审计和多 AI 工作台示例 |
 | [troubleshooting.md](./troubleshooting.md) | 常见故障与修复路径 |
diff --git a/skills/auto-tmux/references/index.md b/skills/auto-tmux/references/index.md
index 5095f38..b96ef04 100644
--- a/skills/auto-tmux/references/index.md
+++ b/skills/auto-tmux/references/index.md
@@ -16,6 +16,7 @@
 - `prompt-templates.md`：commander/worker/reviewer 提示词模板和下发方式
 - `ai-swarm-collaboration.md`：tmux 蜂群协作完整说明、架构模式、协议、案例和风险限制
 - `iteration-roadmap.md`：多轮迭代记录、能力层和后续候选方向
+- `iteration-closeout.md`：50 轮迭代后的能力收尾、验证链路和维护边界
 - `examples.md`：蜂群巡检脚本、自动救援脚本、Skill Seeker 抓取示例
 - `troubleshooting.md`：常见报错与修复路径
 
diff --git a/skills/auto-tmux/references/iteration-closeout.md b/skills/auto-tmux/references/iteration-closeout.md
new file mode 100644
index 0000000..b062e63
--- /dev/null
+++ b/skills/auto-tmux/references/iteration-closeout.md
@@ -0,0 +1,58 @@
+# auto-tmux Iteration Closeout
+
+本文件记录 `auto-tmux` 50 轮迭代后的收尾状态，用于后续维护者快速判断能力边界、验证路径和继续优化方向。
+
+## 最终能力层
+
+| 能力层 | 当前状态 | 主要入口 |
+|:---|:---|:---|
+| tmux 观察 | 已覆盖本地 topology、capture、inspect、scan、snapshot | `auto-tmux.sh` |
+| tmux 控制 | 已覆盖 send、paste、broadcast、rescue，并接入安全预检 | `auto-tmux.sh`、`safety-check.sh` |
+| 蜂群状态 | 已覆盖任务、依赖、锁、状态日志、指标和报告 | `swarm-state.sh` |
+| 蜂群协作 | 已覆盖 prompt 渲染、dry-run 下发、分配建议、健康检查 | `render-swarm-prompt.sh`、`swarm-dispatch.sh`、`swarm-assign.sh`、`swarm-health.sh` |
+| 只读取证 | 已覆盖本地 brief/watch/archive 和远程 SSH 只读采集 | `swarm-brief.sh`、`swarm-watch.sh`、`swarm-archive.sh`、`remote-readonly.sh` |
+| 交付报告 | 已覆盖 board、deps、timeline、blockers、results、report pack、manifest、tar | `swarm-report-pack.sh` |
+| 审计门禁 | 已覆盖 JSONL 字段、review checklist、report pack 验证和 package consistency | `check-jsonl.sh`、`review-checklist.sh`、`verify-report-pack.sh`、`audit-package.sh` |
+| 事故复盘 | 已覆盖误发送、误广播、远程采集失败和敏感信息风险模板 | `incident-report.sh`、`incident-runbook.md` |
+
+## 验证链路
+
+每次修改 `skills/auto-tmux` 后，至少运行：
+
+```bash
+skills/auto-tmux/scripts/validate-auto-tmux.sh
+skills/auto-skill/scripts/validate-skill.sh skills/auto-tmux --strict
+git diff --check
+make test
+```
+
+其中 `validate-auto-tmux.sh` 已经内置：
+
+- Bash 语法和可执行权限检查。
+- 主要脚本 `--help` 检查。
+- report pack、JSONL、review checklist、incident report 和远程 fake SSH 最小验证。
+- `audit-package.sh` 包索引一致性审计。
+- auto-skill strict 验证。
+- tmux smoke test。
+
+## 维护边界
+
+- 默认只读优先：观察、取证、健康检查、报告包和远程采集不得升级为隐式控制。
+- 控制动作必须显式目标：send、paste、broadcast、rescue 和 dispatch 必须明确 session/window/pane 或明确 dry-run。
+- 远程默认只读：`remote-readonly.sh` 不允许出现 `send-keys`、`kill-*`、配置写入或状态修改。
+- 新增脚本必须同步更新 `SKILL.md`、`scripts/README.md`、`scripts/AGENTS.md`、`validate-auto-tmux.sh` 和 `script-cheatsheet.md`。
+- 新增 reference 必须同步更新 `references/README.md`、`references/index.md` 和 `SKILL.md`。
+- 新增机器可读输出必须同步更新 `jsonl-schema.md`，并接入 `check-jsonl.sh` 或等价门禁。
+
+## 下一阶段候选
+
+| 方向 | 说明 |
+|:---|:---|
+| 回放能力 | 从 `record-summary.sh` 产物中生成可审计 replay 摘要，但不能自动重放危险输入。 |
+| CI 分层 | 把慢 smoke test 和静态包审计拆成 fast/slow 两档，便于 CI 和本地快速检查。 |
+| 示例包 | 增加最小可复制的 `/tmp/ai_swarm` 示例数据，方便验证 board、timeline 和 report pack。 |
+| 文档压缩 | 将长脚本清单收敛成角色化阅读路径，避免 SKILL 入口继续膨胀。 |
+
+## 收尾结论
+
+`auto-tmux` 已从单一 tmux 辅助脚本扩展为可观察、可控制、可协作、可取证、可审计、可复盘的 tmux 自动化技能包。后续优化应优先保持安全边界和门禁完整性，而不是继续堆叠无约束的控制能力。
diff --git a/skills/auto-tmux/references/iteration-roadmap.md b/skills/auto-tmux/references/iteration-roadmap.md
index 8f670db..5a940e3 100644
--- a/skills/auto-tmux/references/iteration-roadmap.md
+++ b/skills/auto-tmux/references/iteration-roadmap.md
@@ -54,13 +54,14 @@
 | 46 | `07d4850` | 操作事故 runbook | `incident-runbook.md` |
 | 47 | `d6a309f` | 事故报告脚本 | `incident-report.sh` |
 | 48 | `1ac2ee4` | 脚本清单速查 | `script-cheatsheet.md` |
-| 49 | `本轮` | 包一致性审计 | `audit-package.sh` |
+| 49 | `022d812` | 包一致性审计 | `audit-package.sh` |
+| 50 | `本轮` | 迭代收尾说明 | `iteration-closeout.md` |
 
 ## 后续候选方向
 
 | 优先级 | 方向 | 说明 |
 |:---|:---|:---|
-| P3 | 迭代收尾说明 | 汇总 50 轮能力层、验证路径和后续维护边界 |
+| P3 | 示例包 | 增加最小可复制的 `/tmp/ai_swarm` 示例数据，方便演示报告链路 |
 
 ## 每轮验收清单
 
diff --git a/skills/auto-tmux/scripts/validate-auto-tmux.sh b/skills/auto-tmux/scripts/validate-auto-tmux.sh
index 5cb3d8c..7ef077b 100755
--- a/skills/auto-tmux/scripts/validate-auto-tmux.sh
+++ b/skills/auto-tmux/scripts/validate-auto-tmux.sh
@@ -245,6 +245,7 @@ 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/index.md" "iteration-closeout.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"
@@ -253,6 +254,7 @@ 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/README.md" "iteration-closeout.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"
@@ -262,6 +264,8 @@ 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/iteration-closeout.md" "audit-package.sh"
+require_contains "$skill_dir/references/iteration-closeout.md" "validate-auto-tmux.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"