logo
1
1
WeChat Login
docs: 文档调整

NPC Skills

Star Fork

快速创建一个基础的 NPC 项目,默认安装了 CNB 平台默认的 skills,无需额外集成。

遵循 Agent Skills 开放标准,兼容 Claude Code、Cursor、Copilot 等 20+ AI Agent 平台。

包含的技能

create-npc-skill

一键创建完整的 CNB NPC Agent 项目,生成的项目与 npc/eee(鹅鹅鹅) 共享同一套底层 Agent 架构。

生成内容包括:

  • 完整 TypeScript 源码(入口编排、Agent CLI 调用、环境变量、Prompt 构建、降级兜底、日志模块)
  • Docker 多阶段构建(builder + npc 运行时)
  • CNB Pipeline 配置(Docker 构建 + NPC 事件触发)
  • NPC 角色配置(名称、头像、人设、按钮)
  • CNB API 参考文档

安装

# CodeBuddy(全局) npx skills add https://cnb.cool/npc/create-npc-skill.git --yes --global # Claude Code(全局) npx skills add https://cnb.cool/npc/create-npc-skill.git --yes --global --agent claude-code # OpenCode(全局) npx skills add https://cnb.cool/npc/create-npc-skill.git --yes --global --agent opencode # Codex(全局) npx skills add https://cnb.cool/npc/create-npc-skill.git --yes --global --agent codex

安装后,说「帮我创建一个新的 NPC」即可自动触发。

手动使用

# 克隆仓库 git clone https://cnb.cool/npc/create-npc-skill.git # 运行 scaffold 脚本 bash create-npc-skill/skills/create-npc-skill/scripts/scaffold.sh \ --name my-review-bot \ --dir ./my-review-bot

生成项目的架构

CNB 事件(@NPC 评论) ↓ Docker 容器 → start.sh → app.ts → env.ts:解析 CNB 环境变量 → prompt.ts:构建 System Prompt(双模式:对话/工作) → agent.ts:spawn npc CLI → JSON 解析 → 三层评论检测 → 结果:Agent 自发评论 / 宿主代发 / 降级兜底

定制新 NPC

创建项目后,只需修改 3 个文件:

文件修改内容
.cnb/settings.ymlNPC 角色名、人设描述、头像、按钮
.cnb.ymlNPC 触发名、AI 模型
src/prompt.ts默认人设、语气指南、口头禅

其他文件(app.tsagent.tsenv.tstools/cnb.tsDockerfile 等)是底层共享逻辑,通常无需修改。

License

MIT