> ## Documentation Index
> Fetch the complete documentation index at: https://docs.newenergycoder.club/llms.txt
> Use this file to discover all available pages before exploring further.

# Skill 分支文档

> NEC Gitee 仓库 Skill 分支的入口、目录结构与贡献指南

NEC 主仓库在 Gitee 上维护了一个 **`SKill` 分支**，用于沉淀与整理技能学习、知识分享、教程资料等内容。本页面作为该分支的文档入口，方便新人快速定位学习资源，也方便贡献者了解如何向分支提交资料。

<Card title="打开 Skill 分支" icon="code" href="https://gitee.com/darrenpig/new_energy_coder_club/tree/SKill/" horizontal>
  在 Gitee 上浏览该分支下的全部文档与资料
</Card>

## 分支定位

`SKill` 分支是 NEC 主仓库在 Gitee 上维护的**技能资料与 AI Coding 资产分支**。当前它主要承担两个角色：

1. **HXC ESP A Board 核心设备维护仓库**：包含 ESP32-S3 主控板的固件、文档与调试工具。
2. **AI Coding Skills 集中托管分支**：收录了 **149 个**跨平台 AI Skills，覆盖 Claude Code、Trae、QClaw/OpenClaw、Kimi 等工具链。

<Card title="打开 Skill 分支 README" icon="code" href="https://gitee.com/darrenpig/new_energy_coder_club/tree/SKill/" horizontal>
  在 Gitee 上浏览该分支下的全部文档、Skills 与项目源码
</Card>

### 为什么单独一个分支？

代码仓库的主分支以工程交付为主，而技能资料更新频繁、版本要求较低，单独分支可以避免污染主分支的提交历史，同时让学习资料更容易被检索和复用。

### 仓库统计

| 指标           | 数值                                                      |
| ------------ | ------------------------------------------------------- |
| AI Skills 总数 | **149**                                                 |
| Skill 文件数    | 1,954                                                   |
| 有效数据来源       | 6 个平台（Claude / QClaw / Trae / OpenClaw / Agents / Kimi） |
| Skills 体积    | \~44 MB                                                 |
| AI 工具配置文件    | 4 套（`.atomcode/` `.kimi/` `.trae/` + Claude CLI）        |
| 硬件目标         | ESP32-S3 (N16R8), CAN TWAI 1Mbps                        |

## 目录结构

SKill 分支当前实际结构以**嵌入式硬件项目**和**AI Skills 技能库**为主：

```text theme={null}
SKill/
├── projects/embedded/                       # 嵌入式固件
│   ├── HXC_A_Usage_Guide.md                 # 板级开发使用说明（必读）
│   └── ESP32_platformio_temple_project/     # 上游子模块 (CQUPTHXC)
│
├── skills/                                  # 🤖 149 个 AI Coding Skills (~44 MB)
│   ├── lark-*/                              # 飞书办公套件
│   ├── qclaw-*/                             # QClaw 平台技能
│   ├── tencent-*/                           # 腾讯生态技能
│   ├── react-*/ frontend-*/ web-*/          # 前端开发
│   ├── pv-*/                                # 新能源 / 光伏
│   ├── docx/ pdf/ pptx/ xlsx/               # 办公文档处理
│   └── ...                                  # 其余 93 个技能
│
├── docs/                                    # 核心开发文档
│   ├── development-setup.md                 # 新设备环境搭建
│   └── vibe-coding-debug.md                 # 跨工作区调试
│
├── .atomcode/                               # AtomCode IDE 项目配置
├── .kimi/                                   # Kimi CLI 项目配置
└── .trae/                                   # Trae IDE 项目配置
```

> 实际目录以 Gitee 分支上的最新文件为准。如果你发现某个领域资料缺失，欢迎补充。

## 快速开始

### 1. 克隆仓库

```bash theme={null}
git clone -b SKill https://gitee.com/darrenpig/new_energy_coder_club.git
cd new_energy_coder_club
git submodule update --init --recursive
```

