WeChat-MCP 子代理使用指南

# WeChat-MCP 子代理使用指南

本项目包含 5 个专门为 WeChat-MCP 设计的智能子代理（Sub-agents），帮助用户更高效地管理和使用微信聊天功能。

## 📋 子代理列表

<details>
<summary>聊天记录总结器 (chat-summarizer)</summary>

**用途**：总结指定聊天的历史消息，提取重要信息、事实和话题

**使用场景**：

- 快速了解某个聊天的主要内容
- 回顾重要信息和决定
- 查找待办事项和关键日期

**使用方法**：

```
使用 chat-summarizer 总结与 [联系人/群名] 的聊天记录
帮我总结一下和小明最近聊了什么
```

**参数**：

- `chat_name`: 聊天对象或群组名称

</details>

<details>
<summary>自动回复器 (auto-replier)</summary>

**用途**：读取最近消息，理解上下文后自动生成并发送回复

**使用场景**：

- 快速回复某个聊天
- 忙碌时需要及时响应
- 简单的确认或回应

**使用方法**：

```
使用 auto-replier 帮我回复一下 [联系人]
用 auto-replier 自动回复小李的消息
```

**参数**：

- `chat_name`: 需要回复的聊天对象

**特点**：

- 自动获取最近 30 条消息
- 理解对话上下文
- 生成得体的回复
- 遵循安全守则（不做重要承诺）

</details>

<details>
<summary>消息搜索器 (message-searcher)</summary>

**用途**：在聊天历史中搜索特定内容、关键词或话题

**使用场景**：

- 查找之前提到的信息
- 搜索特定话题的讨论
- 找回分享的链接或文件

**使用方法**：

```
使用 message-searcher 在与小明的聊天中搜索 "见面时间"
用 message-searcher 找一下小红分享的那篇文章
```

**参数**：

- `chat_name`: 要搜索的聊天对象
- `search_query`: 搜索关键词或话题

**特点**：

- 支持关键词、话题、人物搜索
- 提供上下文信息
- 相关度评分
- 搜索结果清晰展示

</details>

<details>
<summary>多聊天监控器 (multi-chat-checker)</summary>

**用途**：同时检查多个聊天的最新消息，识别重要和需要回复的内容

**使用场景**：

- 早上查看所有聊天更新
- 快速了解哪些聊天需要关注
- 筛选优先处理的消息

**使用方法**：

```
使用 multi-chat-checker 检查 [小明, 小红, 工作群] 的消息
用 multi-chat-checker 看看哪些聊天需要我回复
```

**参数**：

- `chat_names`: 需要检查的聊天列表
- `priority_keywords`: （可选）优先关注的关键词

**特点**：

- 按紧急程度分类
- 识别需要立即回复的消息
- 过滤群聊无关消息
- 提供行动建议

</details>

<details>
<summary>聊天洞察分析器 (chat-insights)</summary>

**用途**：深入分析聊天模式、关系动态和沟通习惯，提供洞察和建议

**使用场景**：

- 了解某段关系的状态
- 改进沟通方式
- 分析聊天模式

**使用方法**：

```
使用 chat-insights 分析我和小明的聊天
用 chat-insights 看看我和女朋友的聊天怎么样
```

**参数**：

- `chat_name`: 要分析的聊天对象
- `analysis_focus`: （可选）分析重点

**特点**：

- 关系亲密度评估
- 沟通模式分析
- 话题分布统计
- 情感基调识别
- 提供改进建议

</details>

---

## 🎯 选择合适的子代理

| 需求                   | 推荐子代理         |
| ---------------------- | ------------------ |
| 了解聊天内容           | chat-summarizer    |
| 发送消息但不知道怎么说 | auto-replier       |
| 快速回复消息           | auto-replier       |
| 查找历史信息           | message-searcher   |
| 批量检查多个聊天       | multi-chat-checker |
| 了解关系状态或改进沟通 | chat-insights      |

---

## ⚙️ 技术细节

### 工具权限

各子代理使用的 MCP 工具：

- **只读取**：chat-summarizer, message-searcher, multi-chat-checker, chat-insights

  - 工具：`mcp__wechat-mcp__fetch_messages_by_chat`

- **读取+发送**：auto-replier
  - 工具：`mcp__wechat-mcp__fetch_messages_by_chat`, `mcp__wechat-mcp__reply_to_messages_by_chat`

### 模型选择

- **Sonnet 模型**：chat-summarizer, auto-replier, chat-insights

  - 需要深度理解和复杂推理

- **Haiku 模型**：message-searcher, multi-chat-checker
  - 速度优先，任务相对简单

---

## 📝 注意事项

### 使用建议

1. **首次使用**：先用默认系统提示词（[`CLAUDE.md`](../../CLAUDE.md)）熟悉功能
2. **重要消息**：涉及重要决定时，不要使用 WeChat-MCP
3. **多轮对话**：可以在同一对话中连续使用多个子代理
4. **自定义调整**：可以编辑 `.claude/agents/` 下的 markdown 文件来调整子代理行为

### 局限性

- 子代理的理解依赖于获取的消息数量（默认 30-100 条）
- 对于很长的聊天历史，可能无法访问所有内容
- 表情、图片、语音等非文本内容可能无法完整分析
- 自动回复和消息撰写基于 AI 推理，请在发送前确认内容合适

---

## 🔧 自定义和扩展

### 修改现有子代理

编辑 `.claude/agents/` 目录下的对应 `.md` 文件：

```bash
# 例如，修改自动回复器的行为
vim .claude/agents/auto-replier.md
```

### 创建新的子代理

1. 在 `.claude/agents/` 创建新的 `.md` 文件
2. 添加 YAML frontmatter 定义名称、描述、工具等
3. 编写详细的系统提示词

参考现有子代理的格式和结构。

---

## 🆘 常见问题

**Q: 如何知道 Claude 选择了哪个子代理？**
A: Claude 会明确告诉你它使用了哪个子代理来完成任务。

**Q: 可以同时使用多个子代理吗？**
A: 可以，例如先用 chat-summarizer 了解情况，再用默认系统提示词发送回复。

**Q: 子代理发送的消息可以撤回吗？**
A: 一旦发送就无法通过 Claude 撤回，请确保内容合适后再让子代理发送。

**Q: 如何禁用某个子代理？**
A: 删除或重命名对应的 `.md` 文件即可。

**Q: 子代理支持群聊吗？**
A: 是的，所有子代理都支持个人聊天和群聊。

---

## 📚 更多资源

- [WeChat-MCP 主项目文档](../README.md)
- [Claude Code 子代理文档](https://code.claude.com/docs/en/sub-agents.md)
- [MCP 协议说明](https://modelcontextprotocol.io/)

---

## 🙏 反馈和贡献

如果你有改进建议或发现问题：

1. 提交 Issue 到 GitHub 仓库
2. 分享你自定义的子代理
3. 帮助完善文档

祝你使用愉快！ 🎉