Agent Skills
返回列表
💻

CNB 自定义 NPC 创建

开发编程 更新于 2026.08.29

将以下提示词粘贴到你的 AI 对话框中：

请根据 https://skillhub.cn/install/skillhub.md，安装 @user_f12a44b7/self-dev-cnb-npc-create。

技能介绍

要解决的问题

在 CNB 上创建一个自定义 NPC，并不是填几行配置就能完成的事。官方方案里的 API 存在硬性限制：fork 不支持、仓库转移不支持（errcode 9）、密钥仓库既不是页面表单也不是普通配置文件、密钥关联没有 API 接口。很多人在这里反复试错——有人想在流水线里自建 Docker 加脚本绕过 npc:go，有人把 API Key 直接写进 .cnb.yml，结果流水线显示 success 但 NPC 始终不回复。这个技能的价值在于把这些坑一次性摊开，给出一条可以直接照做的路径。

核心能力与工作流程

技能把创建过程拆成 9 个步骤：

  • 需求确认：先定功能定位（PR 审查、技术客服、文档助手或通用）、模型选型、名称口号与归属组织
  • 克隆参考仓库：API 不支持 fork，只能用 git clone 后推送到新仓库
  • 改造配置：核心是三处文件——.cnb/settings.yml（角色与 prompt）、.codebuddy/skills/my-llm/SKILL.md（Skill 指令，这是 Agent 框架调度自定义大模型的关键）、.cnb.yml（流水线，必须用 npc:go）
  • 密钥仓库：独立仓库，一个密钥对应一个文件，文件名即变量名
  • 网页侧操作：仓库转移、密钥关联只能手动完成
  • 测试与引入：提交 issue 触发，确认评论 is_npc: true，再在目标仓库的 .cnb/settings.yml 中引用

Skill 设计上有几个必须遵守的约定：allowed-tools 必须声明 Bash，否则无法执行 curl；API Key 一律走环境变量，不硬编码；智谱 API 要用 coding 专用端点。

适用边界

  • 面向 CNB 平台的 NPC 创建场景，与 cnb-npc-dispatch 互补：前者造 NPC，后者给已有 NPC 派任务
  • 私有密钥仓库不支持 Token 访问（errcode 7），遇到时需要调整方案
  • 部分步骤（转移、关联）只能网页操作，无法完全自动化

使用场景

  • 在 CNB 组织里复刻一个 PR 审查 NPC：改造 settings.yml 与 Skill 文件，让 GLM-5.1 自动回复 PR 评论
  • 给开源社区仓库搭建技术客服 NPC：配置知识库检索与回复 Skill，使 Issue 评论由大模型应答
  • 把个人名下的 NPC 仓库转移到目标组织 cnbmm：处理仓库转移与密钥仓库关联的网页侧操作
  • 排查 NPC 流水线显示 success 但 NPC 不回复的问题：核对密钥仓库关联与 API Key 环境变量配置

适合人员

  • CNB 平台的项目维护者：想在团队组织里拥有可 @ 触发的 PR 审查机器人，但不清楚 settings.yml 与 Skill 文件怎么改
  • 开源社区的开发者与运营：希望 Issue 区有自动应答的技术客服 NPC，减少重复回答同类问题的负担
  • 内部工具工程师：需要把自研大模型接进 CNB 的 NPC Agent 框架，但卡在 npc:go 调度与密钥仓库配置上
  • 工程效能团队成员：负责在多个业务仓库统一引入 NPC，需要完整的创建-测试-引入流程作为参考