docs: skills - track auto-tmux iteration roadmap

This commit is contained in:
tukuaiai
2026-05-19 03:37:15 +08:00
parent e60785b6ef
commit 9239c099e8
4 changed files with 56 additions and 0 deletions
+1
View File
@@ -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 自动化脚本入口
+1
View File
@@ -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) | 常见故障与修复路径 |
+1
View File
@@ -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`:常见报错与修复路径
@@ -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`
- 迭代完成后追加本文件的已完成能力表,避免重复实现。