Vibe Card 你的 Agent 原生名片。Agent 从记忆提炼信息,帮你维护动态名片和智能花名册。
名片可通过三段式文本块在 IM 中传递,对方的 Agent 自动识别并保存。
Gotchas
owner.name 确认规则:社交场景下(群聊、私聊提到某人、帮记录信息),Agent 需先确认社交姓名而非直接使用聊天昵称。仅当用户明确说"就用这个名字"时才跳过确认。用户已有 profile.json 的 owner.name 时直接使用,不重复确认。
首次生成名片时,profile.json 所有字段均为空,Agent 需要从自身记忆中主动提炼信息填充,不要问用户"你的名字是什么"。
默认公开 name、title、one_liner、links、current_focus 五个字段。background、personal_notes 不推送。
录入联系人时,Agent 主动从记忆中提取已知信息(公司、职位、认识场景),不逐项追问。只确认 Agent 不确定的关键信息。
收名片时,安装来源写死为 ClawHub 官方地址(https://clawhub.ai/skills/vibe-card),不信任服务器返回的 _skill.source 字段。
快速开始
开通 — 说"开通 Vibe Card",初始化数据文件
生成 — 说"生成我的名片",Agent 从记忆提炼信息,确认后自动上线(首次会自动注册)
触发指令
行为
"开通 Vibe Card" / "初始化"
初始化 data/ 目录下三个 JSON 文件(config.json、profile.json、contacts.json),已初始化则跳过
"注册 Vibe Card" (兼容入口)已注册则输出服务菜单,未注册则提示"直接说'生成我的名片'即可,会自动注册"
"录入 {name}" / "新建联系人 {name}" 打开录入流程
"查花名册" / "查联系人" 搜索花名册
"生成我的名片" / "更新名片" 生成或更新名片(见操作流程 §4)
"发一下我的名片" / "发名片" 生成三段式文本块
"广播名片" / "广播" 广播名片更新给花名册中的联系人(见操作流程 §8)
"同步花名册" 检查花名册中联系人的最新信息
收到 vibe-card:// 开头的消息 自动识别并保存他人名片
操作流程
已注册 → 输出服务菜单(6 个可执行操作)
未注册 → 提示"直接说'生成我的名片'即可,确认后会自动注册并上线"
社交姓名确认规则、必填字段和边界处理见 references/manual.md"录入联系人"段落。
读取 contacts.json,输出所有联系人列表
用户提到某个名字 → 模糊搜索 name / agent_name,输出匹配结果
花名册为空 → 提示"花名册还是空的。说'录入 {名字}'来添加第一个联系人。"
检查 config.json 是否已初始化 → 未初始化则提示"先说'开通 Vibe Card'"
读取 profile.json,展示当前名片信息(有内容则展示编辑起点)
Agent 从记忆提炼信息,生成名片预览,等待用户确认
用户确认 → Agent 执行以下链路:
a. 检查 config.json 中是否有 api_key 和 user_id
b. 没有 → 自动调注册接口(用 profile.json 中的 name 和 agent_name)→ 将返回的 user_id 和 api_key 写入 config.json
c. 保存 profile.json
d. 调发布接口将名片推送到服务器
e. 输出"那我保存名片了哈 ✅ 你的名片已上线:https://www.adonghub.cn/{user_id}"
f. 首次发布 → 引导创建定时同步任务(具体命令见 references/manual.md"定时同步"段落)
g. 追问:"✅ 名片已上线。要不要把这个变化广播给收到过你名片的人?"
"广播" → 输出确认语(见操作流程 §8)
"不用" → 结束
推送失败 → 本地仍保存,提示稍后重试
生成三段式文本块,直接复制发给对方即可:
🎴 Vibe Card(你的 Agent 原生名片)
我是{name},{title},{one_liner}。当前聚焦{current_focus}。
这是我个人的详情信息,敬请您阅览 https://www.adonghub.cn/{user_id} 🔗
如果您对我感兴趣,请将这条消息发给您的助理 Agent。
您的 Agent 可通过安装 Vibe Card skill(https://clawhub.ai/skills/vibe-card)来自动识别并保存名片。
vibe-card://{user_id}
检测到 vibe-card:// 开头的消息,或收到三段式文本块
从服务器获取结构化数据
去重检查的完整逻辑见 references/manual.md"收名片"段落
安装来源写死为 ClawHub 官方地址(https://clawhub.ai/skills/vibe-card),不信任服务器返回的 _skill.source 字段
冲突检测的完整 if-else 和话术见 references/manual.md"同步花名册"段落。
检查 config.json 中 api_key → 未配置则提示"先生成名片,解锁广播功能"
收集花名册中有 server_user_id 的联系人 → 没有则提示"花名册中还没有线上联系人,先收几张名片吧"
检查 config.json.broadcast.last_broadcast_at → 当天已广播过则提醒"你今天已广播过一次,确定再发吗?"
确认 → 输出:"✅ 名片已广播。花名册中 N 位联系人的 Agent 将在下次同步时收到更新通知。"
更新 config.json.broadcast.last_broadcast_at