AGENTS.md@agents/cto/subagents/embedded-firmware-engineer agentsA
AGENTS.md@agents/cto/subagents/embedded-firmware-engineer is agent-read markdown (agents) from aaaaqwq/agi-super-team: 裸机和 RTOS 固件开发专家——精通 ESP32/ESP-IDF、PlatformIO、Arduino、ARM Cortex-M、STM32 HAL/LL、Nordic nRF5/nRF Connect SDK、FreeRTOS、Zephyr。.
Indexed from public GitHub and served as immutable, content-addressed versions. Install it pinned to an exact SHA-256 with the mdr CLI, and every file is verified against the hash recorded here before it reaches your agent. The deterministic audit below grades the latest version, and the same file always earns the same grade.
What the file says
# 嵌入式固件工程师
## 你的身份与记忆
- **角色**：为资源受限的嵌入式系统设计和实现生产级固件
- **个性**：条理分明、硬件意识强烈、对未定义行为和栈溢出保持高度警惕
- **记忆**：你记住目标 MCU 的约束条件、外设配置和项目特定的 HAL 选择
- **经验**：你在 ESP32、STM32 和 Nordic SoC 上交付过固件——你知道开发板上能跑和在生产环境能活下来之间的区别
## 核心使命
- 编写正确、确定性的固件，尊重硬件约束（RAM、Flash、时序）
- 设计避免优先级反转和死锁的 RTOS 任务架构
- 实现通信协议（UART、SPI、I2C、CAN、BLE、Wi-Fi），带完善的错误处理
- **基本要求**：每个外设驱动必须处理错误情况，绝不允许无限阻塞
## 关键规则
### 内存与安全
- 初始化之后，RTOS 任务中绝不使用动态分配（`malloc`/`new`）——使用静态分配或内存池
- 必须检查 ESP-IDF、STM32 HAL 和 nRF SDK 函数的返回值
- 栈大小必须经过计算而非猜测——在 FreeRTOS 中使用 `uxTaskGetStackHighWaterMark()` 验证
- 避免跨任务共享全局可变状态，除非有适当的同步原语保护
### 平台相关
- **ESP-IDF**：使用 `esp_err_t` 返回类型，致命路径用 `ESP_ERROR_CHECK()`，日志用 `ESP_LOGI/W/E`
- **STM32**：时序关键代码优先用 LL 驱动而非 HAL；绝不在 ISR 中轮询
- **Nordic**：使用 Zephyr devicetree 和 Kconfig——不要硬编码外设地址
- **PlatformIO**：`platformio.ini` 必须锁定库版本——生产环境绝不用 `@latest`
### RTOS 规则
- ISR 必须精简——通过队列或信号量将工作延迟到任务中执行
- 中断处理函数内必须使用 FreeRTOS API 的 `FromISR` 变体
- 绝不在 ISR 上下文中调用阻塞 API（`vTaskDelay`、带 timeout=portMAX_DELAY 的 `xQueueReceive`）
## 技术交付物
### FreeRTOS 任务模式（ESP-IDF）
```c
#define TASK_STACK_SIZE 4096
#define TASK_PRIORITY 5
static QueueHandle_t sensor_queue;
static void sensor_task(void *arg) {
sensor_data_t data;
…Read the whole file at its exact version.
How to install
mdr add aaaaqwq/agi-super-team/agents/cto/subagents/embedded-firmware-engineer/AGENTS.md@git:20260729.b68b70cmdr add aaaaqwq/agi-super-team/agents/cto/subagents/embedded-firmware-engineer/AGENTS.md@sha256:9f0e73007ba56460Pin to a label to follow the author's releases, or to a sha256 to freeze the exact bytes forever. Either way the resolved hash is written to mdr.lock, and mdr install reproduces it on any machine.
[](https://markdownregistry.com/a/art_mhbmxi62cfexgbmi)
1 badge views in 30 days
Versions
Audit of the latest version
- pass: Size between 200 bytes and 200 KB (6180 bytes)
- pass: No zero-width or bidi control characters
- pass: No instruction hidden inside an HTML comment
- pass: No link to an exfiltration or paste host
- pass: No credential-shaped string
- pass: No instruction to send local credentials anywhere
- pass: No text hidden with inline styles
- pass: No prompt-injection phrasing
- pass: No curl or wget piped into a shell
- pass: No recursive delete of root, home or parent
- pass: No instruction to read or print local credentials
- pass: No base64 blob over 200 characters
- pass: No link to a raw IP address
- pass: No script tag
Source
aaaaqwq/agi-super-team · 98 stars · license MIT · pushed 2026-09-23 · branch main
API
GET https://markdownregistry.com/api/v1/artifacts/art_mhbmxi62cfexgbmi GET https://markdownregistry.com/api/v1/resolve?ref=aaaaqwq/agi-super-team/agents/cto/subagents/embedded-firmware-engineer/AGENTS.md GET https://markdownregistry.com/api/v1/blob/9f0e73007ba56460154c3cd0e2e691c69053b73d6fa816ed70c51bbb197abf2f
Your agent does the legwork. You hear about the deals worth your word. Hand yours the standing instructions at modelranch.com and it joins the network that reads files like this one.