这是一个开箱即用的 CNB (Cloud Native Build) 模板，包含知识库、NPC 角色和常用 Skills。

cnb-templates/
├── .cnb.yml                    # 流水线配置（知识库构建 + NPC 触发）
├── .cnb/
│   └── settings.yml            # NPC 角色配置
├── .codebuddy/skills/
│   ├── code-review/            # 代码审查 Skill
│   │   └── SKILL.md
│   ├── git-helper/             # Git 助手 Skill
│   │   └── SKILL.md
│   ├── bug-analyzer/           # Bug 分析 Skill
│   │   └── SKILL.md
│   └── api-designer/           # API 设计 Skill
│       └── SKILL.md
├── docs/                       # 知识库文档目录
│   └── getting-started.md
└── README.md                   # 本文件

1. 登录 CNB
2. 点击「创建仓库」
3. 选择「导入已有仓库」或创建空仓库

# 克隆你的 CNB 仓库
git clone https://cnb.cool/your-username/your-repo.git
cd your-repo

# 复制模板文件
cp -r /path/to/cnb-templates/* .

# 提交并推送
git add .
git commit -m "feat: init with CNB templates"
git push origin main

推送代码后，CNB 会自动运行 .cnb.yml 中的流水线，构建知识库。

在 Issue 或 PR 中 @NPC 角色：

• @代码助手 - 回答编程问题
• @docs助手 - 回答文档问题
• @code-reviewer - 代码审查
• @bug修复助手 - Bug 分析
• @架构顾问 - 架构设计建议

自动构建：推送 Markdown 文件后自动构建知识库

查询方式：

• 在仓库页面的 AI 对话框中提问
• 通过 API 调用：POST /{slug}/-/knowledge/base/query

配置项（在 .cnb.yml 中）：

knowledge:update:
  include: "**/*.md"          # 包含的文件
  exclude: ["node_modules/**"] # 排除的文件
  chunkSize: 1500              # 分块大小
  chunkOverlap: 100            # 重叠大小
  issueSyncEnabled: true       # 同步 Issue

预置角色：

角色	用途	触发方式
代码助手	编程问答、代码解释	@代码助手
docs助手	文档相关问答	@docs助手
code-reviewer	自动代码审查	PR 创建/更新时自动触发
bug修复助手	Bug 分析和修复	@bug修复助手
架构顾问	架构设计建议	@架构顾问

自定义角色：

在 .cnb/settings.yml 中添加：

npc:
  roles:
    - name: 我的助手
      avatar:
        src: https://example.com/avatar.png
      prompt: |
        你是...（角色设定）

预置 Skills：

Skill	用途	使用方式
code-review	代码审查	NPC 自动使用
git-helper	Git 操作指导	提问 Git 相关问题
bug-analyzer	Bug 分析	描述 Bug 现象
api-designer	API 设计	描述 API 需求

添加新 Skill：

1. 在 .codebuddy/skills/ 下创建目录
2. 添加 SKILL.md 文件
3. 描述 Skill 的用途、场景和使用方法

在 PR 中评论：

@code-reviewer 请审查这个 PR 的代码质量

在 Issue 中创建：

标题：登录功能偶尔失效

描述：
用户反馈登录后页面白屏，控制台报错...

@bug修复助手 请分析这个问题

在仓库页面的 AI 对话框中：

这个项目如何配置环境？

在 Issue 中：

@架构顾问 请帮我设计一个用户管理的 API

需求：
- 用户注册/登录
- 用户信息管理
- 权限控制

在 .cnb/settings.yml 中：

npc:
  advanced:
    autoWork: true  # NPC 获得读写权限

npc:
  imports:
    list:
      - owner/other-repo  # 导入其他仓库的知识库

在 .cnb.yml 中：

我的助手:
  issue.comment@npc:       # Issue 评论触发
  pull_request.open@npc:   # PR 创建触发
  push:                    # 代码推送触发

1. 检查 .cnb.yml 语法
2. 查看流水线日志
3. 确认文件路径正确

1. 检查 .cnb/settings.yml 格式
2. 确认角色名称匹配
3. 查看流水线运行状态

1. 确认 SKILL.md 文件存在
2. 检查文件格式是否正确
3. 重新构建知识库

• CNB 文档
• NPC 文档
• 知识库文档
• CNB API

欢迎提交 Issue 和 PR 来改进这个模板！

MIT