基于飞书生态的 AI 智能体

基于飞书生态的 AI 智能体

工作应用指南

让 AI 成为你的工作助手 ------ 通过飞书随时随地控制本地智能体完成工作

一、核心原理

这套方案的本质是：用飞书作为"遥控器"，控制你电脑上的 AI 智能体干活。

无需公网 IP、无需服务器、无需懂代码 ------ 只要你的电脑能上网，就能搭建。

系统架构图

你（飞书发消息） → 飞书（消息中转） → cc-connect（桥接） → Claude Code（AI 处理）
                                                              ↓
你（收到回复） ← 飞书（消息通知） ← cc-connect（返回结果） ← 处理完成

工作时序（以"抓取商品数据"为例）

你发消息："抓取 h5.caauc.com 前10个商品"

↓ (1秒)

飞书服务器接收并推送给 cc-connect

↓ (1秒)

cc-connect 转发给 Claude Code

↓ (2秒)

Claude Code 调用 Playwright 打开浏览器抓取数据

↓ (30秒)

Claude Code 整理成 Markdown 表格

↓ (5秒)

Claude Code 调用飞书 API 创建文档

↓ (5秒)

你收到飞书文档链接

总耗时：约 2 分钟（人工需要 30+ 分钟）

## 二、核心工具说明

### 1. Claude Code（AI 大脑）

| 项目 | 说明 |
|------|------|
| 是什么 | 运行在你电脑上的 AI 助手，能理解指令、读写文件、执行命令 |
| 类比 | 就像你雇了一个 24 小时不睡觉的"实习生" |
| 能做什么 | 写代码、分析数据、整理文档、操作浏览器、管理文件 |

### 2. cc-connect（连接桥）

| 项目 | 说明 |
|------|------|
| 是什么 | 把飞书消息转给 AI，再把 AI 回复转回飞书 |
| 类比 | 就像微信网页版，让你在手机上控制电脑程序 |
| 特点 | 使用飞书 WebSocket 长连接，不需要公网 IP 或服务器 |

### 3. Playwright CLI（自动化工具）

| 项目 | 说明 |
|------|------|
| 是什么 | 自动操作浏览器的工具，能打开网页、点击按钮、抓取数据 |
| 类比 | 就像一个"机器人"，自动执行浏览器操作 |
| 典型用途 | 自动抓取网页数据、自动填写表单、自动截图生成报告 |

