agentCLAWHUBUnverified
SS需求→Teambition任务
从 SaleSmartly 客服会话中自动采集带标签的对话，经 AI 分析提取需求，创建 Teambition 任务。用于客服反馈→需求管理自动化。触发词：SS需求采集、客服需求整理、SaleSmartly会话转任务、聊天记录转需求、客户反馈建任务、采集会话创建TB任务。当用户想把 SaleSmartly 中的客... Skill: SS需求→Teambition任务 Owner: zpeng6834-arch Summary: 从 SaleSmartly 客服会话中自动采集带标签的对话，经 AI 分析提取需求，创建 Teambition 任务。用于客服反馈→需求管理自动化。触发词：SS需求采集、客服需求整理、SaleSmartly会话转任务、聊天记录转需求、客户反馈建任务、采集会话创建TB任务。当用户想把 SaleSmartly 中的客... Tags: latest:1.0.4 Version history: v1.0.4 | 2026-07-09T12:59:43.655Z | user 新增SS平台功能明确排除清单（素材库/话术库/渠道管理等），防止非AI需求误入HK项目；修复#638类误建 v1.0.3 | 2026-07-09T11:52:29.447Z | user config.json 移至工作区根目录 ss_config.
OpenClaw
Rank
62
Safety
84
Downloads
1.5k
Updated
Oct 10, 2026
Version
1.0.4
Source
CLAWHUB
About
What it does, and when to use it.
Capability contract not published. No trust telemetry is available yet. 1.5K downloads reported by the source. Last updated 10/10/2026.
Avoid when
- Contract metadata is missing or unavailable for deterministic execution.
Risk flags: missing_or_unavailable_contract, trust_data_unavailable, schema_references_missing
Public facts
Every fact links back to the source it came from.
- Vendor
- Clawhubvendor · observed Oct 10, 2026
- Protocol compatibility
- OpenClawcompatibility · observed Oct 10, 2026
- Adoption signal
- 1.5K downloadsadoption · observed Oct 10, 2026
- Latest release
- 1.0.4release · observed Jul 9, 2026
- Handshake status
- UNKNOWNsecurity
Install and run
Setup complexity: low.
clawhub skill install s17bz6sf0msd2h2zewdmwaey1x86ky9c:ss-requirements-to-teambition- Setup complexity is LOW. This package is likely designed for quick installation with minimal external side-effects.
- Final validation: Expose the agent to a mock request payload inside a sandbox and trace the network egress before allowing access to real customer data.
Contract: missing
curl -s "https://www.xpersona.co/api/v1/agents/clawhub-zpeng6834-arch-ss-requirements-to-teambition/snapshot"
Documentation
CLAWHUB
74,480 characters of source documentation, loaded on request.
Extracted files
5 files captured from the source.
SKILL.md
---
name: ss-requirements-to-teambition
description: 从 SaleSmartly 客服会话中自动采集带标签的对话，经 AI 分析提取需求，创建 Teambition 任务。用于客服反馈→需求管理自动化。触发词：SS需求采集、客服需求整理、SaleSmartly会话转任务、聊天记录转需求、客户反馈建任务、采集会话创建TB任务。当用户想把 SaleSmartly 中的客户会话整理成 Teambition 需求任务时使用。
---
# SS Requirements → Teambition
从 SaleSmartly 客服会话中采集对话 → AI 分析提取需求 → 自动创建 Teambition 任务。
## 前置条件
1. **SaleSmartly API Key** — SS 后台 → 设置 → API 管理
2. **Teambition MCP** — 见 [tb_mcp_setup.md](references/tb_mcp_setup.md)
## 快速开始
### 1. 配置
```bash
cp scripts/config.example.json scripts/config.json
```
编辑 `scripts/config.json`，填入你的配置。各字段含义和获取方式见 [config_fields.md](references/config_fields.md)。
### 2. 采集数据（纯脚本，0 token）
```bash
cd scripts && python3 collect.py
```
输出：`scripts/data/ss_sessions_YYYY-MM-DD.json`
### 3. AI 分析 + 创建任务
对 AI 说：「读取 `scripts/data/` 下最新的 JSON，分析会话内容，按 config.json 配置创建 TB 任务」
AI 会按 [analysis_template.md](references/analysis_template.md) 中的规则执行。
## 定时自动化（可选）
在 OpenClaw 中配置 cron：
```json
{
"schedule": { "kind": "cron", "expr": "0 10 * * *", "tz": "Asia/Shanghai" },
"sessionTarget": "isolated",
"payload": {
"kind": "agentTurn",
"message": "执行 SS 需求采集：1) cd scripts && python3 collect.py 2) 读取 data/ 下最新 JSON 3) 按 config.json 配置分析并创建 TB 任务"
}
}
```
## 文件结构
```
scripts/
├── collect.py # 数据采集（0 token）
├── config.example.json # 配置模板
└── config.json # 你的配置（不入库）
references/
├── tb_mcp_setup.md # TB MCP 配置指南
├── config_fields.md # 配置项获取指南
└── analysis_template.md # AI 分析 + 任务创建模板
```
## 关键约束
- SS API 限流 10 QPS，脚本内置 200ms 间隔
- 增量采集：`state.json` 记录上次时间戳，下次从该点开始
- 创建任务前先查重，避免同一会话重复建任务
- 数据文件保留 7 天自动清理_meta.json
{
"ownerId": "kn75b1bc3z67ej9wt7n1s70z8n86ka37",
"slug": "ss-requirements-to-teambition",
"version": "1.0.4",
"publishedAt": 1783601983655
}references/analysis_template.md
# AI 分析 + 任务创建模板
## ⚠️ 核心分类方法论（先读这个）
所有进入分析的会话都已被打上「HelpKnow需求」或「AI员工」标签，**标签本身就是 AI 相关性保证**。不要因为会话后半段出现了 SS 平台话题（如导出、套餐、版本）就整条判为非 AI 相关。
### 三层分类（一个会话可同时产出多类）
| 层级 | 判断标准 | 产出 | 示例 |
|------|---------|------|------|
| ✅ FAQ/已解决 | 客服给出有效答案，客户确认理解 → 该条不建单 | 过滤 | 「AI怎么发PDF？」→ 客服教了，客户说OK |
| 🐛 BUG | 功能异常、设置不生效、客服说「反馈技术排查」**或仍在排查中未解决** | 建 BUG | 人设禁止词不生效、离线AI还在发消息、AI转人工配置了但不执行 |
| 🆕 需求 | 客户要的功能不存在、客服说「不支持/没有」→ 不管后面有没有 FAQ 部分，功能缺失就是需求 | 建需求 | 「AI能主动回访吗？」→ 客服说不支持 |
**关键规则**：
- **一个会话可以同时产出 BUG + 需求**，不是二选一
- **标签保证**：有标签 → 必有 AI 相关内容，不要整条过滤
- **SS 平台讨论不覆盖 AI 需求**：客户在问 AI 功能的同时问了 SS 平台功能，不能因为后者存在就把 AI 需求也过滤掉
- **「不支持」= 需求信号**：客服回复功能不支持、做不到、没有 → 这就是产品需要补齐的能力
- **「未解决」= 必须建单**：客户描述了明确的功能异常现象（如「配置了转人工但没转」「设置了但没生效」），即使客服回复「在排查/需授权/等技术确认」，只要问题未当场解决，就必须建 BUG。客服没解决 ≠ 没问题
## 🔗 上下文会话（新增）
ctx JSON 中每个锚点会话可能带有 `context` 字段，包含同一客户在时间窗口内的相邻会话（前 2 后 1，按 `before_2`/`before_1`/`after_1` 标记）。
**分析规则**：
- **锚点会话是主数据源**：任务创建、session_id 填写均以锚点为准
- **上下文会话是辅助信息**：帮助理解客户问题的完整背景（如之前的机器人对话、初次尝试过程）
- **典型场景**：
- 上下文是机器人接待（agent=系统）→ 客户在上下文里描述过问题，在锚点里说「还是不行」→ 合并理解，不要因为锚点里问题描述不完整就判为信息不足
- 上下文是同客户多次转人工 → 看前面客服有没有交代背景，避免重复建单
- **上下文会话不独立建单**：只用于辅助理解锚点会话，不要在 TB 中为上下文会话单独创建任务
- **备注中引用**：如果上下文提供了关键信息（客户早期原话、尝试过的步骤），在 note 的「需求详情」中注明来源（如「客户在前序会话 [session_id] 中提到…」）
## 字段配置(已确认)
| 字段名 | cfId | 类型 |
|--------|------|------|
| 需求orBUG | `69df253e95d7ece67f2d6e94` | 单选 |
| SS客服沟通会话ID | `69df25e800b8437a49b4840e` | 文本 |
| SS客户名称 | `6a1422a4f4593ff6edd1ee63` | 文本 |
| HK项目ID | `69e055b3f2ad64465068810e` | 文本 |
> ⚠️ TQL 不支持按 `SS客户名称` 字段过滤,因此查重时先拉所有未完成任务(`isDone = false`),再在内存中按该字段匹配。
---
## 分析流程
1. 读取 `scripts/data/` 下最新的 JSON 文件
2. 对每个会话,先拆分出 N 个独立的 demand
3. 对每个 demand:
- 拉取所有「未完成」TB 任务(`isDone = false`)
- 在内存中按 `SS客户名称` 字段匹配
- 按内容相似性判断合并/新建
- 执行对应操作
---
## 🚫 强力红线(拦截机制与强制提取)
在需求拆分(第一步)和执行操作(第三步)时,必须严格执行以下红线,违反任一条禁止建单或输出:
1. **【纯答疑/已解决】严格拦截**:
- 必须仔细分析客服的消息。如果客户只是在咨询功能原理、机制、操作方法,且客服已经给予了明确解答、客户表示理解或问题已正常解决,**严禁新建任何 Teambition 任务**。
- **除非**满足以下任一条件:
- 客服明确承认是功能缺陷
- 客服承诺了未来要排期优化
- 客服明确表示"我们去提个需求/反馈给研发"
- **客服明确回复功能不支持/不可以/做不到/暂未开放**——功能缺失本身就是需求，不能因客服给出否定结论就拦截。这是产研需要补齐的能力。
- **⚠️ 客户接受判定（通用拦截）**：以下情况**即使满足上述任一建单条件，也必须拦截，禁止建单**：
- 客服承认限制后给出了**有效的变通方案**（如「可以用XX功能替代」「试试YY方式」），且客户明接受/满意（「好的谢谢」「明白了」「那也行」等）。——此类会话已闭环，无需建单。
- 判断关键：客服是否提供了可操作的替代方案 → 客户是否认可。只有「客服说做不到且无替代方案」或「客户不接受替代方案」时才建单。
- 咨询类问题仅在需要沉淀为文档/FAQ时，由人工手动整理，不允许自动化需求系统建单。
3. **【非 AI 相关需求禁止建单】**：
- SaleSmartly 平台自身的功能（自动化工作流配置、通讯录/号码管理、权限角色设置、测试沙箱等），只要跟 HelpKnow AI 员工没有直接关系，**禁止在 HelpKnow 需求项目中创建任务**。
- 判断标准：这个需求/问题是 AI 员工的行为逻辑有问题、AI 员工缺失某项能力、还是单纯是 SaleSmartly 平台的操作/功能问题？只有前者可以建单。
- 如果客服确认平台暂时没有某个功能，但该功能与 AI 无关，也不属于可建单范围。
- **⚠️ SS 平台功能明确排除清单**：以下 SS 平台功能即使被打上「AI员工」标签，也**必须拦截，禁止建单**：
- **素材库**：文件夹管理、素材上传/下载/分类 → 属于 SS 平台文件管理，非 HK AI 能力
- **话术库**（非 AI 话术部分）：话术模板编辑、话术分类 → 属于 SS 平台内容管理
- **渠道管理**：WhatsApp/Facebook/Telegram 等渠道的接入和配置
- **自动化规则/工作流**：非 AI 相关的自动回复、分配规则
- **其他 SS 平台操作**：套餐升级、导出限制、权限设置、号码管理等
- **⚠️ 混合会话处理**：当会话中同时讨references/config_fields.md
# 配置项获取指南 ## SaleSmartly 配置 ### API Key SS 后台 → 设置 → API 管理 → 创建/查看 API Key ### Project ID SS 后台 URL 中的数字，如 `https://xxx.salesmartly.com/project/1/...` 中的 `1` ### 标签 ID SS 后台 → 设置 → 会话标签 → 点击标签，URL 中可见 tagId ### 自定义字段 Key SS 后台 → 客户 → 自定义字段 → 查看字段名称（如"项目ID"），填入 `customFieldKey` --- ## Teambition 配置 ### projectId 打开 TB 项目 → URL 中 `projectId=xxx` 或 `/project/xxx` 的部分 ### sfcId（任务类型 ID） TB 项目 → 项目设置 → 任务类型 → 点击类型，URL 中可见 sfcId ### stageId（任务列表 ID） TB 项目看板 → 点击目标列的列头设置 → URL 中可见 stageId ### 自定义字段 ID（cfId） TB 项目 → 项目设置 → 自定义字段 → 点击字段，URL 中可见 cfId ### 自定义字段值 ID（valueId） 对于单选/多选字段，在自定义字段设置中点击选项，URL 中可见 valueId --- ## 快速获取技巧 如果不想手动找 ID，可以直接对 AI 说： > 「帮我查一下 TB 项目『XXX』的任务类型有哪些，列出 sfcId」 > 「帮我查一下 TB 项目『XXX』的自定义字段有哪些，列出 cfId」 AI 会通过 MCP 工具帮你查。
references/execution_guide.md
# HK 需求采集 — AI 执行指南
## 数据文件
路径：`scripts/hk_需求/data/hk_需求_YYYY-MM-DD.json`
```json
{
"sessions": [
{
"session_id": "jgdxgrv",
"customer_name": "HelpKnow.ai 服务群",
"ss_project_id": "27828",
"messages": [
{
"sender_type": 1, // 1=客户, 2=客服
"sender": "xxx", // sys_user_id（客服时用）
"text": "客户消息内容",
"send_time": 1748054400000 // 毫秒时间戳
}
]
}
]
}
```
---
## 客服姓名映射
路径：`scripts/hk_需求/agent_names.json`
```json
{
"uid_to_real": {
"187751": "游鸿凯",
"975520": "张梦非",
...
}
}
```
接待客服真实姓名从 `uid_to_real` 查 `sender`（sys_user_id）。
---
## TB 任务创建
**调用**：`teambition-mcp__createTaskV3`
### 标准 note 格式（参考 TB#789-296）
```
## 涉及客户
[客户名称] | SS项目ID: [ss_project_id]
## 客户业务场景
[客户背景、当前使用情况]
## 需求详情
1. **问题一标题**：问题描述。客户原话。客服处理结果。
2. **问题二标题**：问题描述。客户原话。客服处理结果。
## 会话信息
- SS会话ID: [session_id]
- 接待客服: [真实姓名]
- 时间: [YYYY-MM-DD]
- 标签: [标签名]
```
### 示例
```json
{
"projectId": "6959d07f4991ad9a71ca2afa",
"scenariofieldconfigId": "6959d080d242a000e6f0de59",
"stageId": "69fed981a6333372a4b12b72",
"content": "[27828] 新建AI员工时找不到首次创建时的4种角色预设人设模板",
"note": "## 涉及客户\nHelpKnow.ai 服务群 项目ID:27828 | SS项目ID: 568206,624697\n\n## 客户业务场景\n客户在HelpKnow服务群中咨询AI员工功能。客户首次创建AI员工时有4种角色模板（含预设提示词），但第二次创建时找不到这些预设模板，导致需要手动编写完整人设，体验不佳。\n\n## 需求详情\n1. **预设角色模板消失**：客户反馈\"我刚刚创建第一个AI员工的时候，好像有4种角色可以选，里面自带了提示词。现在找不到了\"。客服确认第一个是旧版AI机器人（旧版回复AI员工），新版AI员工没有预设角色模板。\n2. **旧版机器人用途**：客户询问旧版机器人是否还有用。客服建议使用新版AI员工回复，旧版已不推荐使用。\n3. **人设需要手动编写**：客户表示新创建的AI员工人设要自己写，\"我又懒得写\"。客服建议编辑之前的AI员工复制人设内容。客户反馈之前没有创建成功，所以没有可复制的内容。客服建议在旧版机器人的设置中查看是否有人设内容。\n\n## 会话信息\n- SS会话ID: jgdxgrv\n- 接待客服: 游鸿凯\n- 时间: 2026-05-23\n- 标签: HelpKnow需求",
"customfields": [
{
"customfieldName": "需求orBUG",
"value": [{"id": "69df253e95d7ece67f2d6e95", "title": "需求"}]
},
{
"cfId": "69df25e800b8437a49b4840e",
"value": [{"title": "jgdxgrv"}]
},
{
"cfId": "6a1422a4f4593ff6edd1ee63",
"value": [{"title": "HelpKnow.ai 服务群 项目ID:27828"}]
},
{
"cfId": "69e055b3f2ad64465068810e",
"value": [{"title": "27828"}]
}
]
}
```
**字段填写规范**：
- `需求orBUG`：单选，用 `customfieldName` + `value.id`
- 文本字段（会话ID/客户名称/项目ID）：用 `cfId` + `value.title`
---
## TB 追加备注
**调用**：`teambition-mcp__updateTaskNoteV3`
追加格式（接在原 note 内容后）：
```
——更新 [时间]（session: [session_id]，客服：[接待客服真实姓名]）——
[本次新增的需求详情]
---
[原有 note 完整保留]
```
**操作**：先 `queryTaskV3` 读出原 note，再拼接，最后 `updateTaskNoteV3` 整体写入。
---
## 搜索未完成任务
**调用**：`teambition-mcp__searchProjectTasksV3`
```
projectId: 6959d07f4991ad9a71ca2afa
q: stageId = "69fed981a6333372a4b12b72"
pageSize: 100
```
返回后内存过滤 `isDone = false`。
---
## 读取任务备注
**调用**：`teambition-mcp__queryTaskV3`
```
shortIds: "789-296"
```
返回的 `result[0].note` 即为当前备注内容。
---
## 执行流程
```
1. 读取 scripts/hk_需求/data/analysis_context.json
2. 对每个会话：
a. 完整读取客户消息，分析是否有实质需求
b. 搜索 TB 未完成任务（按 stageId 拉，内存过滤 isDone）
c. 按 customer_name 过滤已有任务
d. 各 demand 逐一判断：
- Github ReposUpdated 17h agoRank 70
AionUi
Free, local, open-source 24/7 Cowork app and OpenClaw for Gemini CLI, Claude Code, Codex, OpenCode, Qwen Code, Goose CLI, Auggie, and more | 🌟 Star if you like it!
MCPOPENCLAW
Github ReposUpdated 6mo agoRank 70
activepieces
AI Agents & MCPs & AI Workflow Automation • (~400 MCP servers for AI agents) • AI Automation / AI Agent with MCPs • AI Workflows & AI Agents • MCPs for AI Agents
OPENCLAW
Github ReposUpdated 6mo agoRank 70
cherry-studio
AI productivity studio with smart chat, autonomous agents, and 300+ assistants.
MCPOPENCLAW
Github ReposUpdated 7mo agoRank 70
CopilotKit
The Frontend for Agents & Generative UI. React + Angular
OPENCLAW
Machine-readable data
The same record, as JSON, for agents and crawlers.
{
"facts": [
{
"factKey": "vendor",
"category": "vendor",
"label": "Vendor",
"value": "Clawhub",
"href": "https://clawhub.ai/zpeng6834-arch/skills/ss-requirements-to-teambition",
"sourceUrl": "https://clawhub.ai/zpeng6834-arch/skills/ss-requirements-to-teambition",
"sourceType": "profile",
"confidence": "medium",
"observedAt": "2026-10-10T11:21:40.713Z",
"isPublic": true
},
{
"factKey": "protocols",
"category": "compatibility",
"label": "Protocol compatibility",
"value": "OpenClaw",
"href": "https://www.xpersona.co/api/v1/agents/clawhub-zpeng6834-arch-ss-requirements-to-teambition/contract",
"sourceUrl": "https://www.xpersona.co/api/v1/agents/clawhub-zpeng6834-arch-ss-requirements-to-teambition/contract",
"sourceType": "contract",
"confidence": "medium",
"observedAt": "2026-10-10T11:21:40.713Z",
"isPublic": true
},
{
"factKey": "traction",
"category": "adoption",
"label": "Adoption signal",
"value": "1.5K downloads",
"href": "https://clawhub.ai/zpeng6834-arch/ss-requirements-to-teambition",
"sourceUrl": "https://clawhub.ai/zpeng6834-arch/ss-requirements-to-teambition",
"sourceType": "profile",
"confidence": "medium",
"observedAt": "2026-10-10T11:21:40.713Z",
"isPublic": true
},
{
"factKey": "latest_release",
"category": "release",
"label": "Latest release",
"value": "1.0.4",
"href": "https://clawhub.ai/zpeng6834-arch/ss-requirements-to-teambition",
"sourceUrl": "https://clawhub.ai/zpeng6834-arch/ss-requirements-to-teambition",
"sourceType": "release",
"confidence": "medium",
"observedAt": "2026-07-09T12:59:43.655Z",
"isPublic": true
},
{
"factKey": "handshake_status",
"category": "security",
"label": "Handshake status",
"value": "UNKNOWN",
"href": "https://www.xpersona.co/api/v1/agents/clawhub-zpeng6834-arch-ss-requirements-to-teambition/trust",
"sourceUrl": "https://www.xpersona.co/api/v1/agents/clawhub-zpeng6834-arch-ss-requirements-to-teambition/trust",
"sourceType": "trust",
"confidence": "medium",
"observedAt": null,
"isPublic": true
}
],
"events": [
{
"eventType": "release",
"title": "Release 1.0.4",
"description": "新增SS平台功能明确排除清单（素材库/话术库/渠道管理等），防止非AI需求误入HK项目；修复#638类误建",
"href": "https://clawhub.ai/zpeng6834-arch/ss-requirements-to-teambition",
"sourceUrl": "https://clawhub.ai/zpeng6834-arch/ss-requirements-to-teambition",
"sourceType": "release",
"confidence": "medium",
"observedAt": "2026-07-09T12:59:43.655Z",
"isPublic": true
}
]
}Record generated Oct 10, 2026.