前言¶
在 ROS2 項目裏，本機裝一套能編、能跑、能開 rviz2 的環境，往往要處理發行版、依賴、DDS 與設備權限等多件事。把開發放進 Docker 或 docker-compose 能減輕「換機器就壞」的問題，但 Dockerfile、多容器組網、GPU/USB 透傳和 colcon 緩存又會讓 Agent 容易給出泛泛建議。
下面介紹 SkillHub 上的 DockerRos2Development（座標 @user_3c6cb52e/docker-ros2-development-4wa1）。它把 Docker 場景下的 ROS2 開發要點寫進通用 SKILL.md，裝到 Agent 的 skills 目錄後，對話時會按技能正文裏的場景與鏡像層次來組織回答，而不是每次從零拼湊。
這是什麼¶
DockerRos2Development 是社區來源（community）的 Agent Skill，版本 1.0.0，發佈者爲 user_3c6cb52e，在 SkillHub 分類爲 dev-programming（技能包元數據裏標註爲「開發者工具」）。公開簡介爲：DockerRos2Development 專用技能，幫助 AI Agent 高效完成相關任務。
技能聲明 requires_api_key=false，無需額外 API Key。許可證爲 MIT；元數據標明支持 Claude Code、Codex、Hermes Agent、OpenClaw、QClaw、WorkBuddy 等框架，平臺爲 multi-platform。倉庫與主頁字段均指向 https://github.com/1991513ccie-png。
截至 SkillHub 抓取數據：評分 100000，下載 1106 次（頁面統計字段，會隨時間變化）。
核心功能¶
技能正文標題爲「Docker-Based ROS2 Development Skill」。已覈實的能力邊界如下（均來自包內 SKILL.md）。
適用觸發場景¶
技能在「When to Use This Skill」中列出 Agent 應啓用本技能的情形，包括：
- 爲帶 colcon 構建的 ROS2 工作空間編寫 Dockerfile
- 爲多容器機器人系統配置 docker-compose
- 排查容器間 DDS 發現失敗（CycloneDDS、FastDDS）
- 用 NVIDIA Container Toolkit 配置感知節點的 GPU 透傳
- 爲 rviz2、rqt 轉發 X11 或 Wayland 顯示
- 管理相機、激光雷達、串口等 USB 設備透傳
- 搭建基於 Docker 的 ROS2 構建與測試 CI/CD
- 編寫帶 ROS2 擴展的 VS Code devcontainer
- 優化 colcon 工作空間的 Docker 層緩存
- 用多階段構建區分開發鏡像與部署鏡像
ROS2 官方鏡像層次¶
技能用示意圖說明 OSRF 鏡像的分層關係，並強調在依賴滿足的前提下選用更小基礎鏡像。層次從 ros:<distro>-ros-core（約 700 MB）向上疊加到 ros:<distro>-desktop-full（約 3.5 GB），中間包含 ros-base、perception、desktop 等標籤；正文附帶鏡像標籤、基礎系統、體量與用途的對照表（當前公開發布包中該表在文件末尾截斷，安裝後若表不完整，應以 OSRF 官方文檔爲準）。
安裝與啓用¶
官方 SkillHub 頁面要求按 SkillHub 安裝與優先源配置 安裝座標 @user_3c6cb52e/docker-ros2-development-4wa1。
1、安裝 SkillHub CLI（若尚未安裝）¶
先檢查是否已有 CLI：
command -v skillhub && skillhub --version
未安裝時可執行完整安裝（文檔推薦）：
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash
僅安裝 CLI：
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash -s -- --cli-only
2、安裝本技能到當前 Agent 的 skills 目錄¶
安裝時必須用 --dir 指向當前 Agent 實際讀取的 skills 目錄，否則默認落在 ./skills/ 可能不會被識別。文檔給出的常見路徑示例：
- Cursor：
~/.cursor/skills/ - Claude Code：
~/.claude/skills/ - Codex：
~/.codex/skills/或項目下的.agents/skills/
在 Cursor 下可執行：
skillhub install @user_3c6cb52e/docker-ros2-development-4wa1 --dir ~/.cursor/skills/
安裝成功後，技能會出現在類似 @user_3c6cb52e/docker-ros2-development-4wa1 的子目錄中，內含 SKILL.md。按所用客戶端說明啓用或刷新 skills 後，新會話即可加載。
典型用法¶
本技能沒有單獨的命令行工具；用法是讓已啓用技能的 Agent 在對話中處理 Docker + ROS2 任務，並遵循 SKILL.md 中的場景與鏡像選擇原則。
可復現的流程示例：
- 完成上一節的
skillhub install，確認~/.cursor/skills/（或你使用的路徑）下存在該技能目錄。 - 在 Cursor 中開啓新對話，用自然語言描述任務，並點名場景，例如：「按 DockerRos2Development 技能，爲 ROS2 Jazzy 工作空間寫多階段 Dockerfile，基礎鏡像用 ros-base，並說明 colcon 緩存層怎麼拆。」
- 若涉及多容器，可明確 DDS 與網絡：「兩個容器跑不同節點，FastDDS 發現失敗，請按技能裏的 DDS 調試思路排查 docker-compose 網絡與環境變量。」
Agent 應結合技能中的「When to Use」與鏡像層次圖選型，而不是隨意選用 desktop-full 等大鏡像。
適用場景與注意¶
適合誰： 已在用或計劃用 Docker / compose / devcontainer 做 ROS2 開發的工程師，並希望 Agent 在 Dockerfile、組網、DDS、GPU/顯示/USB、CI 等話題上對齊同一套檢查清單。
限制與注意：
- SkillHub 列表頁簡介較短，具體步驟以安裝後的
SKILL.md爲準；當前 1.0.0 包內正文在鏡像對照表處可能不完整，涉及鏡像大小與標籤時務必對照 OSRF Docker 鏡像 等官方來源。 - 技能元數據中的 GitHub 主頁爲發佈者賬號鏈接，不等同於 ROS2 或 Docker 官方文檔。
- 容器內跑實機設備、GPU 與圖形界面依賴宿主機驅動與權限，Agent 只能給出配置思路，仍需你在目標機器上驗證。
- 統計數字（下載量、評分）來自 SkillHub 頁面，僅作參考。
結尾¶
DockerRos2Development 把 Docker 化 ROS2 開發的高頻場景和 OSRF 鏡像分層寫進 Agent 可加載的 Skill，配合 SkillHub 一條安裝命令即可放進 Cursor 等環境的 skills 目錄。需要查看版本與座標時，可打開 SkillHub 頁面：
https://www.skillhub.cn/skills/user_3c6cb52e/docker-ros2-development-4wa1
API 條目（與頁面同源索引）：https://api.skillhub.cn/user_3c6cb52e/docker-ros2-development-4wa1
