winai

name	winai
description	winai 客户销售管理系统。支持团队/客户/技能/文档的查询，以及创建客户、执行LTC技能，获取客户最新的文档、添加跟进记录、生成客户360报告、一键客户创建+技能链执行+360报告生成等

AISA 客户文档管理

配置

config.yml 位于技能根目录，使用前需 source scripts/config.sh 加载。 其中包含了 请求的地址、token、team_id 这些关键信息

技能描述

winai客户销售管理系统的 技能，提供以下核心功能：

核心功能

1. 团队管理

   • 查询用户所属的团队列表
   • 支持按名称搜索团队

2. 客户管理

   • 查询团队下的客户列表
   • 支持按名称搜索客户
   • 创建新客户并自动触发 AI 调研

3. 技能管理

   • 查询团队可用的 LTC 技能列表
   • 查询客户可用的技能列表
   • 支持按名称搜索技能

4. 文档管理

   • 查询客户的文档列表
   • 获取文档详情
   • 获取技能产出的最新文档

5. LTC技能执行

   • 执行 LTC 技能（异步）
   • 支持传入参数和消息
   • 重要：执行技能时需要客户ID（UUID格式），如果只有客户名称，需要先查询。
   • 使用脚本: scripts/query-customers.sh <team_id> <客户名称>

适用场景

• 售前客户研究：查询客户信息，执行研究技能
• 客户信息维护：创建客户，更新客户背景资料
• 技能自动化：执行LTC技能，生成分析报告
• 文档管理：查询技能产出，获取最新分析结果

查询和写入的相关参数

查询

脚本	用法	说明
query-teams.sh	无参数	团队列表
query-customers.sh <team_id> [search]	必传团队 ID	客户列表
query-skills.sh [team_id] [search]	团队ID可选（用config默认值）	团队LTC技能列表
query-customer-skills.sh <customer_id>	必传客户 ID	客户可用LTC技能列表
query-docs.sh <customer_id>	必传客户 ID	客户文档列表
get-document.sh <doc_id>	必传文档 ID	文档详情

写入

脚本	用法	说明
create-customer.sh <team_id> '<json>'	JSON: {"name":"公司","industry":"行业"}	创建客户并触发AI调研（异步）
get-customer-info.sh <customer_id>	—	获取客户详细信息和背景资料
update-customer-profile.sh <customer_id> <字段> <内容>	字段: background/decision/history	增量更新客户背景资料
execute-skill.sh <customer_id> <skill_id> ['<json>']	可选JSON参数，如 {"message":"提示"}	执行LTC技能（异步）
get-latest-doc.sh <customer_id> <skill_id>	—	获取技能产出的最新文档
add-followup.sh <customer_id> <content>	content为跟进内容	添加客户跟进记录
generate-customer360.sh <customer_id>	—	生成客户360报告（异步，约1-2分钟）
get-customer360-url.sh <customer_id>	—	查询360报告链接，已生成返回URL
quickcreate.sh <客户名称> [行业]	—	一键执行完整客户开发流程（约10-20分钟）

调用示例

cd ~/.openclaw/skills/winai
source scripts/config.sh
bash scripts/query-teams.sh
bash scripts/query-skills.sh "team-uuid" "分析"
bash scripts/create-customer.sh "team-uuid" '{"name":"测试公司","industry":"科技"}'
bash scripts/execute-skill.sh "customer-uuid" "skill-uuid"
bash scripts/get-latest-doc.sh "customer-uuid" "skill-uuid"
bash scripts/add-followup.sh "customer-uuid" "客户已完成第一轮演示，反馈积极。"
bash scripts/generate-customer360.sh "customer-uuid"
# 等待1-2分钟后
bash scripts/get-customer360-url.sh "customer-uuid"

# 一键客户创建并执行完整技能链（约10-20分钟）
bash scripts/quickcreate.sh "招商银行" "金融"

⚠️ 重要提示

1. customer_id 必须是 UUID

   • 不能直接使用客户名称
   • 必须先通过 query-customers.sh 查询获取
   • 错误示例：execute-skill.sh "招商银行" "破冰话题库" ❌
   • 正确示例：execute-skill.sh "customer-uuid-123" "破冰话题库" ✅

2. skill_id 支持两种格式

   • UUID: abc-123-def-456
   • 中文名称: 破冰话题库（推荐，更易记）

3. 异步执行

   • 创建客户和执行技能都是异步操作
   • 立即返回结果，但实际执行在后台进行
   • 需要等待 30 秒到数分钟后使用 get-latest-doc.sh 获取结果

客户跟进记录

添加跟进记录

