chore: assets - expose repo sources with symlinks

2026-08-22 07:18:05 +00:00 · 2026-04-28 19:51:28 +08:00
parent be037c4b9b
commit 133da9779a
89 changed files with 119 additions and 13769 deletions
@@ -0,0 +1,33 @@
+# assets/skills/tmux-autopilot
+
+本目录是 tmux 自动化操控技能：面向 AI 终端巡检、按键注入、蜂群协作与 oh-my-tmux 配置复用。
+
+## 目录结构
+
+```text
+assets/skills/tmux-autopilot/
+├── AGENTS.md                 # 本文件：目录职责、结构与边界
+├── SKILL.md                  # 技能入口：触发条件、命令片段、规则与质量门
+├── assets/                   # 外部 tmux 相关仓库的只读软链接入口
+│   ├── oh-my-tmux -> ../../../repos/.tmux
+│   └── tmux-src -> ../../../repos/tmux
+└── references/               # 长文档、示例与故障排查
+    ├── index.md
+    ├── getting_started.md
+    ├── api.md
+    ├── examples.md
+    └── troubleshooting.md
+```
+
+## 职责边界
+
+- `assets/oh-my-tmux` 只暴露 gpakosz/oh-my-tmux submodule，不在技能目录内复制配置源码。
+- `assets/tmux-src` 只暴露 tmux/tmux submodule，供需要查看源码或上游文档时定位。
+- 技能文档可以引用软链接入口；更新上游内容必须通过 `assets/repos/` 下的 submodule 指针完成。
+- 不在本目录直接修改 submodule 内容；如需改造，先 fork 上游并更新 submodule 来源。
+
+## 依赖关系
+
+- 上游来源：`assets/repos/.tmux` 与 `assets/repos/tmux`。
+- 下游使用：`SKILL.md` 和 `references/` 中的命令示例。
+- 验证入口：`assets/skills/auto-skill/scripts/validate-skill.sh assets/skills/tmux-autopilot --strict`。
@@ -5,7 +5,7 @@ description: "tmux 自动化操控：读取/广播/救援 session|window|pane，

 # tmux-autopilot Skill

-让 AI 像熟练运维一样操作 tmux：读取终端输出、发送按键、批量巡检、协作/救援其他终端，默认兼容 `assets/repos/.tmux`（gpakosz/oh-my-tmux）。
+让 AI 像熟练运维一样操作 tmux：读取终端输出、发送按键、批量巡检、协作/救援其他终端，默认兼容 `assets/repos/.tmux`（gpakosz/oh-my-tmux），并在本技能内通过 `assets/oh-my-tmux` 与 `assets/tmux-src` 暴露上游 submodule。

 ## When to Use This Skill

@@ -15,6 +15,7 @@ description: "tmux 自动化操控：读取/广播/救援 session|window|pane，
 - 需要批量巡检/接管多 AI 终端（蜂群协作、自动救援卡死任务）。
 - 需要快速回忆 oh-my-tmux 快捷键、前缀或同步面板操作。
 - 需要在当前仓库复用 `assets/repos/.tmux` 配置并避免修改主配置。
+- 需要从技能目录内快速查看 oh-my-tmux 配置或 tmux 上游源码入口。

 ## Not For / Boundaries

@@ -85,8 +86,9 @@ tmux attach -t ai-hub

 **启用 oh-my-tmux 配置（仓库内版本）**
 ```bash
-ln -sfn /home/lenovo/zip/vibe-coding-cn/assets/repos/.tmux/.tmux.conf ~/.tmux.conf
-cp -n /home/lenovo/zip/vibe-coding-cn/assets/repos/.tmux/.tmux.conf.local ~/.tmux.conf.local
+repo_root="$(git rev-parse --show-toplevel)"
+ln -sfn "$repo_root/assets/skills/tmux-autopilot/assets/oh-my-tmux/.tmux.conf" ~/.tmux.conf
+cp -n "$repo_root/assets/skills/tmux-autopilot/assets/oh-my-tmux/.tmux.conf.local" ~/.tmux.conf.local
 ```

 **记录 pane 输出到文件**
@@ -153,11 +155,13 @@ tmux pipe-pane -t <session>:<window>.<pane> -o 'cat >> /tmp/tmux-<session>-<wind
 - `references/api.md`: tmux/oh-my-tmux 常用命令、选项与 gpakosz 特色键位
 - `references/examples.md`: 蜂群协议脚本与长示例
 - `references/troubleshooting.md`: 典型故障到修复路径
+- `assets/oh-my-tmux`: gpakosz/oh-my-tmux submodule 的相对软链接入口
+- `assets/tmux-src`: tmux/tmux submodule 的相对软链接入口

 ## Maintenance

- Sources: `assets/repos/.tmux/README.md`、蜂群实战提示词、Skill Seeker 生成的抓取材料（如需扩展自动化）。
- Last updated: 2026-01-17
+- Sources: `assets/skills/tmux-autopilot/assets/oh-my-tmux`、`assets/skills/tmux-autopilot/assets/tmux-src`、蜂群实战提示词、Skill Seeker 生成的抓取材料（如需扩展自动化）。
+- Last updated: 2026-04-28
 - Known limits: 未涵盖 tmux 插件管理（tpm）及多用户共享权限配置；需时再补充。

 ## Quality Gate
@@ -0,0 +1 @@
+../../../repos/.tmux
@@ -0,0 +1 @@
+../../../repos/tmux
@@ -20,8 +20,9 @@
 tmux -V

 # 2) 软链配置（不会覆盖已有 .tmux.conf.local，如需自定义请编辑该文件）
-ln -sfn /home/lenovo/zip/vibe-coding-cn/assets/repos/.tmux/.tmux.conf ~/.tmux.conf
-cp -n  /home/lenovo/zip/vibe-coding-cn/assets/repos/.tmux/.tmux.conf.local ~/.tmux.conf.local
+repo_root="$(git rev-parse --show-toplevel)"
+ln -sfn "$repo_root/assets/skills/tmux-autopilot/assets/oh-my-tmux/.tmux.conf" ~/.tmux.conf
+cp -n "$repo_root/assets/skills/tmux-autopilot/assets/oh-my-tmux/.tmux.conf.local" ~/.tmux.conf.local

 # 3) 启动会话并验证前缀
 tmux new -s demo -n shell
@@ -10,5 +10,6 @@
 ## Notes

 - 长文档、脚本细节放这里，`SKILL.md` 只保留可立即执行的片段。
- 配置来源：仓库内 `assets/repos/.tmux`（gpakosz/oh-my-tmux）。
+- 配置来源：技能内 `../assets/oh-my-tmux`，实际指向仓库 submodule `assets/repos/.tmux`（gpakosz/oh-my-tmux）。
+- 源码来源：技能内 `../assets/tmux-src`，实际指向仓库 submodule `assets/repos/tmux`。
 - 大规模文档抓取/刷新可用 `assets/repos/Skill_Seekers-development`，示例见 `examples.md`。