SuperAPI AI 工具集

add-lead

办公与效率

查看项目

更新于 10-15 10:16

技能介绍

用途

add-lead 是一个 CRM 数据录入技能,用于向 CRM 系统中添加新的公司、人员或关系记录。当用户表达“添加公司 X”“添加联系人 Y”“新建客户/合作伙伴/线索”等意图时,可调用该技能完成数据写入。

主要能力

该技能围绕 CSV 文件组织 CRM 数据,涵盖以下实体:

  • 公司(Companies):$CRM_PATH/contacts/companies.csv
  • 人员(People):$CRM_PATH/contacts/people.csv
  • 客户(Clients):$CRM_PATH/relationships/clients.csv
  • 合作伙伴(Partners):$CRM_PATH/relationships/partners.csv
  • 线索(Leads):$CRM_PATH/relationships/leads.csv
  • 产品(Products):$CRM_PATH/products.csv

各实体具有明确的字段结构,例如公司包含 company_id、name、website、linkedin_url、type、industry、geo、size、description、created_date、last_updated;人员包含 person_id、first_name、last_name、email、phone、linkedin_url、company_id、role、notes 等;客户包含 client_id、company_id、product_id、status、contract_start、contract_end、mrr、currency、primary_contact_id 等;合作伙伴包含 partner_id、company_id、product_id、partnership_type、status、since、primary_contact_id、revenue_share 等;线索包含 lead_id、company_id、product_id、stage、source、source_direction、source_detail、priority、primary_contact_id、estimated_value、currency、next_action、next_action_date、last_contact_via_primary 等。

使用方式

添加记录时,技能会读取对应 CSV 文件,检查重复项,构造新行并追加保存。例如新增公司时,先检查 website 是否已存在,若不存在则创建包含 company_id、name、website、type、industry、geo、created_date、last_updated 等字段的新行,再写回 CSV。新增联系人前需确认所属公司已存在;新增客户关系前需确认公司和产品均已存在。

保存前必须执行校验:ID 唯一、company_id 存在于 companies.csv、product_id 存在于 products.csv、person_id 存在于 people.csv、无重复(按 email、website、name 检查)、created_date 与 last_updated 已填写。变更后需运行 change-review 技能再提交 PR。

ID 格式规范:公司为 comp-{name}(如 comp-acme),人员为 p-{company}-{number}(如 p-acme-001),客户为 cli-{company}-{number}(如 cli-acme-001),合作伙伴为 ptnr-{company}-{number}(如 ptnr-acme-001),线索为 lead-{company}-{number}(如 lead-newco-001)。

适用场景

适用于需要以结构化 CSV 方式维护 CRM 数据的团队或个人,尤其是销售线索管理、客户关系记录、合作伙伴登记等场景。

限制

该技能依赖 $CRM_PATH 和 $SKILLS_PATH 环境变量指向的本地文件系统路径。数据以 CSV 文件形式存储,未提供数据库或远程同步机制。具体产品功能、收费、价格、平台支持等信息暂未提供。