以Agent 的速度在 OAK 基础上进行构建：OAK 智能体 Skills 简介
如果你拆开一台 OAK 相机，第一反应就是让你的编程 Agent 去驱动它——那么这次发布就是为你准备的，你一定会喜欢。
今天，我们正式发布属于OAK的agent skills：一组专注的技能集合，教 Claude Code、Codex、Cursor 等编程 Agent 如何像我们一样操作 OAK 相机和 DepthAI。它们能带你从一台还在包装盒里的相机，到一台验证可用的设备，再到一个可运行的概念验证——比你想象的更快。我们相信，这将从根本上改变用户在 OAK 平台上构建的方式，我们迫不及待想把它交到你手上。这是一个 Beta 版本，但我们已经迫不及待与大家分享它，决定提前发布——详情见文末。
30分钟完成概念验证：OAK 智能体 Skills 演示_哔哩哔哩_bilibili
为什么我们要做这个
机器人、自动化、检测和空间 AI 领域的工程师们，越来越多地在编程 Agent 中完成日常工作。但一个通用 Agent 并不了解我们的平台，它会猜测 API、混淆 DepthAI 版本，浪费你的时间和 Token 去重新摸索我们早已烂熟于心的东西。Agent Skills 改变了这一切。每个 Skill 都为你的 Agent 准备好针对特定任务的正确方法、上下文和护栏，让它表现得像一个在 OAK 上构建过上百次的老手。你插上相机的那一刻，平台的全部能力就已就绪——通过你已经在用的 Agent。
五大技能
五个 Skill 遵循一条简单的路径：让相机跑起来 → 把你的想法整理成简要文档 → 构建 Demo。排障 Skill 随时待命，需要时即可调用。
OAK-guide 是导航入口。不确定从哪里开始？运行它，它会为你指向正确的 Skill。
OAK-device-setup 将一台相机带到经过验证的可用状态。每台设备的设置都略有不同，而网络配置是差异最大的环节：USB、PoE、以太网、交换机、VPN 以及链路本地寻址——每一种都可能改变设备连接的路径。这个 Skill 让你的 Agent 能够综合运用我们的工具和你具体的网络环境，找到通往可用相机的最佳路径，然后保存一份 DEVICE.md，确保后续会话从已知良好的状态开始。
OAK-project-interview 将你的想法转化为可执行的简要文档。与任何 Agent 协作时，最困难的部分莫过于把你脑海中的想法变成它能够执行的形式。这个 Skill 做的就是这件事：用通俗的语言一次一个问题地与你访谈，然后写出一份 PROJECT_BRIEF.md，成为后续每一步、以及未来每一次会话都可以依赖的共享上下文。
OAK-build-poc 以那份简要文档为基础，搭建一个最精简的可运行 Demo，在真实设备上验证核心想法。它不会凭记忆凭空发明 Pipeline，而是适配最接近的、经过验证的 OAK 示例，确认目标为 DepthAI v3，并用一个可重复运行的命令来验证结果。即使是在这里构建平台的资深工程师，看到一台 OAK Demo 在几分钟内从零到跑通时，也会感到震撼。
OAK-troubleshoot 是”出问题了”的入口——Pipeline 崩溃、深度图质量差、帧率低，或者设备根本不显示。它复现问题、隔离设备端与应用端、将你的应用与已知良好的示例做 Diff、一次只改一个变量直到症状消失。如果无法在本地修复，它会为我们的团队生成一份清晰的 SUPPORT_PACKET.md。
如何保持准确：
让 Agent 在 OAK 上表现出色的关键是上下文，所以这些 Skill 会为它提供真实、最新的来源，而不是依赖记忆。当某个 Skill 需要真实代码来构建或对比时，它使用我们精心维护的 oak-examples 仓库——只需克隆一次到共享文件夹 ~/.OAK/agent-context/，即可跨项目复用。而对于任何 OAK 相关的具体信息，Skill 会从我们的文档地图 docs.OAK.com/llms.txt 出发，沿着其 Markdown 页面查找，而不是凭空猜测。这个 llms.txt 地图的价值远超这些 Skill 本身：将任何 LLM 或 Agent 直接指向它，你就会得到关于我们平台好得多的回答。我们强烈推荐。
这意味着什么
OAK-build-poc 的存在是为了帮你快速验证一个用例，在一个下午内回答”OAK 能不能做这个、大概怎么做”。它构建的是证明想法的最精简 Demo，而不是生产系统，而 OAK-troubleshoot 可以在此过程中帮你调优性能。目标就是让快速迭代的研发团队在几小时内验证项目，然后决定往哪里投入资源。
我们希望这能开启构建感知和机器人系统的全新方式，大幅降低准入门槛，缩短从零到价值实现的时间。我们相信，有了这样的工具，硬件团队可以开始像软件团队一样快速推进。这只是第一步，我们还有很多正在研发中的内容，我们也非常期待你的反馈。
💡 关于与 OAK Chat 的关系：对于快速问答和简单查询，OAK Chat 仍然是合适的工具。但对于 Agent 实际构建、连接或调试的场景，这些 Skill 是一次重大升级。这和你已经在 Claude 与 Claude Code 之间做的划分完全一致：一个用来快速解答，另一个用来完成工作。
安装 Skill
无需搭建服务器，也没有复杂的安装流程。这些 Skill 刻意保持精简——让安装简单、Token 消耗低——并且兼容你偏好的任何工具。你带上你喜欢的 Agent，Skill 带来 OAK 的领域知识。
代码仓库：github.com/OAK/skills
Claude Code
在会话中运行以下命令：
/plugin marketplace add OAK/skills /plugin install OAK@OAK /reload-plugins
Cursor
从 Cursor Marketplace 安装，或通过 Settings → Rules → Add Rule → Remote Rule (Github) 手动添加：
OAK/skills
其他 Agent（Codex 等）
通过 skills CLI 安装：
npx skills@latest add OAK/skills
使用 Skill
每个 Skill 都只能手动调用，通过名称触发，绝不会自动执行：
/OAK-guide /OAK-device-setup /OAK-project-interview /OAK-build-poc /OAK-troubleshoot
注意：Claude Code 插件安装可能会为命令添加命名空间前缀，例如 /OAK:OAK-device-setup。
🚀 典型首次使用流程： ① /OAK-device-setup 验证相机可用 → ② /OAK-project-interview 将想法转化为简要文档 → ③ /OAK-build-poc 搭建 Demo → ④ 卡住了？用 /OAK-troubleshoot 排障。 对于硬件故障或 Skill 无法在本地解决的问题，请联系 oakchina.cn/contact-us/。
这是 Beta 版，请给予我们反馈
我们之所以提前发布，是因为让它变得更好的最快方式，就是观察真实工程师如何使用它。我们需要关于所有方面的反馈：安装和使用的便捷程度、构建成果的质量、消耗了多少 Token、在哪些环节卡住了、你希望它还具备哪些能力、以及哪些集成会更有帮助。
这是一项大工程的开端，我们相信它预示了 OAK 的发展方向。安装它，打开你的相机，构建点什么项目，然后告诉我们你的体验。我们迫不及待想看到你的作品。
请在下方评论区分享你的想法；
【End】