用途:在 ~/Vault/Contacts/ 下管理联系人,每个联系人为一个 Markdown 文件(含 YAML frontmatter),索引文件为 ~/Vault/Contacts/index.md。
主要能力:frontmatter 支持 name、aliases、role、organizations、vip、slack_user_id、slack_dm_channel、website、github、twitter、email、tags 等字段;正文分 Contact Channels、Projects、Key Context、Recent Activity 等段落。
使用方式:首选触发丰富流水线,向 Inngest 发送 contact/enrich.requested 事件,contact-enrich 函数会聚合 Slack、Roam、web/GitHub、Granola、Brain 等来源并用 LLM 综合写入 Vault。depth 支持 full(约 60 秒、约 $0.05,全部 7 个来源)与 quick(约 10 秒、约 $0.01,仅 Slack 与记忆)。hints 可选,提供 Slack ID、GitHub、Twitter、email、website 可提升结果。也可手动创建简单联系人并写入 index.md。更新时重跑丰富并传入 vault_path,综合器会合并而非丢弃已有事实。
适用场景:VIP 联系人标记 vip: true 后可获深度丰富与持续监控;未知 Slack 用户可先查 profile 再触发丰富;Roam 归档可用于补充 egghead 时期历史。
限制:联系人文件位于私有 Vault,Slack 数据保持私密,email/phone 仅供 Joel 参考;CLI 在 Bun v1.3.9 下有 OTEL 导入问题,故用 curl;并发上限为 3;部分监控阶段(ADR-0151 Phase 2+)尚未实现。