From 9239c099e8f7071f9d346a0f57af12ae5df7e729 Mon Sep 17 00:00:00 2001
From: tukuaiai <tukuaiai@users.noreply.github.com>
Date: Tue, 19 May 2026 03:37:15 +0800
Subject: [PATCH] docs: skills - track auto-tmux iteration roadmap

---
 skills/auto-tmux/SKILL.md                     |  1 +
 skills/auto-tmux/references/README.md         |  1 +
 skills/auto-tmux/references/index.md          |  1 +
 .../auto-tmux/references/iteration-roadmap.md | 53 +++++++++++++++++++
 4 files changed, 56 insertions(+)
 create mode 100644 skills/auto-tmux/references/iteration-roadmap.md

diff --git a/skills/auto-tmux/SKILL.md b/skills/auto-tmux/SKILL.md
index 261a882..832c05f 100644
--- a/skills/auto-tmux/SKILL.md
+++ b/skills/auto-tmux/SKILL.md
@@ -242,6 +242,7 @@ skills/auto-tmux/scripts/swarm-dispatch.sh --role worker --target <session>:<win
 - `references/swarm-state.md`: 蜂群状态、任务、锁和报告协议
 - `references/prompt-templates.md`: commander/worker/reviewer 提示词模板和下发方式
 - `references/ai-swarm-collaboration.md`: tmux 蜂群协作历史文档、架构模式、协议、案例和风险限制
+- `references/iteration-roadmap.md`: 多轮迭代记录、能力层和后续候选方向
 - `references/examples.md`: 蜂群协议脚本与长示例
 - `references/troubleshooting.md`: 典型故障到修复路径
 - `scripts/auto-tmux.sh`: 安全封装的 tmux 自动化脚本入口
diff --git a/skills/auto-tmux/references/README.md b/skills/auto-tmux/references/README.md
index d7365f2..53d7aec 100644
--- a/skills/auto-tmux/references/README.md
+++ b/skills/auto-tmux/references/README.md
@@ -11,5 +11,6 @@
 | [swarm-state.md](./swarm-state.md) | 蜂群状态、任务、锁和报告协议 |
 | [prompt-templates.md](./prompt-templates.md) | commander/worker/reviewer 提示词模板和下发方式 |
 | [ai-swarm-collaboration.md](./ai-swarm-collaboration.md) | tmux 蜂群协作完整说明、架构模式、协议、案例和风险限制 |
+| [iteration-roadmap.md](./iteration-roadmap.md) | 多轮迭代记录、能力层和后续候选方向 |
 | [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 51e5dce..536f93b 100644
--- a/skills/auto-tmux/references/index.md
+++ b/skills/auto-tmux/references/index.md
@@ -8,6 +8,7 @@
 - `swarm-state.md`：蜂群状态、任务、锁和报告协议
 - `prompt-templates.md`：commander/worker/reviewer 提示词模板和下发方式
 - `ai-swarm-collaboration.md`：tmux 蜂群协作完整说明、架构模式、协议、案例和风险限制
+- `iteration-roadmap.md`：多轮迭代记录、能力层和后续候选方向
 - `examples.md`：蜂群巡检脚本、自动救援脚本、Skill Seeker 抓取示例
 - `troubleshooting.md`：常见报错与修复路径
 
diff --git a/skills/auto-tmux/references/iteration-roadmap.md b/skills/auto-tmux/references/iteration-roadmap.md
new file mode 100644
index 0000000..a966856
--- /dev/null
+++ b/skills/auto-tmux/references/iteration-roadmap.md
@@ -0,0 +1,53 @@
+# auto-tmux Iteration Roadmap
+
+本文件用于追踪 `auto-tmux` 的多轮迭代，避免后续重复补同一类能力。每轮迭代必须同时满足：脚本或文档有明确增量、`auto-tmux` 专属门禁通过、`auto-skill --strict` 通过、全仓 `make test` 通过。
+
+## 已完成能力
+
+| 轮次 | 提交 | 能力层 | 交付物 |
+|:---|:---|:---|:---|
+| 1 | `843fe5f` | 技能创建 | 初始 `auto-tmux` skill |
+| 2 | `dd97365` | 自动化入口 | `auto-tmux.sh` 基础自动化 |
+| 3 | `55555c2` | 蜂群工具 | `swarm-state.sh` 与协作脚本雏形 |
+| 4 | `feb6baf` | prompt 工具 | commander / worker / reviewer prompt 渲染 |
+| 5 | `f072055` | 交接报告 | `swarm-brief.sh`、`task-next`、`task-block`、`task-fail` |
+| 6 | `11fbb2a` | 质量门禁 | `validate-auto-tmux.sh` |
+| 7 | `04f3ffc` | prompt 下发 | `swarm-dispatch.sh` |
+| 8 | `bc332b3` | 连续巡检 | `swarm-watch.sh` |
+| 9 | `bec9b77` | 锁治理 | `lock-prune --older-than` |
+| 10 | `3f5b0fb` | 状态校验 | `swarm-state.sh validate` |
+| 11 | `ce8a2a7` | 任务导入 | `task-import --file` |
+| 12 | `84a0139` | 任务重试 | `task-list --status/--owner`、`task-reopen` |
+| 13 | `7f5fc7a` | 状态度量 | `swarm-state.sh metrics` |
+| 14 | `b8e77f6` | pane 取证 | `auto-tmux.sh inspect` |
+| 15 | `bc37fc1` | 长文本粘贴 | `auto-tmux.sh paste --file` |
+| 16 | `075a803` | session 清理 | `auto-tmux.sh cleanup --session` |
+
+## 后续候选方向
+
+| 优先级 | 方向 | 说明 |
+|:---|:---|:---|
+| P1 | 任务依赖 | 让任务声明 blocked-by / depends-on，减少 worker 乱序执行 |
+| P1 | 结果归档 | 将 scan、brief、watch、state report 打包成可交接 archive |
+| P1 | 安全策略 | 将危险命令、敏感输出、生产会话规则集中到可维护策略文档 |
+| P2 | worker 分配 | 根据 TODO 队列和空闲 pane 自动生成 dispatch 建议 |
+| P2 | 状态可视化 | 从 `tasks.tsv` 生成 Markdown 看板 |
+| P2 | replay 审计 | 从 record 日志生成复盘摘要 |
+| P3 | 远程 session | SSH 场景下的只读拓扑和安全边界 |
+| P3 | shell completion | 为常用子命令生成补全脚本 |
+
+## 每轮验收清单
+
+```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` 或 `auto-tmux-smoke-test.sh`。
+- 新增状态字段必须同步更新 `swarm-state.md`、`automation.md` 和 smoke test。
+- 新增 prompt 或协作协议必须同步更新 `prompt-templates.md` 或 `ai-swarm-collaboration.md`。
+- 迭代完成后追加本文件的已完成能力表，避免重复实现。