BKND后端框架查询学习工具Skill btca-bknd-repo-learn

---

name: btca-bknd-repo-learn description: 使用btca（Better Context App）高效查询和学习bknd后端框架。适用于处理bknd时的以下情况：(1) 理解数据模块和模式定义，(2) 实现认证和授权，(3) 设置媒体文件处理，(4) 配置适配器（Node、Cloudflare等），(5) 从bknd源代码和示例中学习，(6) 调试bknd特定问题

使用btca查询bknd

btca是一个用于询问git仓库问题的CLI工具。它克隆仓库，索引它们，并使用AI回答查询。

快速设置

# 安装btca和OpenCode
bun add -g btca opencode-ai

# 配置模型（Big Pickle：免费、快速、出奇的好）
btca config model --provider opencode --model big-pickle

# 添加bknd作为资源
btca config resources add --name bknd --type git --url https://github.com/bknd-io/bknd --branch main

或者创建 btca.config.jsonc：

{
  "$schema": "https://btca.dev/btca.schema.json",
  "model": "big-pickle",
  "provider": "opencode",
  "providerTimeoutMs": 300000,
  "resources": [
    {
      "type": "git",
      "name": "bknd",
      "url": "https://github.com/bknd-io/bknd",
      "branch": "main"
    }
  ]
}

核心命令

提问

btca ask --resource bknd --question "如何定义模式？"

交互式聊天

btca chat --resource bknd

启动TUI

btca

参考文件

详细信息请见：

• setup.md - 完整安装、配置选项、资源管理、故障排除设置问题
• query-patterns.md - 数据、认证、媒体、适配器和框架集成的特定查询模式
• advanced.md - 多资源查询、交互式工作流、性能优化、调试

查询最佳实践

1. 具体 - “如何定义一个具有一对多关系的模式？” vs “如何使用数据模块？”
2. 提供上下文 - “我使用的是Cloudflare Workers。如何配置数据库适配器？”
3. 要求示例 - “展示一个设置密码认证的完整示例”
4. 引用特定文件 - “src/App.ts如何初始化模块？”

学习工作流程

1. 探索高层：询问整体架构和主要模块
2. 模块深入：使用 btca chat --resource bknd 专注于一个模块
3. 实现细节：要求查看特定功能的实现
4. 示例和模式：查询示例目录以获取最佳实践

资源

• btca文档：https://btca.dev
• bknd文档：https://docs.bknd.io
• bknd仓库：https://github.com/bknd-io/bknd