### 2. 安装 AI Skills

<AccordionGroup>
  <Accordion title="Claude Code" icon="robot">
    ```bash theme={null}
    cp -r skills/* ~/.claude/skills/
    ```
  </Accordion>

  <Accordion title="Trae IDE" icon="code">
    ```bash theme={null}
    cp -r skills/* ~/.trae/skills/
    ```
  </Accordion>

  <Accordion title="QClaw / OpenClaw" icon="puzzle">
    将 `skills/` 目录路径添加到 `openclaw.json` 的 `skills.load.extraDirs` 中。
  </Accordion>
</AccordionGroup>

### 3. 编译并烧录固件

```bash theme={null}
cd projects/embedded/ESP32_platformio_temple_project
pio run --environment temple_project                    # 编译
pio run --target upload --environment temple_project    # 烧录
pio device monitor -b 115200                            # 串口监视
```

## 硬件与命令

### 硬件参数速查

| 参数                | 值                          |
| ----------------- | -------------------------- |
| **MCU**           | ESP32-S3 (rev v0.2, N16R8) |
| **Flash / PSRAM** | 16MB / 8MB                 |
| **CAN TX / RX**   | GPIO8 / GPIO18             |
| **串口**            | USB CDC (115200, 8N1)      |
| **CAN 协议**        | TWAI 1Mbps (经典 CAN)        |

### 常用命令

```bash theme={null}
# 编译与烧录
pio run --environment temple_project
pio run --target upload --environment temple_project

# 串口监视
pio device monitor -b 115200

# 电机控制（通过串口）
python send_cmd.py "c 0.3"    # 电流模式 0.3A
python send_cmd.py "p 90"     # 绝对位置 90°
python send_cmd.py "s"        # 停止
```

### 开发入口速查

| 目标         | 入口                                                              | 说明                                  |
| ---------- | --------------------------------------------------------------- | ----------------------------------- |
| 第一次搭建环境    | [HXC 开发环境搭建](/embedded-software/development-setup)              | 前置依赖、安装步骤、验证清单                      |
| 快速调试电机     | [HXC 跨工作区 Vibe Coding 调试](/embedded-software/vibe-coding-debug) | 调试工作流、命令速查、故障处理                     |
| HXC 电机控制项目 | [HXC 电机控制项目](/embedded-software/hxc-motor-control)              | C620 / N630 / AM32 三套模板与 BoardA 模块库 |
| 理解板级设计     | \[Gitee] `projects/embedded/HXC_A_Usage_Guide.md`               | 硬件参数、CAN/串口约定、三类工程用法                |
| 浏览全部技能     | \[Gitee] `skills/`                                              | 149 个 AI Coding Skills              |

## 如何查找资料

1. **按技术领域浏览**：进入对应目录，查找 `README.md` 或专题文档。
2. **按关键词搜索**：在 Gitee 仓库内使用搜索功能，限定 `SKill` 分支。
3. **从本页跳转**：下方会持续更新已有资料的索引卡片。

## 建议贡献内容

如果你有想要分享的技能资料，欢迎向 `SKill` 分支提交 PR。以下内容都受欢迎：

### 机械方向

* SolidWorks / Fusion 360 建模教程
* 3D 打印参数与后处理经验
* 加工工艺（CNC、线切割、钣金）入门
* 常用标准件选型指南

### 嵌入式方向

* STM32 / ESP32 开发环境配置
* 电机驱动（CAN、PWM、FOC）笔记
* 传感器使用教程（IMU、摄像头、激光雷达）
* RTOS 与实时控制心得

### 算法方向

* 视觉识别（OpenCV、YOLO、传统算法）
* 路径规划与运动控制
* SLAM 入门资料
* 数据集标注与训练经验

### 软件与工具链方向

* Git 工作流与提交规范
* Python 工程化实践
* ROS2 节点开发与调试
* 飞书、Gitee、Markdown 使用技巧

