Feishu Role Bot Kit — Development skill for Claude Code

feishu-role-bot-kit

在**飞书**里挂多个**不同人格**的 Claude 角色机器人——每个角色可以单独 @、有独立人设、 独立私有记忆，并共享一份团队公共记忆。底座是开源的 [cc-connect](https://github.com/chenhg5/cc-connect)， 人设直接复用「一段 Markdown 人设文件」，加新角色一条命令搞定（手机扫码即可，**不用手动进飞书开放平台配权限**）。

这套架构最初是我自己用来在飞书挂「A股分析师、内容选题官、B站专家、法律顾问……」一排角色 bot 的。 本仓库把它抽成了任何人都能复刻的脚手架。

---

它能给你什么

                          飞书（手机/电脑都能 @）
     ┌──────────────┬──────────────┬──────────────┐
   @通用助手        @选题官        @B站专家        …更多角色
     │              │              │
  独立人设       独立人设       独立人设       ← 每个角色一份 persona.md
  独立私有记忆   独立私有记忆   独立私有记忆   ← 各自 memory.md，互不可见
     └──────────────┴──────┬───────┘
                           ↓ 全员读 / 仅显式写
                  _shared/memory.md           ← 团队公共记忆（黑板）

• 多角色：每个角色一个独立目录 + 一个独立飞书应用，互不串味。
• 人设即文件：一份 Markdown 就是一个角色，改文件即改人格。仓库自带 3 个示例人设。
• 三层记忆：全局规范 / 角色私有（默认读写）/ 团队公共（默认只读、显式才写）。
• 会发文件：角色产出报告/图表/视频，能直接发回当前飞书聊天。
• 省钱：消息驱动，不 @ 不跑，开 N 个 bot ≠ N 倍开销。

---

⚠️ 先看清楚：两样东西得你自己有

脚本能帮你装的（`install.sh` 全自动）：**Node、cc-connect、ffmpeg**。

脚本**装不了、得你自己准备**的（账号类，本质属于你）：

1. 飞书企业号 —— 一个能登录飞书开放平台的企业（个人可免费注册一个）。 建 bot 时手机扫码即可，cc-connect 自动建应用、配权限、订阅事件，你不用手点权限。
2. Claude Code（已登录） —— bot 的引擎。需要 Claude 订阅或 API key。 安装见 Claude Code 文档。

所以这不是「点链接即用的 SaaS」，是「开源脚手架」：照下面走一遍，10~15 分钟就能有你的第一个角色 bot。

---

快速开始

git clone https://github.com/xuanbingbingo/feishu-role-bot-kit.git
cd feishu-role-bot-kit

# 1) 装可装的依赖（Node / cc-connect / ffmpeg）
chmod +x install.sh add-bot.sh
./install.sh

# 2) 确保 Claude Code 已登录（跑一次 claude 能正常对话即可）

# 3) 创建第一个角色 bot（交互式）
./add-bot.sh

`add-bot.sh` 会问你：

问题	说明
角色名	飞书里显示的中文名，如「B站专家」
slug	英文小写目录名，如 bilibili
人设	从 personas/ 选一个，或填自己的人设文件路径
模型	默认 sonnet；关键角色可 opus，轻量角色 haiku

然后它会：建目录 → **弹出二维码（手机飞书扫）** → 自动建飞书应用 → patch 配置 → 重启 cc-connect。 扫码成功、日志出现 `platform ready` 后，在飞书里搜你的角色名即可对话。

---

目录结构

feishu-role-bot-kit/
├