gtm-workflow-enrich-network

GTM 工作流：扩充人脉网络

触发条件

创建或更改联系人或关注者扩充工作流时，使用此方案。现有工作流的运行、计划、部署、升级或删除操作应直接交由 gtm-workflow 处理。

范围

本 Artifact SOP 规定了网络扩充工作流。其必需依赖项 gtm-workflow 负责生成的代码、数据库表、运行、计划、部署和共享防护措施。开始构建前请先阅读。此技能提供方案，不会引入其他运行时或审批流程。

输入

用户的联系人或关注者来源；人员和公司扩充能力；gtm-workflow 所需的工作区和运行设置。请遵循方案中的数据和执行约定。

角色

用户提供或选择来源和扩充访问权限。Agent 检查可用能力、填写此方案，并通过 gtm-workflow 构建。该依赖项负责权限、费用和运行决策，包括对话中已授予的授权。

流程

1. 如果缺少来源，请询问 “联系人或关注者应来自哪里？” 可提供 CSV、现有数据库/表，或能检索列表的服务选项。用户已提供来源时，无需再问。如果选择 CSV 但未附加文件，请直接询问：“请上传联系人或关注者的 CSV。尽可能包含 LinkedIn 个人资料 URL、电子邮件或提供商 ID；仅有姓名时可能无法解析。”等待用户通过常规附件上传，不提供答案或上传按钮。选择扩充方式前，先检查其中的标识符和访问权限。如果需要检索，则仅在信息缺失时确认网络归属者、平台，以及联系人还是关注者。
2. 如果用户未指定偏好，请询问 “应使用哪些服务来扩充人员和公司信息？” 可提供现有的已连接服务、用户指定的服务，或协助寻找合适的服务。直接提供商和聚合服务都同样有效；来源检索、人员扩充和公司扩充可以分别使用不同的服务。默认问题、示例、依赖项列表或生成的脚手架中，绝不要写入特定供应商。只有在用户指定供应商或发现流程确认存在实际选项后，才能出现具体提供商名称。
3. 检查所选服务的最新文档、可接受的标识符、当前任职字段、公司标识符、价格、分页和身份验证。构建时发现端点；如果运行时调用顺序已知，则使用普通的提供商调用步骤。聚合服务应使用其自身文档说明的 API 和凭据。对话 Agent 中已连接的工具，并不能证明工作流项目拥有所需凭据。
4. 用一句话说明已确定的行为：来源、人员和公司扩充、所有已确认的当前职位、共享的 People 和 Companies，以及运行上限。只对会影响结果的缺失选项提问，每次只问一个问题。仅进行扩充时，不要询问 ICP 或用户画像。创建时使用 gtm-workflow，并遵循其常规运行决策。
5. 按照方案构建：持久化输入、已扩充人员、去重后的公司扩充、每个人的任职历史，以及使用 gtm-workflow 的关联数据查看器实现两个浏览方向。保留返回的每个职位。只有已确认的当前职位才用于公司扩充。
6. 在付费运行前，通过 gtm-workflow 检查完整的来源 → 人员 → 公司链路的费用和凭据。单人测试须包含该人员选定的当前雇主，并使用同一共享预算。通过验收案例进行验证，然后分别报告人员和公司的结果以及总支出。

输出

使用工作区范围内的 People 和 Companies 表保存的工作流、图表、运行记录，以及仅限该工作流中人员及其当前公司的 Data 视图。每个返回的职位都保留在对应人员名下。待处理公司与未解析的雇主仍可区分。

异常情况

• 需要安装 gtm-workflow，并同时安装其依赖项 gtm-workspace。如果缺少，请指出缺少的技能及其安装命令：npx skills add eliasstravik/gtm-skills -s gtm-workflow -s gtm-workspace -y；全局安装时加上 -g。使用该依赖项继续；不要在此处重新编写其说明。
• 仅包含姓名的列表需要先进行身份解析，或补充更完善的输入，然后才能付费批量增强信息。不要仅凭姓名合并人员或公司。
• 如果来源无法导出或检索数据，需要让用户选择来源。请求关注者并不授权改用联系人或其他受众。
• 未知的任职状态应保留为未知。仅提供一个标题雇主信息的服务无法支持完整的多段工作经历流程；请说明其限制，并提供支持该流程的替代方案，或征求用户明确同意接受较低覆盖率。
• 构建技能或工作流并不授权检索付费名单或开始信息增强。已有的明确运行授权由 gtm-workflow 处理，无需再次询问。

质量检查

• 已提供或询问来源；对服务提供方的提问保持中立，且人员与公司服务可能不同。
• 已阅读 gtm-workflow，并由其负责整个生命周期；工作流不需要评分画像或 ICP。
• 每个返回的职位都得以保留。不同的已确认当前公司共用一份工作列表和预算；不设职位数量上限。
• 多人共用的一家公司只有一个身份，并且每个新鲜度周期只进行一次付费查询，包括跨批次和重叠运行的情况。
• 公司查询失败后可恢复，且无需重新增强人员信息；刷新失败时会保留上次成功的档案和关系。
• 在声称工作流可用之前，已验证两个方向的浏览能力、来源可恢复性、成本上限和验收用例。

参考资料

用于执行和数据的 Recipe；面向用户示例的 interactions；用于验证的 acceptance。必需依赖项：gtm-workflow，包括其工作区和交互规则。