Social Agent - Gerenciador de Relacionamentos com IA
farmost-beep/social-agent
AI que lembra dos seus relacionamentos melhor que você
Ver no GitHubSkill que automatiza o rastreamento de relacionamentos sociais, criando um assistente pessoal que registra interações, gera rascunhos de mensagens e gerencia lembretes. Integra-se com WeChat para envio direto de mensagens e oferece interface de dashboard para visualizar força de relacionamentos.
Instalação
npx convez-ai farmost-beep/social-agent1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.
Métricas
Casos de uso
- Rastrear automaticamente últimas interações com contatos profissionais e pessoais
- Gerar rascunhos de mensagens personalizadas baseados em histórico de conversas
- Receber alertas para relacionamentos que esfriaram (14+ dias sem contato)
- Organizar tarefas de acompanhamento por prioridade (P0/P1) e prazos
- Gerenciar lembretes de aniversários extraídos automaticamente de notas
Veredito

Skill robusta para quem precisa manter relacionamentos profissionais/sociais em escala. A integração com WeChat e automação por agendário (9h/14h/21h) é prática, mas exige configuração local e gerenciamento de dados JSON. Útil principalmente em contexto corporativo ou networking intenso em português/chinês.
README
A tradução para o português deste README ainda está na fila.
社交关系AI管家
一个本地运行的AI管家,自动追踪所有社交关系中「最近干了什么」和「下一步该干什么」。 一个比你更记得住人情世故的AI管家。
✨ 功能
| 功能 | 说明 |
|---|---|
| 📇 联系人管理 | 结构化存储联系人,支持标签/记忆/强度分级 |
| 📝 互动记录 | 记录每次交流,自动提取待办事项 |
| 📊 关系强度 | 基于社交价值的 1-5 级强度,自动动态调整 |
| 🎂 生日提醒 | 自动从备注中提取生日,到期提醒 |
| 🤖 AI拟稿 | 根据互动历史生成微信消息草稿 |
| 📋 待办管理 | 自动生成跟进待办,P0/P1 优先级 |
| 🚨 冷却预警 | 14天/21天未联系自动提醒 |
| 🔄 自动调整 | 基于互动频率自动建议强度升降 |
🚀 快速开始
npm 安装(推荐)
npx social-agent dashboard
首次运行自动安装 Python 依赖和初始化数据。
一键脚本安装
bash <(curl -sL https://raw.githubusercontent.com/farmost-beep/social-agent/main/install.sh)
手动安装
# 1. 克隆到 Claude Code skills 目录
cd ~/.claude/skills
git clone https://github.com/farmost-beep/social-agent.git
cd social-agent
# 2. 安装依赖
pip install -r requirements.txt
# 3. 初始化空数据
cp -r data_template/* data/
# 4. 导入第一个联系人
python3 src/social.py add-contact <ID> --name "姓名" --role "角色"
# 5. 查看仪表盘
python3 src/social.py dashboard
💬 使用方式
方式一:微信里跟机器人聊(推荐)
桥接守护进程在后台运行,直接在微信里发消息:
| 你说 | 它做 |
|---|---|
记一下:和张总聊了合作 | 记录互动,自动提取待办 |
张总最近咋样 | 查最近互动记录 |
最近该联系谁 | 列出14天+未联系的冷关系 |
最近有啥待办 | 列出待办事项 |
多少联系人 | 返回联系人实时统计 |
给李哥发消息 | 拟稿并推送(有微信ID则直发) |
李哥是李总 | 设别名,以后说"李哥"也能找到 |
方式二:Claude Code 对话直接用
直接跟 Claude 说上述指令,AI 读取本地 JSON 返回实时数据。
方式三:命令行
# 联系人管理
python3 src/social.py add-contact <ID> --name NAME --role ROLE --tags TAGS --notes NOTES
python3 src/social.py edit-contact <ID> --name NAME --strength N
python3 src/social.py search QUERY --field name|tags|notes
# 互动与记忆
python3 src/social.py log <CONTACT> <互动摘要>
python3 src/social.py note <CONTACT> <记忆内容> --tags TAGS
# 查看状态
python3 src/social.py status [CONTACT]
python3 src/social.py dashboard
python3 src/social.py birthdays --days 30
# 强度管理
python3 src/social.py adjust # 查看调整建议
python3 src/social.py adjust --apply # 执行调整
python3 src/social.py check # 检查14天+未联系的关系
# AI消息拟稿
python3 src/social.py draft <CONTACT> --tone 亲切|正式|简洁
python3 src/social.py send <CONTACT> --tone 亲切
# 守护进程(自动化推送)
python3 src/agent.py # 单次检查
python3 src/agent.py --daemon # 后台运行
python3 src/agent.py --chat "消息" # 自然语言交互
⏰ 自动化推送
| 时段 | 内容 | 说明 |
|---|---|---|
| ☀️ 09:00 | 早间概览 | 今日待办 + 冷却关系提醒 |
| 💡 14:00 | 午后建议 | 列出14天+未联系的冷关系 |
| 🌙 21:00 | 晚间回顾 | 今日互动总结 + 待办状态 |
🧠 高级功能
别名系统
不用记全名,随时设别名:
李哥是李总
→ 以后说"李哥"也能找到李总
微信直发
存好联系人的内部微信ID后,消息直接发到对方微信:
李总的微信ID是wxid_xxxxxxxxxxxx@im.wechat
→ 以后"给李总发消息"直接推送到对方微信
关系图谱
可视化所有联系人按关系分类,节点大小代表关系强度。图谱生成脚本见仓库 backup 目录。
📖 命令一览
| 命令 | 说明 |
|---|---|
add-contact | 添加联系人 |
edit-contact | 编辑联系人信息 |
search | 搜索联系人 |
log | 记录互动,自动提取待办 |
note | 添加结构化记忆 |
todos | 查看待办列表 |
done | 完成待办 |
draft | AI拟稿,支持语气调节 |
send | 拟稿并推送到微信 |
status | 查看联系人状态或时间线 |
dashboard | 全局仪表盘 |
check | 检查14天+未联系的关系 |
adjust | 查看/执行强度调整建议 |
birthdays | 查看近期生日 |
🧠 设计理念
参见 docs/SPEC.md 完整设计规约。
核心逻辑链:
用户目标 → 社交价值 → 角色×角色×互动 → 强度1-5 → 自动化维护
📁 项目结构
social-agent/
├── SKILL.md # Claude Code 技能定义
├── README.md # 本文件
├── config/
│ └── config.yaml # 配置模板
├── src/ # Python 源码
│ ├── social.py # CLI入口
│ ├── agent.py # 守护进程
│ ├── engine.py # 核心引擎
│ ├── ai.py # AI拟稿
│ ├── push.py # 推送模块
│ └── web.py # Web界面
├── data/ # 用户数据(本地,不上云)
├── data_template/ # 空数据模板
├── docs/ # 文档
│ ├── SPEC.md # 设计规约
│ ├── CONFIG.md # 配置指南
│ └── CHANGELOG.md # 版本日志
├── tests/ # 测试
├── install.sh # 一键安装脚本
├── requirements.txt
├── setup.py
└── LICENSE
⚙️ 配置
📁 数据文件
| 文件 | 说明 |
|---|---|
data/contacts.json | 联系人库 |
data/timeline.json | 互动时间线 |
data/todos.json | 待办队列 |
data/wechat_ids.json | 微信内部ID映射 |
🖇️ 依赖
- Python 3.9+
- Claude Code(AI拟稿引擎)
- 微信推送:cc-connect 桥接(可选)
- 关系图谱:matplotlib + networkx(可选)
📄 许可证
MIT