### 竞赛与项目方向

* 赛季复盘（做了什么、为什么失败、下次怎么改）
* 规则解读与策略分析
* 备赛时间线与任务拆分模板
* 预算申报与采购流程经验

## 贡献流程

<Steps>
  <Step title="Fork 或拉取仓库">
    在 Gitee 上 Fork NEC 主仓库，或本地克隆后切换到 `SKill` 分支。

    ```bash theme={null}
    git clone https://gitee.com/darrenpig/new_energy_coder_club.git
    cd new_energy_coder_club
    git checkout SKill
    git pull origin SKill
    ```
  </Step>

  <Step title="在对应目录添加资料">
    按技术领域放到对应目录。如果是新领域，可以新建目录并在根目录 `README.md` 中说明。

    ```text theme={null}
    SKill/embedded/stm32/
    └── README.md
    ```
  </Step>

  <Step title="遵循格式规范">
    * 使用 Markdown 格式
    * 文件名使用英文或拼音，避免空格
    * 图片统一放到同目录 `images/` 下，使用相对路径引用
    * 在文档开头写明作者、日期、适用版本
  </Step>

  <Step title="提交 PR">
    向 `SKill` 分支发起 Pull Request，标题建议：

    ```text theme={null}
    docs(skill): 添加 STM32 开发环境配置指南
    ```

    PR 描述中说明资料内容、目标读者和参考资料。
  </Step>
</Steps>

## AI 工具配置

本分支为 **5 种 AI 编程工具**提供项目级配置，克隆后即可使用。

| 工具                  | 配置路径                                | 说明                                    |
| ------------------- | ----------------------------------- | ------------------------------------- |
| **AtomCode IDE**    | `.atomcode/project-instructions.md` | 项目指令、结构、技能、命令速查                       |
| **Kimi CLI**        | `.kimi/project-instructions.md`     | 代码任务与复杂推理模型命令                         |
| **Claude Code CLI** | `skills/` 目录                        | 可直接复制到 `~/.claude/skills/`            |
| **Trae IDE**        | `.trae/project-instructions.md`     | 项目指令，已集成 60+ Marketplace Skills       |
| **Kimi Code IDE**   | 自动注册                                | 在 IDE 中打开本目录自动注册到 `~/.kimi/kimi.json` |

### 工具选择指南

| 任务场景          | 推荐工具                         | 原因                               |
| ------------- | ---------------------------- | -------------------------------- |
| 嵌入式 C++ 开发    | Kimi CLI / AtomCode          | kimi-for-coding 专长，AtomCode 一键环境 |
| 飞书办公自动化       | Claude Code + lark-\* skills | 25 个飞书 Skill 完整生态                |
| 多步骤自动化        | Claude Code                  | 工具调用 + 文件操作                      |
| 硬件调试分析        | AtomCode Skill               | 一键搭建、烧录、测试                       |
| 前端 / React 开发 | Trae IDE                     | react-best-practices、shadcn 等    |
| 代码审查重构        | Kimi CLI / TRAE-code-review  | 按复杂度选择                           |
| 文档撰写翻译        | Kimi CLI                     | 长文本处理优                           |
| IDE 内 AI 辅助   | Trae / Kimi Code             | 原生 IDE 体验                        |
| 办公文档生成        | docx / pdf / pptx / xlsx     | 专业文档 Skill                       |

## Skills 技能库

本仓库收录了 **149 个** AI Coding Skills，整合自 6 个平台的本地 Skill 生态：

| 来源                                                      | Skills | 代表性技能                                                        |
| ------------------------------------------------------- | ------ | ------------------------------------------------------------ |
| **Claude Code** (`~/.claude/skills/`)                   | 50     | lark-*, pv-*, latex-win, agent-browser                       |
| **QClaw/OpenClaw** (`~/.qclaw/skills/` + Program Files) | 60     | kimi-cli, claude-cli, docx/pdf/pptx/xlsx, qclaw-*, tencent-* |
| **Trae IDE** (`~/.trae/skills/` + builtin)              | 34     | react-*, shadcn, git-commit, canvas-design, TRAE-*           |
| **Agents** (`~/.agents/skills/`)                        | 5      | cit-thesis-writer, gradpilot, wechat-cli-export              |

