convez.ai
SkillProdutividadeIntermediário
farmost-beep

Social Agent - Gerenciador de Relacionamentos com IA

farmost-beep/social-agent

AI que lembra dos seus relacionamentos melhor que você

Ver no GitHub
InicialPluginScore · de 0 a 100

Skill 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-agent

1 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

Estrelas
0
Forks
0
Acompanhando
0
Saúde
42%
Último commit
há 4 meses
Versão
v1.0.0
Issues abertas
1
Contribuidores
2

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管家。

License

✨ 功能

功能说明
📇 联系人管理结构化存储联系人,支持标签/记忆/强度分级
📝 互动记录记录每次交流,自动提取待办事项
📊 关系强度基于社交价值的 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完成待办
draftAI拟稿,支持语气调节
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

⚙️ 配置

见 docs/CONFIG.md

📁 数据文件

文件说明
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

Ver o original no GitHub

Bom para

Relacionados