메뉴
嵌入式C语言编码规范，适用于安全关键嵌入式系统。强制执行OOP设计模式、内存安全、线程安全、硬件交互规则和强制的编辑后安全审查。在编写、修改或审查C代码、嵌入式固件、驱动、HAL代码、RTOS任务或任何运行在嵌入式平台上的代码时使用此Skill。当用户提到C语言、嵌入式系统、MCU、STM32、驱动、外设或固件开发时也会触发。
Codex 또는 Claude로 설치 이 Prompt를 복사해 Codex, Claude 또는 다른 어시스턴트에 붙여 넣으면 Skill 페이지를 검토하고 설치를 진행할 수 있습니다.
SOC 직업 분류 기준
| name | embedded-c-coding |
| description | 嵌入式C语言编码规范，适用于安全关键嵌入式系统。强制执行OOP设计模式、内存安全、线程安全、硬件交互规则和强制的编辑后安全审查。在编写、修改或审查C代码、嵌入式固件、驱动、HAL代码、RTOS任务或任何运行在嵌入式平台上的代码时使用此Skill。当用户提到C语言、嵌入式系统、MCU、STM32、驱动、外设或固件开发时也会触发。 |
这是安全关键嵌入式系统代码。缺陷可能导致系统故障甚至安全事故。 每一行代码都必须以极其谨慎的态度编写和审查。
在编写或修改代码之前，判断哪些参考文档适用：
编写/修改代码？
├── 设计模块结构、接口、回调？
│ ├── 阅读 references/architecture.md
│ └── 阅读 references/design-patterns.md
│
├── 编写函数、命名、错误处理？
│ └── 阅读 references/clean-code.md
│
├── 使用堆内存、线程、共享资源？
│ └── 阅读 references/memory-safety.md
│
├── 与硬件、外设、HAL交互？
│ └── 阅读 references/hardware-interaction.md
│
├── 任何代码修改？
│ ├── 阅读 references/code-style.md
│ └── 阅读 references/safety-checklist.md（强制）
│
└── 编辑完成？
└── 阅读 references/safety-checklist.md
并执行每一个检查项（阶段1-12）
如有疑问，阅读所有参考文档。 对于安全关键代码， 过度检查总好过检查不足。
每次代码修改后，无论修改多小，都必须执行
references/safety-checklist.md 中的完整安全审查。这不是可选的。
一行代码的改动就可能引入内存泄漏、竞态条件或栈溢出。
每次后续修复后也要重新执行检查清单——修复一个问题可能引入另一个。
以下是不可商量的约束：
| 规则 | 限制 |
|---|---|
| 最大函数长度 | 80行 |
| 最大嵌套深度 | 4层 |
| 最大行宽 | 80列 |
| 最大函数参数数 | 5个（超过则组合成结构体） |
| 线程中大型局部变量 | 评估栈使用，紧张时用堆 |
| 魔法数字 | 禁止，使用宏 |
| 死代码/未使用代码 | 必须删除 |
| 非公共符号 | 必须声明为 static |
| 未修改的指针 | 必须使用 const |
| 头文件 | 必须有头文件保护宏 |
| 注释语言 | 推荐英文，或与项目一致 |
| 注释中的作者 | 兆鸣嵌入式 |
在编写任何代码之前，先检查周围的代码库：
编写新驱动时：
设计或修改模块结构时：
编写任何函数时：
按领域组织的详细规格：
| 参考文档 | 何时阅读 |
|---|---|
| architecture.md | 模块设计、OOP模式、接口、回调 |
| design-patterns.md | SOLID原则、C语言GoF模式（状态机、观察者、策略、工厂） |
| clean-code.md | Clean Code + 华为规范：命名、防御性编程、错误处理、const/static |
| memory-safety.md | 堆分配、线程安全、共享资源、防御性编码 |
| hardware-interaction.md | HAL、寄存器、外设、事件驱动框架 / RTC |
| code-style.md | 格式、命名、注释、宏、头文件保护 |
| safety-checklist.md | 每次编辑后强制执行 - 12阶段安全审查 |