### 13 大类完整索引

<AccordionGroup>
  <Accordion title="飞书/Lark 办公套件 (25)">
    `lark-shared` `lark-contact` `lark-im` `lark-calendar` `lark-doc` `lark-sheets` `lark-base` `lark-task` `lark-approval` `lark-mail` `lark-drive` `lark-wiki` `lark-minutes` `lark-vc` `lark-vc-agent` `lark-okr` `lark-slides` `lark-whiteboard` `lark-markdown` `lark-event` `lark-attendance` `lark-openapi-explorer` `lark-skill-maker` `lark-workflow-meeting-summary` `lark-workflow-standup-report`
  </Accordion>

  <Accordion title="AI CLI 调用器 (6)">
    `kimi-cli` `claude-cli` `gemini-cli` `aicodewith` `trae-assistant` `persona-switch`
  </Accordion>

  <Accordion title="前端 & 设计开发 (14)">
    `react-best-practices` `react-native-skills` `shadcn` `frontend-design` `frontend-skill` `web-design-guidelines` `web-artifacts-builder` `webapp-testing` `web-design` `canvas-design` `algorithmic-art` `brand-guidelines` `theme-factory` `chart-visualization`
  </Accordion>

  <Accordion title="开发工程 & 工作流 (17)">
    `clean-code-zh` `security-best-practices` `git-commit` `gh-cli` `github-skill` `test-driven-development` `spec-to-implementation` `composition-patterns` `hook-analyzer-skill` `screenshot` `writing-plans` `executing-plans` `defuddle` `planning-with-files` `harness` `agentic-loop` `agent-browser`
  </Accordion>

  <Accordion title="搜索 & 资讯聚合 (8)">
    `baidu-search` `online-search` `multi-search-engine` `news` `news-extractor` `news-summary` `neodata-financial-search` `tech-news-digest`
  </Accordion>

  <Accordion title="文档 & 办公文件 (7)">
    `docx` `pdf` `pptx` `xlsx` `doc-coauthoring` `file-skill` `email-skill`
  </Accordion>

  <Accordion title="集成 & 平台连接 (14)">
    `tencent-docs` `tencent-meeting-mcp` `tencent-survey` `tencent-news` `wecomcli-setup` `wecom-weisheng-scrm` `weiyun` `youdaonote` `notion` `ima` `kdocs` `imap-smtp-email` `tme-openapi` `flyai`
  </Accordion>

  <Accordion title="学术 & 论文 (6)">
    `acad-paper-prompter` `paper-scaffold` `latex-win` `cit-thesis-writer` `gradpilot` `patent-application-cn`
  </Accordion>

  <Accordion title="新能源 & 光伏 (2)">
    `pv-station-rating` `pv-storage-bom`
  </Accordion>

  <Accordion title="QClaw/OpenClaw 平台 (15)">
    `qclaw-cron-skill` `qclaw-env` `qclaw-rules` `qclaw-skill-creator` `qclaw-text-file` `qclaw-openclaw` `self-improving` `self-improving-agent` `session-logs` `skill-vetter` `public-skill` `content-factory` `cloud-upload-backup` `mcporter` `mcp-builder`
  </Accordion>

  <Accordion title="效率 & 头脑风暴 (9)">
    `productivity-automation-kit` `plan-my-day` `study-habits` `brainstorming` `consulting-analysis` `report-generator-skill` `ai-dev-dashboard` `ai-data-analysis` `ai-promotion-query`
  </Accordion>

  <Accordion title="社交 & 微信生态 (8)">
    `wx-cli-wechat-local-data` `wechat-cli-export` `nec-wechat-sync` `corporate-deep-query` `xiaohongshu-images` `xiaohongshu-skills` `kimi-webbridge` `xbrowser`
  </Accordion>

  <Accordion title="TRAE 内置 & 独立工具 (18)">
    `TRAE-code-review` `TRAE-debugger` `TRAE-generate-mini-app` `data-analysis` `redis-development` `find-skills` `dogfood` `aippt` `weather-advisor` `slack-gif-creator` `fbs_bookwriter` `wendao-partner-qclaw-skill` `chuangye` `bdpan-storage` `kc-gui` `github-skill` `resume-builder` `resume-optimizer`
  </Accordion>
