Aitishiku.com📌Skill基础信息
Skill名称：rosbag-workflow
简称：rosbag工作流
来源：社区第三方（sige0002）
运行宿主：Claude-Code CLI（基于 Claude AI 的代码助手工具）
核心定位：为ROS 2开发提供rosbag/mcap文件的录制、回放、循环测试标准化流程，以及DDS/QoS通信问题的诊断排错方案，特别适用于机器人软件开发中的数据传输验证场景。
🧩内部核心组成
该Skill主要包含ROS 2 rosbag操作的最佳实践指南和故障排除流程：
核心能力组件：
- rosbag循环回放测试工作流
- 录制数据丢失问题诊断方案
- DDS/QoS通信故障排查步骤
- 文件格式转换建议（mcap标准化）
关键操作命令：
| 命令/操作 | 功能简述 |
|---|---|
ros2 bag info | 查看bag文件内容信息 |
ros2 bag play --loop | 循环回放bag文件用于测试 |
ros2 topic list | 查看可用topic列表 |
ros2 topic hz | 监控topic发布频率 |
ros2 topic info -v | 查看topic详细QoS配置 |
🛠安装与启用方式
安装命令：
skills install --user sige0002/kairos前置依赖：
- ROS 2环境（Humble或更新版本）
- rosbag2相关工具包
- mcap文件支持库
启用方式：安装后Skill将集成到Claude-Code CLI中，通过自然语言指令触发相关工作流。
📋标准工作流
- 用户输入指令：如"设置rosbag循环测试"或"诊断DDS通信问题"
- Skill解析需求：识别用户要执行的rosbag操作类型
- 生成具体命令：根据最佳实践输出相应的ROS 2命令序列
- 提供操作指导：包括注意事项和常见问题解决方案
- 执行验证：用户按指导执行命令并验证结果
典型使用链路：需求识别 → 命令生成 → 环境配置 → 执行测试 → 结果验证
⚠️关键限制、缺陷、注意事项
平台限制：
- 仅支持ROS 2环境（不支持ROS 1）
- 依赖Linux操作系统
- 需要特定的DDS实现（推荐CycloneDDS）
资源消耗：
- 大容量bag文件回放需要足够内存
- 网络带宽可能成为瓶颈（特别是图像数据）
- 实时性要求高的场景可能有性能限制
适用项目：
- 机器人软件开发和测试
- 传感器数据处理验证
- 通信可靠性测试
不适用场景：
- 非ROS环境的项目
- 实时性要求极高的控制应用
- 生产环境部署（仅限开发测试）
已知坑点：
- 录制开始阶段数据可能丢失
- 不同DDS实现混用会导致通信问题
- QoS配置不匹配造成数据无法接收
✅适用场景 & ❌不适合场景
✅适用场景：
- ROS 2机器人软件开发团队
- 需要进行传感器数据回放测试的项目
- DDS/QoS通信问题诊断和排查
- 开发阶段的集成测试和验证
- 教育研究和算法开发中的数据处理
❌不适合场景：
- 生产环境实时数据处理的场合
- 非ROS技术栈的项目开发
- Windows或macOS环境下的开发
- 对实时性要求极高的控制应用
- 大规模分布式系统中的数据管理
如何安装
skills install --user sige0002/kairos通用安装教程：在哪里输入上面的命令
上面的命令本质是在「终端 / 命令行」中调用技能管理器，把该 Skill 下载并注册到你的 AI 工具。各主流工具打开终端的位置不同，按下面操作即可：
- 打开工具自带的终端面板，或系统终端（macOS「终端」、Windows「PowerShell」、Linux「Terminal」）。
- 把上面的安装命令复制进去，回车运行，等待下载与注册完成。
- 重启或重新加载 AI 工具，让新安装的 Skill 被识别。
- 新建对话并触发：直接描述用途，或通过该工具的技能 / 斜杠菜单选中此 Skill。
Claude 桌面版（macOS / Windows）
桌面版没有内置命令行，Skill 需通过 Claude Code CLI 安装。打开系统终端，先执行 npm install -g @anthropic-ai/claude-code，再运行上面的安装命令；完成后完全退出并重新打开 Claude。
Claude Code（终端 CLI）
直接在项目目录的终端里运行上面的命令即可。也可先输入 claude 启动交互界面，再在对话中引用该 Skill（/ 斜杠菜单或直接描述用途）。
VS Code（含 GitHub Copilot）
打开终端面板：菜单「终端 → 新建终端」，或快捷键 Ctrl+`（macOS 为 ⌃+`）。在终端里运行上面的命令；装完后执行「重新加载窗口」（Ctrl+Shift+P → Reload Window），让 Copilot 等扩展识别新技能。
Cursor
底部「终端」面板（Ctrl+`）即是内置终端。粘贴运行上面的命令，完成后在命令面板执行「Reload Window」刷新，再开始对话。
Windsurf
底部「终端」面板运行命令；也可直接使用其内置 Agent 终端，在对话侧执行安装。
其他工具（ChatGPT、本地脚本等）
不支持本地终端的产品，可先在本机终端完成安装，再在对话中描述该 Skill 的能力让其调用；不同工具的命令格式请以其官方文档为准。
风险提示
自动扫描未发现高危命令、隐私抓取或数据外传行为。仍建议安装前快速浏览仓库代码。