Ultralytics YOLO27：
Get Started

Ultralytics 智能体技能#

Ultralytics 智能体技能为兼容的 AI 编码智能体提供使用 ultralytics Python 包、yolo CLI 和 Ultralytics Platform 的说明与参考资料，其中包括使用 ul cloud 进行自动化。它们遵循开放的 Agent Skills 格式，并会在请求相关任务时加载。

技能的工作原理#

yolo 路由技能会根据请求涉及的生命周期阶段进行路由，而每个阶段技能都涵盖两种路径：先介绍在 Ultralytics Platform 中最快捷的操作方式，再介绍本地 Python 和 CLI 工作流。权重名称、训练参数和导出格式等与版本相关的信息都收录在目录中，并根据固定的 ultralytics 版本进行核实；每项技能都会告诉智能体，在这些信息与已安装的软件包（yolo checks、yolo cfg 和错误消息）不一致时，应以已安装的软件包为准。platform-cli 技能则以已安装的 ul CLI 帮助信息和实时的 Platform API 为准。Platform 自带的 Ask AI 也使用同一个 platform-cli 技能。

可用技能#

此代码库包含一个路由技能、六个生命周期技能和一个 Platform CLI 技能：

技能适用场景
yoloPython 和 CLI 基础用法、Platform 工作流，以及路由到其他技能
yolo-models选择模型系列、尺寸、任务和权重
yolo-datasets准备、转换、验证和排查数据集问题
yolo-training训练、验证、恢复训练、多 GPU 使用和故障排查
yolo-tuning超参数调优和实验改进
yolo-inference预测、结果、跟踪和 Solutions
yolo-export导出、量化、部署格式和基准测试
platform-cli使用 ul cloud 自动化 Ultralytics Platform：资源、上传、云端训练、导出和部署

安装#

claude plugin marketplace add ultralytics/skills
claude plugin install yolo@ultralytics

如需更新，请运行 claude plugin update yolo@ultralytics，然后重启 Claude Code。

插件的每个版本都会作为 GitHub 版本发布，并附带版本说明。

连接 Platform CLI#

platform-cli 技能使用 ul CLI（Python 3.11+），该 CLI 包含在 pip install ultralytics 中，也可通过独立 SDK（pip install ultralytics-platform）获取。创建一个 Platform API 密钥，让智能体可以使用该密钥，然后检查连接：

export ULTRALYTICS_API_KEY="YOUR_API_KEY" # or: ul login YOUR_API_KEY
ul cloud account summary

示例提示词#

安装后，直接用自然语言向智能体提问。yolo 路由技能会选择相关指南：

目标提示词示例
试试 YOLO“在示例图像上运行 YOLO，并告诉我它检测到了什么。”
训练“把我的图像制作成自定义 YOLO 模型，并在 Ultralytics Platform 中完成标注和训练。”
改进“我的模型 mAP 停滞不前了。请诊断这次运行，并提出下一步实验方案。”
部署“将我训练好的 YOLO 模型导出为 TensorRT 格式，使用 INT8 量化并对其进行基准测试。”
分析视频“统计 traffic.mp4 中穿过一条线的汽车数量，并保存标注后的视频。”
自动化 Platform“列出我在 Ultralytics Platform 中的数据集，并在 PPE 数据集上开始云端训练。”

查看 ultralytics/skills 代码库，了解当前安装命令、源文件、更新和问题报告方式。

常见问题#

  • 它们是可重复使用的说明和参考资料，可帮助 AI 编码智能体使用 Ultralytics Platform、ultralytics Python 包、yolo CLI 和 ul Platform CLI。

  • 此代码库提供适用于 Claude Code 和 Codex 的插件。Cursor、Gemini CLI 以及其他能够读取开放 Agent Skills 格式的智能体，可以直接安装技能文件夹，也可以通过 skills CLI 安装。

  • 安装完整插件，即可在计算机视觉生命周期和 Platform CLI 操作中自动路由。要使用 skills CLI 安装单项技能，请通过 --skill 传入技能名称，例如 --skill yolo-training 或 --skill platform-cli。

  • 插件本身只包含说明，因此加载时不会运行任何内容。智能体通过技能运行的命令可能会下载软件包、权重和数据集，而 ul cloud 命令会使用你的 API 密钥，将你传入的文件上传到 Ultralytics Platform。ultralytics 软件包还会发送匿名使用情况分析数据，yolo settings sync=False 会关闭此功能。

  • 不会。这些技能会引导智能体找到相关工作流，但如果行为或支持的选项有所不同，应以已安装的软件包和最新的 Ultralytics 文档为准。

  • 在 ultralytics/skills 仓库中提交 错误报告，并附上你使用的提示词、智能体给出的指南，以及实际应当发生的情况。

贡献者
JAJaviChulvi2GLglenn-jocher1PDpderrenger1

评论