# zephyr-embedded-cpp-style

**Repository Path**: Ethan-ZYS/zephyr-embedded-cpp-style

## Basic Information

- **Project Name**: zephyr-embedded-cpp-style
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-09-04
- **Last Updated**: 2026-09-04

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# zephyr-embedded-cpp-style

个人/团队可复用的 Zed Agent 技能：**Zephyr 嵌入式 C++ 编码风格规范**。

与任何具体工程（如 `zephyr_prj_template`）**完全解耦**，本仓库即唯一真源；
各设备通过脚本把技能安装到本机的全局技能目录。

## 内容

```
zephyr-embedded-cpp-style/
├── SKILL.md                     # 技能本体（frontmatter: name: zephyr-embedded-cpp-style）
├── examples/
│   └── driver_example.hpp       # 符合规范的示例类
├── install.sh                   # 安装脚本（WSL / Linux / macOS）
├── install.ps1                  # 安装脚本（Windows PowerShell 原生）
└── README.md
```

规范要点（详见 `SKILL.md`）：

- 排版遵循 Google C++ Style Guide（2 空格缩进、clang-format `BasedOnStyle: Google`）。
- 命名：函数（含静态成员函数）PascalCase 不加前缀；成员变量 `m_` 前缀；
  静态成员变量 `s_` 前缀；`enum class` 枚举值全大写不加前缀；常量 `k` + PascalCase。
- `if` / `else` / `for` / `while` 即使单条语句也必须带 `{}`。
- Zephyr RTOS 优先使用 zpp 封装（`modules/zpp`），附原生 API → zpp 对照表。

## 各设备安装

### WSL（Zed 运行在 Windows 侧）

```sh
git clone <repo-url> && cd zephyr-embedded-cpp-style
./install.sh
# 自动安装到 /mnt/c/Users/<用户名>/.agents/skills/zephyr-embedded-cpp-style
```

### Linux / macOS 原生

```sh
git clone <repo-url> && cd zephyr-embedded-cpp-style
./install.sh
# 自动安装到 ~/.agents/skills/zephyr-embedded-cpp-style
```

### 纯 Windows（PowerShell）

```powershell
git clone <repo-url>; cd zephyr-embedded-cpp-style
.\install.ps1
# 安装到 $env:USERPROFILE\.agents\skills\zephyr-embedded-cpp-style
```

> 手动指定目标目录：`TARGET=/path ./install.sh`（PowerShell 用 `$env:TARGET`）。

安装后重启 Zed（或开启新会话），技能即被自动发现；修改技能后各设备
`git pull` 再跑一次安装脚本即可更新。

## 生效范围说明

该技能装到**全局**目录后，会影响本机所有 C++（Zephyr/嵌入式）编码任务；
若只想在部分项目生效，可把它复制到对应工程的 `.agents/skills/`（项目级技能）。