624 字约 2 分钟
简介
Skills 是 CNB 为 NPC(AI 助手)提供的一套标准化能力集,基于 OpenAPI(在新窗口打开) 构建,使 NPC 能够与 云原生构建 平台进行完整的交互。
简单来说,Skills 就像是 NPC 的"技能包"——每个 Skill 封装了特定领域的知识和操作指令,NPC 可以根据当前任务自动加载匹配的 Skill,从而获得对应的专业能力。
Skills 能力
目前 CNB 提供的官方 Skills 仓库为 cnb/skills,包含以下核心能力:
代码托管:
- 仓库管理(查看、创建、搜索)
- Issue 操作(创建、评论、关闭、标签管理)
- PR 操作(创建、评审、合并、状态查询)
- Git 操作(分支管理、标签、Release)
- 代码评审(自动审查、行级评论)
构建与部署:
- 流水线配置与触发
- 构建日志查询
- 构建状态检查
平台交互:
- 组织与成员管理
- 用户信息查询
- 制品库操作
- 搜索与动态
更完整的 API 能力请参考 OpenAPI 文档(在新窗口打开)。
使用场景
场景一:NPC 自动处理 Issue
当用户在 Issue 中 @ NPC 并提出请求时,NPC 自动加载对应 Skills 来完成任务。例如:
@CodeBuddy 帮我看看这个 Issue 是否可以关闭NPC 会加载 Issue 相关的 Skill,查询 Issue 状态并给出回复。
场景二:NPC 自动评审代码
当用户在 PR 中 @ NPC 请求代码评审时,NPC 加载代码评审相关 Skill:
@CodeBuddy 帮我 review 一下这个 PR安装与配置
安装 Skills
在 NPC 运行时镜像中安装 Skills:
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 的目录:
.codebuddy/skills/
my-skill/
SKILL.md # Skill 定义文件,描述能力和使用方式NPC 会自动识别并加载项目中的自定义 Skills。