用途:当用户希望复制、提取、引导或启动一个基于 oak-examples 的 OAK 项目时使用本技能。
主要能力:通过捆绑脚本 scripts/bootstrap_from_example.py 查找或浅克隆 oak-examples 仓库,打印本地 INDEX.md 路径,将选定示例复制到新项目目录,写入 AGENTS.md 与 CLAUDE.md,复制 ESSENTIAL_KNOWLEDGE.md,在示例未自带顶层许可证时沿用仓库根 LICENSE,把跨示例链接转换为 GitHub main URL,并改写 oakapp.toml 标识符。
使用方式:先明确目标应用的任务、所需硬件、host-script 还是 standalone 模式、UI、模型/推理、流式输出需求,以及要最小脚手架还是接近生产的应用。随后运行 python3 scripts/bootstrap_from_example.py --print-index 获取本地检出路径与 INDEX.md 路径,阅读索引并解析相对链接,查看候选示例的 AGENTS.md 后再选择。选定后运行 python3 scripts/bootstrap_from_example.py <example-path> ./<new-project-dir>;已有检出可用 --repo /path/to/oak-examples 指定。示例:python3 scripts/bootstrap_from_example.py custom-frontend/raw-stream ./raw-stream-app。
适用场景:检测、深度、流式、前端、ROS、C++、标定、测量或集成类 OAK 项目;涉及 RVC2/RVC4、立体、ToF、热成像、IMU、自动对焦或多设备需求时按清单匹配。
限制:输出目录必须不存在,绝不覆盖已有目录;引导过程中不要修改源示例;在检查依赖与硬件要求前,不得声称生成的项目可运行。若示例自带顶层许可证或第三方声明,应保留其条款而非默认 Apache-2.0。依赖、硬件兼容性、运行时验证与最终许可证审查仍需另行处理。