**安装：**
```bash
npm install -g @playwright/cli@latest

使用示例：

playwright-cli open h5.caauc.com --headed

• --headed 表示显示浏览器窗口（方便看过程）
• 不加则后台运行（更快）

4. 飞书 Skills（飞书能力包）

项目	说明
是什么	一组让 AI 操作飞书的能力包
类比	就像给 AI 装了"飞书插件"
包含能力	发消息、建文档、建表格、管理日历、审批流程、云盘操作

三、什么是 Skills？为什么重要？

一句话概括：Skills 就是给 AI 看的"操作说明书"。

用类比理解 Skills

类比一：新员工入职手册

• 公司来了个新人（AI），他很聪明但不懂公司系统
• Skills = 操作手册："OA系统在 xxx，登录流程是 xxx..."
• 有了手册，新人就能自己干活了

类比二：给手机装 App

• 新手机（AI）只能打电话
• Skills = 应用商店安装 App
• 装"淘宝"App → 手机能购物；装对应 Skills → AI 能操作对应系统

类比三：游戏里的技能卡

• Skills = 技能卡牌
• "火球术"技能卡 → 角色会放火球
• 给 AI 装上"飞书文档"Skill → AI 会操作飞书文档

官方 Skills vs 自建 Skills

官方 Skills（公共能力）	自定义 Skills（核心价值）
飞书 Skills 19 件套	这才是真正有价值的部分
文档操作（创建、编辑、读取）	操作公司内部 OA 审批系统
表格操作（创建、写入、查询）	查询公司 ERP 进销存数据
消息发送、日历、审批等通用功能	生成特定业务报表模板

核心观点： 官方 Skills 只解决"通用问题"，而真正提高工作效率的是结合你公司业务的定制 Skills。

如何创建自己的 Skills？

第一步：梳理业务场景

把你每天的工作流程写下来：

• 我每天要做哪些重复性的操作？
• 哪些数据查找很费时间？
• 哪些报表需要定期生成？

例子： "我每周一需要从 ERP 系统导出上周的销售数据，整理成固定模板，发给老板"

第二步：信息部配合

把业务系统包装成 Skill：

• 提供公司系统的 API 接口文档
• 封装成 CLI 命令（如 company erp sales-export --last-week）
• 配置认证和权限
• 编写 Skill 描述文件（告诉 AI 怎么用）

第三步：编写 Skill 描述

Skill 描述文件示例：

---
name: company-erp
description: "公司 ERP 系统操作"
---
# SKILL.md
# 告诉 AI 如何操作公司 ERP

## 命令
company erp sales-export --date-range week   # 导出上周销售数据
company erp stock-query --sku xxx            # 查询库存

AI 读到这个描述，就知道怎么用了。

信息部需要做的事

1. 把公司各业务系统（OA/ERP/CRM/WMS）的 API 封装成简单易用的 CLI 命令
2. 为每个命令编写 SKILL.md 描述（告诉 AI 命令的作用、参数和执行方式）
3. 建立统一的认证机制，确保 AI 只能操作有权限的系统

完整案例：公司"销售查询"Skill

运营部（提需求） → 信息部（开发） → AI 智能体（使用）

运营："帮我查下张三上月的销售数据"
   ↓
信息部：Skill 解析指令，封装 ERP 查询逻辑
   ↓
AI：调用 ERP 导出命令
   ↓
结果："张三上月销售额 12,800 元 | 订单 23 单 | 回款率 96%"

各角色收益：

角色	原来	现在
运营人员	打开ERP→登录→选模块→导出Excel	发消息"查一下张三上月销售数据"
信息部	每次重复开发	写好 Skill 描述，一次开发长期受益
高层管理者	必须到公司才能看数据	出差途中随时查询

四、应用场景

场景一：运营人员 ------ 数据抓取与报表自动化

实际案例：抓取商城商品数据

• 需求：每天从公司商城抓取前10个商品，整理成表格保存到飞书文档
• 传统方式：人工打开网页→复制粘贴→整理Excel→上传飞书（20分钟/天）
• AI方式：发一条消息，2分钟后收到文档链接

你只需要做：

@我的助手 访问 h5.caauc.com，抓取前10个商品，整理成表格上传到飞书文档

AI 自动完成：

1. 用 Playwright 打开网页

2. 自动抓取商品数据（名称、价格、店铺）

3. 整理成 Markdown 表格

4. 调用飞书 API 创建文档

5. 返回文档链接

   发消息 → 打开网页 → 抓取数据 → 生成表格 → 上传飞书
   总耗时：人工 20 分钟 → AI 2 分钟

场景二：数据分析师 ------ Excel 分析与可视化

实际案例：优惠券数据分析

• 需求：分析 Excel 中的优惠券领取数据，统计客户数和频次分布
• AI方式：上传 Excel → 发消息 → 3 分钟后收到多维表格

输入：

@我的助手 分析这个 Excel，统计总客户数和频次分布，用多维表格展示

输出：

1. 自动读取 Excel 数据
2. 生成统计报告
3. 创建飞书多维表格
4. 自动生成仪表盘（饼图、柱状图）

效果： 人工 30+ 分钟 → AI 3 分钟

场景三：公司高层 ------ 移动办公与远程决策

场景 A：远程审批

• 你发："帮我审批 12345 号流程"
• AI 做：读取审批详情 → 分析内容 → 执行审批 → 通知申请人

场景 B：项目进度查询

• 你发："项目A本周进度如何？"
• AI 做：读取项目文档 → 检查 Git 提交 → 汇总进度报告

场景 C：智能会议安排

• 你发："安排明天下午3点开会，参加人：张三、李四"
• AI 做：检查日历 → 创建会议邀请 → 发送通知 → 创建会议文档

场景四：行政人事 ------ 文档自动化

实际案例：会议录音转周报

• 上传录音 → 发消息 → 5分钟后收到周报文档

延申场景： 合同审核、简历筛选、考勤统计、培训材料生成、员工手册更新

五、快速安装（复制粘贴即可）

步骤 1：安装 Node.js

从 nodejs.org 下载安装 LTS 版本。

验证：node -v

步骤 2：安装 Claude Code

# macOS/Linux
curl -fsSL https://claude.ai/install.sh | bash

# Windows (PowerShell)
irm https://claude.ai/install.ps1 | iex

步骤 3：安装 cc-connect

npm install -g cc-connect

如果下载慢，设置国内镜像：

npm config set registry https://registry.npmmirror.com

步骤 4：安装 Playwright CLI

npm install -g @playwright/cli@latest

步骤 5：创建飞书应用

1. 打开飞书开放平台
2. 创建企业自建应用
3. 复制 App ID 和 App Secret

步骤 6：配置 cc-connect

cc-connect init
cc-connect feishu bind --project mywork --app cli_你的AppID:你的AppSecret

步骤 7：启动服务

cc-connect

看到 "connected" 即成功！

测试

在飞书里搜索机器人，发消息："你好"

如果机器人回复了，说明搭建成功！

---

开始使用你的 AI 工作助手

基于飞书生态的 AI 智能体，让工作更高效。无需懂代码，只需会发消息。