DOCA Firefly 时间同步运维技能
帮助在 BlueField 上部署、配置和排查 DOCA Firefly 的 PTP 时间同步服务。
文档明确限制 BlueField Arm、容器、接口和配套工作负载范围，要求先判断 PTP 是否必要，强调端到端时钟链路、单容器原则和 smoke-before-scale，也未见恶意行为、凭据窃取或隐蔽外传。扣分原因是涉及 PHC、主机时钟、容器和网络配置等外部影响，却没有明确的用户确认门槛、权限最小化清单、完整回滚方案；许可证与来源元数据也存在 Apache-2.0、Apache-2.0 AND CC-BY-4.0 及 NOASSERTION 的不一致。
SKILL.md、CAPABILITIES.md 和 TASKS.md 之间总体形成了配置、运行、测试和分层调试流程，并提供异常症状到责任层的映射。扣分原因是仅静态审阅，未执行关键路径；没有随附可执行部署配置或完整测试套件，部分命令和配置依赖外部文档，且存在“六个子系统”后称“所有五个子系统”的内部矛盾，末尾任务文件证据还不完整。
触发条件、典型隐式问题、目标受众和明确的非适用范围都写得较清楚，并区分 Firefly、主机 follower、消费者工作负载及其他 DOCA 技能。扣分原因是没有中文使用指导或本地化触发示例；核心部署依赖 NVIDIA NGC 和公共在线文档，未证明中国大陆网络可达性；对具体版本、运行时和网络拓扑的环境边界仍需用户补充。
文档采用 SKILL.md 加 CAPABILITIES.md、TASKS.md、基准报告和技能卡的分层结构，包含版本兼容、相关技能、限制、维护入口和评估信息。扣分原因是推荐的 Instructions/Examples 章节缺失，基准报告列出的 schema 问题未显示已修复；版本仍有 TBD 签名字段，仓库路径、许可证和来源声明不一致，也没有清晰的变更日志或稳定维护承诺。
该技能对判断是否需要 Firefly、选择 PTP 轴、识别主机时钟未跟随以及按层调试具有直接流程价值，输出可指导后续操作。扣分原因是它刻意不提供镜像标签、配置文件、完整命令和主机 follower 配置，必须查阅外部指南并结合其他技能；因此静态证据不足以证明用户任务可直接完成，仍可能需要较多人工补全。
文件提供了公共 DOCA Firefly Service Guide 指针、符号和命令类别，并附有内部 benchmark 报告。扣分原因是公共来源 URL 未直接给出，benchmark 数据集不可用且无法在本次静态审阅中复现；没有可检查的 CI、提交测试套件或独立第三方交叉验证，因此只能给有限证据分。
- 不要把内部 benchmark 的 PASS 或 NVIDIA 身份当作本技能可靠性、安全性或效果的替代证据。
- 实际部署前必须核对与容器版本匹配的官方 Firefly 指南、镜像标签、配置 schema、权限和主机 follower；文档中存在子系统数量及许可证/来源元数据不一致。
- 任何会改变 PHC、主机时钟、PTP 接口或网络路径的操作都应先获得用户确认，并准备可验证的恢复步骤。
这个 Skill 能做什么，适合哪些场景？
该技能面向在 BlueField Arm 上运行 DOCA Firefly Service 容器的外部运维人员和平台团队。它指导用户选择 PTP 角色、配置文件、域和网络接口，并协调 BlueField PHC、主机时间跟随器与消费者工作负载。它也覆盖 PTP、PTP Monitor、容器内 PHC2SYS、PPS、SyncE 和 Firefly Servo 等子系统的操作与排障。若 NTP 或 chrony 已满足精度要求，或网络路径不支持 PTP，则不建议采用 Firefly。
指导用户从 NVIDIA 技能集合安装该技能；判断是否需要 PTP 级时间；配置并运行 BlueField Arm 上的 Firefly 容器；检查配置文件、环境变量、容器日志、PHC 偏移和端口状态；排查角色、配置文件、域、接口、主机跟随器、PTP 网络路径及容器运行时问题；说明 Firefly 与 Rivermax SMPTE 工作负载的配合方式。
- BlueField 平台团队需要为 Rivermax SMPTE ST 2110 工作负载提供 PTP 级时间。
- 运维人员发现 Firefly 容器正常运行，但 PTP 状态停留在 LISTENING。
- Firefly 显示已同步，但主机时钟仍然漂移。
- PTP 已获得同步，但偏移或抖动达到数十微秒。
- 团队正在判断现有 chrony/NTP 是否足以满足分布式系统、5G UPF 或金融工作负载的时间精度要求。
这个 Skill 有哪些优点和局限？
- 覆盖 Firefly 六个 PTP 栈子系统，而不把它简化为单一 PTP 守护进程。
- 明确区分 Firefly、BlueField PHC、主机时间跟随器和消费者工作负载。
- 提供按角色、配置文件、域和接口组织的部署与排障边界。
- 明确说明在 chrony/NTP 足够或网络不支持 PTP 时应绕开 Firefly。
- 依赖已安装的 DOCA、BlueField Arm、容器运行时和 PTP 感知网络路径。
- 不提供可直接用于生产的 Firefly 配置文件、镜像标签或主机侧时间同步配置正文。
- 不能替代 DOCA 安装、PTP 拓扑设计、主机 chrony/ptp4l 配置或应用开发技能。
如何安装这个 Skill？
使用 NVIDIA 技能集合的 CLI 安装：npx skills add nvidia/skills --skill doca-firefly --yes。源材料没有提供单独复制该技能目录的必要步骤。
如何使用这个 Skill？
将该技能加载到兼容 Agent Skills 的客户端中，并提出具体运维问题，例如：“Firefly 显示已同步，但主机时钟仍然漂移，如何检查？”部署前应确认 DOCA 已安装在 BlueField Arm 上，并准备 Firefly 配置文件、PTP 主站或主站角色、PTP 感知网络路径及主机侧时间跟随器。具体容器镜像标签、完整配置块和主机 chrony/ptp4l/phc2sys 配置正文未在源材料中提供。
这个 Skill 与同类方案有什么区别？
该技能将 Firefly 与主机上的 NTP/chrony 进行路径选择比较：若 NTP/chrony 已满足工作负载的时间精度预算，应继续使用现有配置；若需要 PTP 级精度，则考虑 Firefly。