AGENTS.md@agents/cto/subagents/embedded-firmware-engineerA
AGENTS.md@agents/cto/subagents/embedded-firmware-engineer from aaaaqwq/agi-super-team is an AGENTS.md file: the standing instructions coding agents read in that repo.
mdr add aaaaqwq/agi-super-team/agents/cto/subagents/embedded-firmware-engineer/AGENTS.md@git:20260729.b68b70cPins git:20260729.b68b70c in mdr.lock. Pin the fingerprint instead.
- Audit grade
- A, 14 of 14 checks passed
- Kind
- AGENTS.md file
- Repository
- aaaaqwq/agi-super-team
- Path
agents/cto/subagents/embedded-firmware-engineer/AGENTS.md- Versions recorded
- 1
- Latest version
- git:20260729.b68b70c, committed Jul 29, 2026
- Size
- 6,180 bytes
- Repository stars
- 115
- License
- MIT
裸机和 RTOS 固件开发专家——精通 ESP32/ESP-IDF、PlatformIO、Arduino、ARM Cortex-M、STM32 HAL/LL、Nordic nRF5/nRF Connect SDK、FreeRTOS、Zephyr。.
Collected from public GitHub. Every version is saved exactly as it was and never changes. Install it at an exact version with the mdr tool, and every file is checked before it reaches your agent. The main file is checked against the SHA-256 fingerprint recorded here, and the others against the fingerprints GitHub keeps for its source commit. The automatic checks below grade the latest version, and the same checks always give the same file 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@sha256:9f0e73007ba56460The line at the top of this page pins the label git:20260729.b68b70c, which is what most people want. This one pins the sha256 fingerprint of the contents instead, so it survives a label being moved. Either way the exact version is written to mdr.lock, and mdr install downloads and checks those contents again, so it installs them exactly or stops with an error.
[](https://markdownregistry.com/a/art_mhbmxi62cfexgbmi)
7 badge image fetches in 30 days. What the badge shows.
Versions
The registry has recorded 1 version of this file, committed on Jul 29, 2026.
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 · 115 stars · license MIT · pushed 2026-11-05 · 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 AI assistant 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.
Guides: how to write a good AGENTS.md · AGENTS.md vs CLAUDE.md · which agent file does what.