用途:这是上下文加载技能,用于在任何 InboxMate 工作前建立整体架构认知,随后再执行具体任务。
系统构成:InboxMate 横跨五个独立系统,各自持有数据并暴露 API,彼此不直读数据库,只通过共享 ID 连接——Twenty CRM(GraphQL)、AgentHub DB(Supabase)、通知服务(REST)、Demo 前端页、Ackee 分析。
关键关联:CRM Opportunity 是中心记录。其 id 用作 email_drafts.crm_opportunity_id,demoId 指向 demo_pages.id,companyId、campaignId 分别指向 CRM Company 与 Campaign,demoStatus 是流水线状态。CRM 的 demoId 是 CRM 与 AgentHub 之间唯一可靠的跨系统链接;demo_pages.crm_opportunity_id 常为 NULL,解析时应查 CRM 的 demoId,而非按该列查 Supabase。
状态机:Opportunity.demoStatus 从 PENDING_REVIEW 经审核变为 OK_TO_SEND 或 NEEDS_FIX,发送后为 SENT,跟进后为 FOLLOW_UP_SENT;终态跳过包括 SKIP_FAULTY_WEBSITE、SKIP_IRRELEVANT、SKIPPED、DISQUALIFIED。stage 为 SCREENING、MEETING、PROPOSAL、CUSTOMER。邮件草稿状态为 DRAFT → QUEUED → SENT 或 FAILED,跟进草稿通过 parent_draft_id 关联,send_after_days 控制入队时间。
数据流:CRM 录线索 → 经 MCP 建 agent、知识桶并嵌入 → 建 demo 页并创建 demoStatus=PENDING_REVIEW 的 Opportunity → /review-demos 审核 → /plan-campaign 组活动(offerText、offerExpiresAt 由活动在读取时动态注入,不存 demo_pages)→ /setup-email-drafts 生成外联与跟进草稿 → 排期发送并回写 CRM → 线索认领演示页时克隆 agent 与知识、标记 claimed。
API 与令牌:CRM 用 POST https://crm.psquared.dev/graphql 与 $PSQUARED_CRM_TOKEN;MCP 用 POST https://app.psquared.dev/api/mcp 与 $NUXT_MCP_DEMO_TOKEN;Demo API 为 GET https://app.psquared.dev/api/demo/<id> 公开无鉴权;通知服务与 sanity-check 用 $EMAIL_DRAFT_ONLY_BEARER;Ackee 用 $ACKEE_TOKEN。
健康检查:sanity-check 支持按 crm_opportunity_ids、campaign_id 或 draft_ids 输入,返回 healthy、issues、warnings,并含 demo_page_id 与 avg_tokens,用于跨系统排查与知识质量评估。
限制与注意:Twenty CRM 的 GraphQL 不支持参数化变量,UUID 需直接内联;不要 source .env(值含分号);MCP 令牌名为 NUXT_MCP_DEMO_TOKEN;URL 抓取项 source_type 存为 knowledge_link;不要猜测抓取 URL,应先从首页导航发现,并跳过 /wp-json/、/xmlrpc.php、/feed/ 等垃圾链接;Tavily 失败时改用 WebFetch 并手动 add_to_bucket;单条知识项上限 5 万字符。各技能用途与排序未在本资料中展开的部分暂未提供。