如果你拆开一台 OAK 相机，第一反应就是让你的编程 Agent 去驱动它——那么这次发布就是为你准备的，你一定会喜欢。

今天，我们正式发布属于OAK的agent skills：一组专注的技能集合，教 Claude Code、Codex、Cursor 等编程 Agent 如何像我们一样操作 OAK 相机和 DepthAI。它们能带你从一台还在包装盒里的相机，到一台验证可用的设备，再到一个可运行的概念验证——比你想象的更快。我们相信，这将从根本上改变用户在 OAK 平台上构建的方式，我们迫不及待想把它交到你手上。这是一个 Beta 版本，但我们已经迫不及待与大家分享它，决定提前发布——详情见文末。

为什么我们要做这个

机器人、自动化、检测和空间 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】