# 🚀 如何使用 Skill - 快速指南

Skill 已更新并重命名为 **`feishu-fetch-messages`**（飞书消息拉取器）

---

## ⚡ 最简单的使用方式

在 Claude Code 中，直接说：

```
拉取飞书消息
```

Claude 会自动：
1. 识别这是拉取消息的请求
2. 使用 feishu-fetch-messages skill
3. 引导你完成所有步骤

---

## 📋 完整的触发词列表

这些词都可以触发 skill：

```
✅ "拉取飞书消息"
✅ "获取群聊记录"
✅ "读取飞书群"
✅ "从飞书群获取消息"
✅ "查看飞书群内容"
✅ "看看飞书群说了什么"
✅ "读取群聊历史"
✅ "获取飞书对话"
```

---

## 💬 实际对话示例

### 示例 1: 最基础的用法

```
你: 拉取飞书消息

Claude: 我将使用 feishu-fetch-messages skill 来获取消息。

       请提供群聊 ID，或者我可以列出所有可用的群聊。

你: 列出群聊

Claude: [运行 list_chats.py]

       找到以下群聊：
       1. 苏鹏宇, 何梓阳 (oc_b741b27703db1688e5ca56d5ed571c80)

       请选择：

你: 1

Claude: 需要获取多少条消息？或指定时间范围？

你: 最近 20 条

Claude: [执行拉取]
       [显示消息内容]

       已成功获取 20 条消息。需要我进行分析吗？
       1. 查看原始消息
       2. 生成会议纪要
       3. 创建讨论总结
       4. 其他

你: 生成会议纪要

Claude: [分析消息并生成结构化会议纪要]
```

### 示例 2: 一步到位

```
你: 拉取测试群（oc_b741b27703db1688e5ca56d5ed571c80）最近 50 条消息并生成会议纪要

Claude: [自动拉取消息]
       [自动生成会议纪要]

       # 会议纪要 - 项目讨论
       ...
```

### 示例 3: 指定时间范围

```
你: 获取昨天下午 2-4 点的群聊记录

Claude: 请提供群聊 ID...

你: oc_b741b27703db1688e5ca56d5ed571c80

Claude: [拉取 2-4 点的消息]
       [显示内容]
```

---

## 🎯 拉取后可以做什么

### 1. 直接查看原始消息

```
你: 拉取消息，只显示原始内容
```

### 2. 生成会议纪要

```
你: 拉取消息后生成会议纪要
```

会生成结构化的会议纪要，包括：
- 会议议题
- 讨论内容
- 达成共识 ✅
- 待办事项 📝
- 关键决策 🎯

### 3. 创建讨论总结

```
你: 拉取消息并总结主要讨论内容
```

会生成：
- 主要话题
- 讨论要点
- 重要信息
- 待跟进事项

### 4. 生成每日报告

```
你: 拉取今天的消息，生成每日工作总结
```

会生成：
- 今日活动
- 工作进展（按人分组）
- 问题与阻碍
- 明日计划

### 5. 提取待办事项

```
你: 从消息中提取所有待办事项
```

### 6. 自定义分析

```
你: 拉取消息，然后统计每个人的发言次数
你: 拉取消息，找出所有提到"项目"的讨论
你: 拉取消息，生成英文摘要
```

---

## 🔧 常见使用场景

### 场景 1: 每日站会总结

```
你: 获取今天早上 9:00-9:30 的群消息，生成每日报告

Claude: [拉取并生成每日站会总结]
```

### 场景 2: 会议纪要

```
你: 拉取昨天下午项目讨论会的消息（14:00-16:00），生成会议纪要

Claude: [拉取并生成结构化会议纪要]
```

### 场景 3: 快速回顾

```
你: 我好几天没看群了，帮我看看最近说了什么

Claude: [拉取最近消息并生成摘要]
```

### 场景 4: 周报生成

```
你: 获取本周的群聊记录，生成周报

Claude: [拉取本周消息并按话题总结]
```

---

## ❓ 常见问题

### Q: 为什么 Skill 没有触发？

**可能原因 1**: 触发词不够明确

- ❌ "帮我看看群里" → 太模糊
- ✅ "拉取飞书消息" → 明确

**可能原因 2**: Skill 文件位置不对

检查：
```bash
ls .claude/skills/feishu-fetch-messages/SKILL.md
```

**解决方案**: 明确说明使用 skill
```
你: 使用 feishu-fetch-messages skill 来拉取消息
```

### Q: 如何知道有哪些群聊可用？

Skill 会自动运行 `list_chats.py` 列出所有群聊。

或者你可以提前查看：
```bash
./venv/bin/python list_chats.py
```

### Q: 必须先拉取消息，再要求分析吗？

不是！你可以一次性说清楚：

```
你: 拉取消息并生成会议纪要

Claude: [一步完成]
```

### Q: 拉取的消息会保存吗？

会临时保存为 `chat_messages.md`，但不会永久存储。

### Q: 可以拉取多个群的消息吗？

目前每次只能拉取一个群。如果需要拉取多个群：

```
你: 先拉取群 A 的消息

Claude: [拉取群 A]

你: 再拉取群 B 的消息

Claude: [拉取群 B]
```

---

## 📚 文档位置

- **本文档**: 快速入门指南
- **快速参考**: `.claude/skills/feishu-fetch-messages/QUICKREF.md`
- **完整说明**: `.claude/skills/feishu-fetch-messages/README.md`
- **使用示例**: `.claude/skills/feishu-fetch-messages/EXAMPLE.md`
- **Skill 定义**: `.claude/skills/feishu-fetch-messages/SKILL.md`
- **更新说明**: `SKILL更新说明.md`

---

## 🎓 团队使用建议

### 1. 快速培训（5 分钟）

向团队成员演示：

```
在 Claude Code 中说：
"拉取飞书消息"

然后跟着 Claude 的引导操作即可。
```

### 2. 创建常用模板

分享给团队：

```
# 每日站会
"获取今天早上 9:00-9:30 的群消息，生成每日报告"

# 项目会议
"拉取昨天下午 2-4 点的群消息，生成会议纪要"

# 快速回顾
"看看群里最近说了什么"

# 周报
"获取本周群聊记录，生成周报"
```

### 3. 养成习惯

- 每日站会后 → 生成每日报告
- 重要会议后 → 生成会议纪要
- 每周五 → 生成周报

---

## ✨ 优势总结

### 对比手动操作

**手动方式**（需要 10+ 分钟）：
1. 打开飞书
2. 手动复制消息
3. 整理格式
4. 提取关键信息
5. 编写纪要

**使用 Skill**（只需 30 秒）：
```
你: 拉取消息并生成会议纪要

Claude: [自动完成所有步骤]
```

### 对比命令行

**命令行方式**（需要记住命令）：
```bash
./venv/bin/python -m feishu_docx.cli.main fetch-messages \
  oc_xxx --from "2026-01-26 14:00" --to "2026-01-26 16:00" \
  -o meeting.md
cat meeting.md
# 手动分析和整理...
```

**使用 Skill**（自然语言）：
```
你: 拉取消息并生成会议纪要
```

---

## 🚀 现在就试试！

在 Claude Code 中说：

```
拉取飞书消息
```

然后跟着 Claude 的引导操作！

---

**记住最简单的方式：直接说 "拉取飞书消息"！** 🎉