Skill 分支文档

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

打开 Skill 分支

在 Gitee 上浏览该分支下的全部文档与资料

分支定位

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

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

打开 Skill 分支 README

在 Gitee 上浏览该分支下的全部文档、Skills 与项目源码

为什么单独一个分支？

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

仓库统计

指标	数值
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 技能库为主：

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. 克隆仓库

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

Claude Code

cp -r skills/* ~/.claude/skills/

Trae IDE

cp -r skills/* ~/.trae/skills/

QClaw / OpenClaw

将 skills/ 目录路径添加到 openclaw.json 的 skills.load.extraDirs 中。

3. 编译并烧录固件

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)

常用命令

# 编译与烧录
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 开发环境搭建	前置依赖、安装步骤、验证清单
快速调试电机	HXC 跨工作区 Vibe Coding 调试	调试工作流、命令速查、故障处理
HXC 电机控制项目	HXC 电机控制项目	C620 / N630 / AM32 三套模板与 BoardA 模块库
理解板级设计	[Gitee] `projects/embedded/HXC_A_Usage_Guide.md`	硬件参数、CAN/串口约定、三类工程用法
浏览全部技能	[Gitee] `skills/`	149 个 AI Coding Skills

如何查找资料

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

建议贡献内容

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

机械方向

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

嵌入式方向

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

算法方向

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

软件与工具链方向

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

竞赛与项目方向

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

贡献流程

Fork 或拉取仓库

在 Gitee 上 Fork NEC 主仓库，或本地克隆后切换到 SKill 分支。

git clone https://gitee.com/darrenpig/new_energy_coder_club.git
cd new_energy_coder_club
git checkout SKill
git pull origin SKill

在对应目录添加资料

按技术领域放到对应目录。如果是新领域，可以新建目录并在根目录 README.md 中说明。

SKill/embedded/stm32/
└── README.md

遵循格式规范

使用 Markdown 格式
文件名使用英文或拼音，避免空格
图片统一放到同目录 images/ 下，使用相对路径引用
在文档开头写明作者、日期、适用版本

提交 PR

向 SKill 分支发起 Pull Request，标题建议：

docs(skill): 添加 STM32 开发环境配置指南

PR 描述中说明资料内容、目标读者和参考资料。

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 大类完整索引

飞书/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

AI CLI 调用器 (6)

kimi-cli claude-cli gemini-cli aicodewith trae-assistant persona-switch

前端 & 设计开发 (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

开发工程 & 工作流 (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

搜索 & 资讯聚合 (8)

baidu-search online-search multi-search-engine news news-extractor news-summary neodata-financial-search tech-news-digest

文档 & 办公文件 (7)

docx pdf pptx xlsx doc-coauthoring file-skill email-skill

集成 & 平台连接 (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

学术 & 论文 (6)

acad-paper-prompter paper-scaffold latex-win cit-thesis-writer gradpilot patent-application-cn

新能源 & 光伏 (2)

pv-station-rating pv-storage-bom

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

效率 & 头脑风暴 (9)

productivity-automation-kit plan-my-day study-habits brainstorming consulting-analysis report-generator-skill ai-dev-dashboard ai-data-analysis ai-promotion-query

社交 & 微信生态 (8)

wx-cli-wechat-local-data wechat-cli-export nec-wechat-sync corporate-deep-query xiaohongshu-images xiaohongshu-skills kimi-webbridge xbrowser

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

Skill 文件结构

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

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> 占位符

文档模板

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

# 文档标题

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

## 目标

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

## 前置知识

需要提前掌握哪些内容？

## 步骤

1. ...
2. ...

## 常见问题

### 问题 1

答案...

## 参考链接

- [链接名称](URL)

现有资料索引

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

Gitee SKill 分支

浏览全部现有资料

贡献指南

了解 NEC 通用贡献规范

常见问题

SKill 分支和 Wiki 有什么区别？

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

我可以直接修改别人的资料吗？

可以，但建议通过 PR 提交修改，并在描述中说明改动原因。如果是大幅改写，最好先在群里或 Issue 中与原作者沟通。

资料需要多高的完成度才能提交？

不追求一次完美。即使是半成品笔记，只要标注了”草稿”状态和已知缺口，对新人也可能有价值。社区会一起迭代完善。

关于我们

社区与活动

治理与安全

核心团队

贡献指南

打开 Skill 分支

分支定位

打开 Skill 分支 README

为什么单独一个分支？

仓库统计

目录结构

快速开始

1. 克隆仓库

2. 安装 AI Skills

3. 编译并烧录固件

硬件与命令

硬件参数速查

常用命令

开发入口速查

如何查找资料

建议贡献内容

机械方向

嵌入式方向

算法方向

软件与工具链方向

竞赛与项目方向

贡献流程

AI 工具配置

工具选择指南

Skills 技能库

13 大类完整索引

Skill 文件结构

Skill 安装方式

安全说明

文档模板

现有资料索引

Gitee SKill 分支

贡献指南

常见问题

打开 Skill 分支

​分支定位

打开 Skill 分支 README

​为什么单独一个分支？

​仓库统计

​目录结构

​快速开始

​1. 克隆仓库

​2. 安装 AI Skills

​3. 编译并烧录固件

​硬件与命令

​硬件参数速查

​常用命令

​开发入口速查

​如何查找资料

​建议贡献内容

​机械方向

​嵌入式方向

​算法方向

​软件与工具链方向

​竞赛与项目方向

​贡献流程

​AI 工具配置

​工具选择指南

​Skills 技能库

​13 大类完整索引

​Skill 文件结构

​Skill 安装方式

​安全说明

​文档模板

​现有资料索引

Gitee SKill 分支

贡献指南

​常见问题

分支定位

为什么单独一个分支？

仓库统计

目录结构

快速开始

1. 克隆仓库

2. 安装 AI Skills

3. 编译并烧录固件

硬件与命令

硬件参数速查

常用命令

开发入口速查

如何查找资料

建议贡献内容

机械方向

嵌入式方向

算法方向

软件与工具链方向

竞赛与项目方向

贡献流程

AI 工具配置

工具选择指南

Skills 技能库

13 大类完整索引

Skill 文件结构

Skill 安装方式

安全说明

文档模板

现有资料索引

常见问题