# 添加一条跟进记录
bash scripts/add-followup.sh "customer-uuid" "今天与客户进行了初步沟通，客户对WPS 365的文档协作功能表示兴趣，计划下周安排产品演示。"

注意：customer_id 必须是 UUID，可通过 query-customers.sh 查询获取。

工作流程示例

# 1. 查询客户，获取 customer_id
bash scripts/query-customers.sh "$AISA_TEAM_ID" "招商银行"

# 2. 添加跟进记录
bash scripts/add-followup.sh "customer-uuid" "客户已完成第一轮产品演示，反馈积极。"

# 3. 继续添加更多跟进
bash scripts/add-followup.sh "customer-uuid" "客户已提交内部评估报告，预计下周给到采购意向。"

客户360报告

生成报告

# 生成客户的360全景报告
bash scripts/generate-customer360.sh "customer-uuid"

注意：报告生成是异步过程，约需 1-2 分钟。立即返回后需等待，然后查询链接。

查询报告链接

# 查询报告是否已生成
bash scripts/get-customer360-url.sh "customer-uuid"
# 返回示例：
# { "customer_id": "...", "exists": true, "preview_url": "/reports/xxx.html" }

preview_url 为相对路径，在浏览器中访问 http://localhost:3001/reports/xxx.html 即可查看。

工作流程示例

# 1. 查询客户
bash scripts/query-customers.sh "$AISA_TEAM_ID" "招商银行"

# 2. 生成报告（异步）
bash scripts/generate-customer360.sh "customer-uuid"

# 3. 等待1-2分钟后查询链接
sleep 120
bash scripts/get-customer360-url.sh "customer-uuid"

客户背景资料管理

查看客户背景资料

# 获取客户完整信息（包含背景资料）
bash scripts/get-customer-info.sh "customer-uuid"

更新客户背景资料（增量更新）

支持三个字段的独立更新：

1. 更新客户背景资料

bash scripts/update-customer-profile.sh "customer-uuid" background "新的背景内容"

2. 更新决策链

bash scripts/update-customer-profile.sh "customer-uuid" decision "新的决策链信息"

3. 更新历史合作记录

bash scripts/update-customer-profile.sh "customer-uuid" history "新的历史记录"

工作流程示例

# 1. 查看客户当前背景资料
bash scripts/get-customer-info.sh "customer-uuid"

# 2. 更新客户背景（保留原有内容，追加新内容）
bash scripts/update-customer-profile.sh "customer-uuid" background "
## 新增背景信息
- 最近动态：完成了A轮融资
- 扩展计划：计划开拓华南市场
"

# 3. 更新决策链
bash scripts/update-customer-profile.sh "customer-uuid" decision "
## 新增决策人
3. **财务总监** - 王五
   - 负责预算审批
   - 关注投资回报率
"

# 4. 验证更新
bash scripts/get-customer-info.sh "customer-uuid"

注意：每次更新都会保留其他字段的内容，只更新指定的字段。

一键客户创建并执行技能链

quickcreate 完整执行一个客户开发流程：检查/创建客户 → 按顺序执行3个技能（等待每个完成后执行下一个）→ 生成360报告。

适用场景

• 新客户快速建档：输入公司名称，一步完成所有调研和分析
• 标准化客户开发：确保每次客户开发都经过完整的分析流程

执行流程

检查客户（按名称搜索）
    ↓ 存在 → 直接使用
    ↓ 不存在 → 创建客户（含AI调研，自动等待完成）
    ↓
执行 金融与国企客户深度研究（等待完成）
    ↓ 获取文档1
执行 需求挖掘分析（传入文档1，等待完成）
    ↓ 获取文档2
执行 高层拜访故事线（传入文档1+2，等待完成）
    ↓
生成客户360报告（等待完成）
    ↓
输出结果（客户ID、文档ID、360报告链接）

使用方式

cd ~/.openclaw/skills/winai
source scripts/config.sh
bash scripts/quickcreate.sh "招商银行" "金融"

参数说明

参数	说明	必填
客户名称	公司名称	是
行业	公司所属行业（可选）	否

返回信息

执行完成后输出：

• 客户ID：创建/查找到的客户 UUID
• 文档1：金融与国企客户深度研究产出的文档 ID
• 文档2：需求挖掘分析产出的文档 ID
• 360报告：报告访问 URL

耗时：整个流程约需 10-20 分钟（取决于AI执行速度），请耐心等待

注意

• 异步操作（创建客户、执行技能）立即返回，后台运行
• AI调研约2-3分钟，技能执行约30秒到数分钟，完成后用 get-latest-doc.sh 获取结果
• fullteam 不是有效的团队ID参数，需逐个查询