---
url: /zh/develops/skills.md
description: >
  介绍基于 CNB OpenAPI 的 Skills 能力， 提供 AI 与云原生构建平台完整交互的技能集合， 涵盖 Skills
  的概念、加载机制、使用场景及配置方法。
---
## 概述

Skills 是 CNB 为 NPC（AI 助手）提供的标准化能力集，
基于 [OpenAPI](https://api.cnbprod.alpha.qq.com) 构建，使 NPC 能够与平台完整交互。

## 能力清单

官方 Skills 仓库为 [cnb/skills](https://cnb.cool/cnb/skills/cnb-skill)，包含以下核心能力：

**代码托管**：

* 仓库管理（查看、创建、搜索）
* Issue 操作（创建、评论、关闭、标签管理）
* PR 操作（创建、评审、合并、状态查询）
* Git 操作（分支管理、标签、Release）
* 代码评审（自动审查、行级评论）

**构建与部署**：

* 流水线配置与触发
* 构建日志查询
* 构建状态检查

**平台交互**：

* 组织与成员管理
* 用户信息查询
* 制品库操作
* 搜索与动态

> 更完整的 API 能力，参考 [OpenAPI 文档](https://api.cnbprod.alpha.qq.com)。

## 使用场景

### 场景一：NPC 自动处理 Issue

用户在 Issue 中 `@` NPC 后，NPC 自动加载对应 Skill 完成任务：

```text
@CodeBuddy 帮我看看这个 Issue 是否可以关闭
```

### 场景二：NPC 自动评审代码

用户在 PR 中 `@` NPC 请求代码评审：

```text
@CodeBuddy 帮我 review 一下这个 PR
```

## 安装与配置

### 安装 Skills

在 NPC 运行时镜像中安装 Skills
（依赖 [CNB CLI](https://cnb.cool/cnb/plugins/cnbcool/cnb-cli) 提供的 `cnb` 命令）：

```Dockerfile title="Dockerfile"
FROM node:22-bookworm-slim

RUN apt-get update \
    && apt-get install -y --no-install-recommends ca-certificates git git-lfs curl jq ripgrep \
    && rm -rf /var/lib/apt/lists/* \
    && git lfs install \
    && npm install -g @cnbcool/cnb-cli skills \
    && npx skills add https://cnb.cool/cnb/skills/cnb-skill.git -g -y
```

### 自定义 Skill

在项目的 `.codebuddy/skills/` 目录下创建自定义 Skill，每个 Skill 是一个包含 `SKILL.md` 的目录：

```text
.codebuddy/skills/
  my-skill/
    SKILL.md    # Skill 定义文件，描述能力和使用方式
```

NPC 会自动识别并加载项目中的自定义 Skill。

::: tip 同名 Skill 的优先级
全局级 Skill 优先，会覆盖项目级同名 Skill。

两者的查找位置不同：全局级来自用户主目录下的 `~/.agents/skills`、`~/.codebuddy/skills`，
项目级来自仓库内的 `.agents/skills`、`.codebuddy/skills`。
仓库内自带一份过时的同名 Skill 时，生效的是用户目录下的那份。
:::

## 相关文档

* [CNB CLI 插件](https://cnb.cool/cnb/plugins/cnbcool/cnb-cli)
  — Skills 底层使用的命令行工具，提供 `cnb` 命令调用全部 OpenAPI
* [NPC](../build/npc.md) — NPC 的概念、事件类型及配置方式
* [NPC 配置](../repo/settings-npc.md) — 如何在仓库中定义 NPC 角色
* [OpenAPI](./openapi.md) — CNB 平台完整的 API 文档