</AccordionGroup>

### Skill 文件结构

每个 Skill 目录遵循标准结构：

```text theme={null}
skill-name/
├── SKILL.md              # 核心定义（名称、描述、触发条件、工作流）
├── references/           # 参考文档（API 说明、使用示例）
├── scripts/              # 执行脚本（Python / Shell / PowerShell）
├── templates/            # 模板文件
└── assets/               # 静态资源
```

### Skill 安装方式

| 平台             | 安装路径                | 命令                                 |
| -------------- | ------------------- | ---------------------------------- |
| Claude Code    | `~/.claude/skills/` | `cp -r skills/* ~/.claude/skills/` |
| Trae IDE       | `~/.trae/skills/`   | `cp -r skills/* ~/.trae/skills/`   |
| QClaw/OpenClaw | `~/.qclaw/skills/`  | `cp -r skills/* ~/.qclaw/skills/`  |

## 安全说明

本分支 README 声明已完成安全扫描（2026-06-14），确认：

* ✅ **无硬编码 API Key** — 所有 Token 通过运行时 OAuth/本地代理获取
* ✅ **无真实密码** — 示例中使用占位符
* ✅ **无 JWT / Bearer Token 泄露** — get-token 脚本运行时动态获取
* ✅ **无数据库连接字符串** — 不涉及持久化存储
* ✅ **无 SSH 私钥 / 证书** — 不包含加密凭证
* ⚠️ **用户路径已脱敏** — 工具安装路径使用 `<USERNAME>` 占位符

## 文档模板

新建技能文档时，可以参考以下模板：

```markdown theme={null}
# 文档标题

- 作者：@your_id
- 日期：2026-06-24
- 适用版本：SolidWorks 2024 / STM32CubeMX 6.10 等

## 目标

读完本文，你能完成什么？

## 前置知识

需要提前掌握哪些内容？

## 步骤

1. ...
2. ...

## 常见问题

### 问题 1

答案...

## 参考链接

- [链接名称](URL)
```

## 现有资料索引

> 以下索引会随着 SKill 分支内容更新持续补充。

<CardGroup cols={2}>
  <Card title="Gitee SKill 分支" icon="code" href="https://gitee.com/darrenpig/new_energy_coder_club/tree/SKill/">
    浏览全部现有资料
  </Card>

  <Card title="贡献指南" icon="pen" href="/contributing/guidelines">
    了解 NEC 通用贡献规范
  </Card>
</CardGroup>

## 常见问题

<AccordionGroup>
  <Accordion title="SKill 分支和 Wiki 有什么区别？">
    SKill 分支是仓库内的 Markdown 资料集，适合版本化、结构化的教程和笔记；Wiki（Mintlify 文档站）面向对外展示和社区导航。两者可以互补：SKill 沉淀原始资料，Wiki 做精选汇总。
  </Accordion>

  <Accordion title="我可以直接修改别人的资料吗？">
    可以，但建议通过 PR 提交修改，并在描述中说明改动原因。如果是大幅改写，最好先在群里或 Issue 中与原作者沟通。
  </Accordion>

  <Accordion title="资料需要多高的完成度才能提交？">
    不追求一次完美。即使是半成品笔记，只要标注了"草稿"状态和已知缺口，对新人也可能有价值。社区会一起迭代完善。
  </Accordion>
</AccordionGroup>