메뉴
openvela 固件编译、配置和模拟器运行。Use when: 编译 openvela、build、make、构建、menuconfig、运行模拟器、emulator、编译报错修复。
Codex 또는 Claude로 설치 이 Prompt를 복사해 Codex, Claude 또는 다른 어시스턴트에 붙여 넣으면 Skill 페이지를 검토하고 설치를 진행할 수 있습니다.
SOC 직업 분류 기준
Checks API documentation coverage and sync status against source header files. Use when adding new APIs, modifying header files, or auditing documentation completeness for openvela modules (kernel, bluetooth, media, telephony, etc).
NuttX/Vela 驱动代码质量审查（59 Pattern + 双轮交叉验证 + 量化评分）。 Use when: driver review, driver code review, 驱动审查, 驱动代码审查, review driver, 审查驱动代码, NuttX driver review, 驱动质量检查, review nuttx/drivers, review arch/ driver, 驱动提交前检查. 即使用户只说"帮我审查下这个驱动"也应触发。 驱动开发/实现(use nuttx-driver-development).
Create, update, review, or audit NuttX RTOS C device drivers. Covers sensor (uORB), char device, network (ethernet, MAC, PHY, DMA, netdev, SPI-Ethernet, CAN, SocketCAN, CAN FD, CAN bus, LIN, LIN bus, LIN master, LIN slave), framebuffer (fb, LCDC, display controller), LCD (SPI LCD, I2C LCD, ST7789, SSD1306, ILI9341, lcd_dev, lcd_framebuffer), USB (Host Controller Driver and device Controller Driver), audio (I2S smart PA, power amplifier, audio_comp), power/battery (charger, monitor, gauge), MCAL (AUTOSAR MCAL adaptation, EB Tresos, MCAL upper-half bridging), I2C/SPI bus, Kconfig/build integration, and board registration. Use for driver implementation, code audit, sensor/timer/LED/ethernet/CAN/LIN/fb/LCD/audio/PA/battery subsystems, or board bringup.
向 openvela 社区提交 Pull Request。通过 Fork 模式提交（先 fork 上游仓库，push 到 fork，再从 fork 向上游提 PR）。支持单仓库或多仓库批量提交、指定文件/分支、自动检测 GitHub/Gitee 平台、分支模糊匹配、MCP 配置引导。Trigger: 提交 PR、提交代码到社区、push 到 openvela、创建 pull request、批量提交、多仓库提交。
openvela 技术书籍稿件审校 Agent。以资深技术书籍编辑和 NuttX 架构专家的视角，对飞书云文档中的书稿内容进行逐字逐句审查。 涵盖出版社写作规范（22 条）、技术准确性、编辑审校三个维度。 使用方式：提供飞书文档 URL 或 doc_id，Agent 将读取文档内容并输出审校报告和修改建议。 当用户提到以下关键词时触发：审校、审稿、书稿审查、稿件评审、review 书稿、检查文档规范、技术书审校、出版规范检查、书籍审校、manuscript review。
openvela 项目技术文档审校与优化。对 docs/ 目录下的 Markdown 文档进行结构化优化、术语规范、安全合规检查和技术准确性审校。 使用方式：提供一个 Markdown 文件路径，输出审校报告和优化后的完整文档。 当用户提到以下关键词时触发：文档审校、文档优化、docs 审查、Markdown 优化、技术文档规范、文档结构优化、review docs、文档润色。
| name | openvela-build |
| description | openvela 固件编译、配置和模拟器运行。Use when: 编译 openvela、build、make、构建、menuconfig、运行模拟器、emulator、编译报错修复。 |
编译 openvela 固件、修改内核配置、运行模拟器。
默认编译目标为 goldfish-arm64-v8a-ap（64 位 ARM 模拟器）：
CONFIG_PATH=vendor/openvela/boards/vela/configs/goldfish-arm64-v8a-ap/
OUTPUT_DIR=cmake_out/vela_goldfish-arm64-v8a-ap/
如果用户指定了其他板级配置路径，替换上述路径即可。
./build.sh <CONFIG_PATH> --cmake -j$(nproc)
示例：
./build.sh vendor/openvela/boards/vela/configs/goldfish-arm64-v8a-ap/ --cmake -j$(nproc)
成功标志: 输出 #### build completed successfully
编译产物: <OUTPUT_DIR>/nuttx（ELF）、<OUTPUT_DIR>/vela_ap.bin
./build.sh <CONFIG_PATH> --cmake menuconfig
menuconfig 是交互式 TUI 界面，不能在 AI 终端中直接运行。提示用户在自己的终端中执行。
修改配置后保存会自动更新 .config。如需持久化到 defconfig：
./build.sh <CONFIG_PATH> --cmake savedefconfig
./emulator.sh <OUTPUT_DIR>
示例：
./emulator.sh cmake_out/vela_goldfish-arm64-v8a-ap/
成功标志: 出现 goldfish-armv8a-ap> NSH 提示符
rm -rf <OUTPUT_DIR>
全量清理后重新编译：
rm -rf cmake_out/vela_goldfish-arm64-v8a-ap/ && ./build.sh vendor/openvela/boards/vela/configs/goldfish-arm64-v8a-ap/ --cmake -j$(nproc)
./build.sh <path> --cmake -j$(nproc)build completed successfully| 错误类型 | 特征 | 处理 |
|---|---|---|
| 代码错误 | error: + 本驱动文件名 | 自动修复代码，重新编译 |
| 配置缺失 | undefined reference + CONFIG 相关 | 提示用户 menuconfig 开启 |
| 工具链问题 | command not found | 提示用户安装工具链 |
| 缓存问题 | 奇怪的链接错误 | rm -rf <OUTPUT_DIR> 后重编 |
如果需要临时启用某个 CONFIG 进行编译验证：
# 方法 1: 直接追加到 defconfig（推荐）
echo "CONFIG_SENSORS_BME680=y" >> <CONFIG_PATH>/defconfig
# 方法 2: 用 sed 修改 .config（临时，不持久化）
sed -i 's/# CONFIG_SENSORS_BME680 is not set/CONFIG_SENSORS_BME680=y/' <OUTPUT_DIR>/.config
修改后重新编译即可。
| 目标 | 配置路径 |
|---|---|
| goldfish-arm64 (推荐) | vendor/openvela/boards/vela/configs/goldfish-arm64-v8a-ap/ |
| goldfish-arm32 | vendor/openvela/boards/vela/configs/goldfish-armeabi-v7a-ap/ |
| 自定义板级 | vendor/<vendor>/boards/<chip>/<board>/configs/<config>/ |