---
name: skill-builder
description: 技能建设规范。用于为 wind_power_cal 创建/改写 .agents/skills 与 .claude/skills 下的 skill，要求贴合当前 C++/Drogon/React/Vite 技术栈，避免照搬无关项目。
---

# 技能建设规范

为本仓库创建或改写 skill（`.agents/skills/` 与 `.claude/skills/` 需保持同步）。

## 规则
- 每个 skill 一个目录，内含 `SKILL.md`。
- frontmatter：`name`（kebab-case）、`description`（一句话：**何时触发** + 做什么；用于检索匹配）。
- 内容贴合 **wind_power_cal 实际**：C++ Drogon 后端（:8848）、React+Vite 前端、`package.sh / run.sh / deploy.sh`、`third_party` 源码编译 Drogon、响应信封 `{status,msg,data}`。
- **禁止**原封照搬 edge_collector 等其它项目的 skill——其 OTA / 协议采集 / 边缘主机 / collector / configurator / cloud_server 等内容在本仓库不存在，会误导。
- 用 `[[other-skill-name]]` 链接相关技能。
- 通用工程规范（代码风格、git 提交、shell、前端调试）与项目专属规范（`wind-*`）分开维护。

## 命名
- 项目专属：`wind-<domain>`（如 `wind-backend-conventions`、`wind-deploy`）
- 通用：直接 `<domain>`（如 `git-commit`、`cpp-coding-style`、`frontend-debug`）

## 同步
改完 `.claude/skills/` 后，同步到 `.agents/skills/`（两者结构必须一致）：
```bash
rsync -a --delete .claude/skills/ .agents/skills/
```

## 当前 skill 集（参考）
- 项目专属：`wind-project-overview`、`wind-build-run`、`wind-deploy`、`wind-backend-conventions`、`wind-frontend-conventions`、`wind-third-party-libs`
- 通用：`analyze-questions`、`cpp-coding-style`、`git-commit`、`shell-scripting`、`frontend-debug`、`frontend-dialog`、`frontend-ui-conventions`
- 元：`skill-builder`