录音转写洞察:先 parse-user-intent 反问确认时间与维度,再 fetch 拉数;默认近 1 个月 + 十维;默认报告页面。 触发:对象词(含教练/coach)+ 动作词,或完整口令,或显式 intent=ai-coach-batch-session-summary。
---
name: ai-coach-batch-session-summary
description: >-
录音转写洞察:先 parse-user-intent 反问确认时间与维度,再 fetch 拉数;默认近 1 个月 + 十维;默认报告页面。
触发:对象词(含教练/coach)+ 动作词,或完整口令,或显式 intent=ai-coach-batch-session-summary。
---
# AI Coach Batch Session Summary
## 目标
拉取 **legion-hardware** 的 ASR 转写并生成报告。**仅依据 `asrText`**,禁止使用 `aiJiaolianResultJson` / `aiSummaryContent` 作为结论依据。
---
## 工作流程(必须按序,禁止跳步)
```text
1. parse-user-intent.mjs → 解析时间 / 维度 / 交付形态
2. needClarification=true → 反问用户,结束(禁止执行 fetch)
3. 用户补充或 skipClarification / confirmed* → 再执行 fetch-asr-recordings.mjs
4. 按 reportPlan + themeRelated + outputFormat 生成报告
```
**禁止只跑 `fetch-asr-recordings.mjs` 而不先意图解析**(fetch 内置相同解析,若需反问会直接 `ok:false` 且不拉数)。
### 脚本调用
```bash
# 步骤 1:意图(不拉数)
echo '{"user":"u","model":"openclaw:u123","userMessage":"帮我总结录音"}' | \
node "{baseDir}/scripts/parse-user-intent.mjs"
# 步骤 2:确认后拉数(token 仅来自 Header / LEGION_AUTH_TOKEN)
export LEGION_AUTH_TOKEN="<JWT>"
echo '{"user":"u","model":"openclaw:u123","userMessage":"总结最近 5 天录音","skipClarification":true}' | \
node "{baseDir}/scripts/fetch-asr-recordings.mjs"
```
### 默认值(反问后仍不明确,或用户说「按默认」)
| 项 | 默认 | 报告说明 |
|----|------|----------|
| 时间 | 近 **1** 个月 | 「未确认具体时间,已按默认最近 1 个月统计」 |
| 维度 | **十维拓客** | 「因未提取到明确的分析维度信息,已使用默认十维拓客统计框架处理」 |
---
## 反问沟通
`parse-user-intent` / `fetch` 在以下情况 **`needClarification: true`**:
| 信号 | 反问要点 |
|------|----------|
| `timeRange.confidence` = `ambiguous` | 几天 / 几周 / 几个月 |
| `timeRange.confidence` = `missing` | 统计窗口;不答则默认 1 个月 |
| `analysisFocus.confidence` = `ambiguous` | 拓客 / 话术 / 教练 / 客户需求 / 或默认十维 |
| `analysisFocus.confidence` = `missing` | 分析方向;不答则默认十维 |
**跳过反问:**
- 用户话术中「就按默认 / 你看着办 / 用默认」
- body:`skipClarification: true`(网关在用户回复后设置)
- body:`confirmedTime` / `confirmedDimension`(见下)
### 多轮合并 `userMessage`
网关将 **首轮 + 追问回复** 写入同一 body:
```json
{
"userMessage": "帮我总结录音",
"followUpMessage": "最近 5 天,按拓客复盘",
"skipClarification": true
}
```
或拼接为单字段 `userMessage`。脚本会合并 `userMessage` + `query` + `followUpMessage`。
### 网关确认字段(可选)
| 字段 | 示例 | 作用 |
|------|------|------|
| `skipClarification` | `true` | 不再反问,按解析结果或默认拉数 |
| `confirmedTime` | `"default"` 或 `{ "startTime":"...","endTime":"..." }` | 锁定时间窗 |
| `confirmedDimension` | `"default_ten"` / `"ten"` / `"AI 教练"` / `"股票趋势"` | 锁定维度或专题 |
---
## 触发词速查
**激活(其一):** 对象词 + 动作词;[完整口令](#完整口令);`intent=ai-coach-batch-session-summary`。
**动作词:** 总结、汇总、归纳、梳理、概括、小结、复盘、盘点、整合、整理、摘要、报告、结论(及英文同义,须配对象词)。
**对象词:**
| 类别 | 中文 | 英文 |
|------|------|------|
| 录音 / 转写 | 录音、转写、ASR | recording, transcript, ASR |
| 拓客 | 拓客、走访、地推 | outreach, field sales |
| 话术 / 客户 | 话术、客户拜访 | pitch, script, customer visit |
| **教练** | 教练、AI 教练、教练反馈、教练点评 | coach, coaching, AI coach, coach feedback |
| 系统 | legion-hardware | legion, hardware |
### 完整口令
- 总结最近 5 天录音
- 十维拓客报告
- 总结一下教练反馈
- AI coach recap for last month
**不触发:** 仅「总结一下」无对象词;**仅**调用 `POST /api/recordings/ai-jiaolian` 且无话术总结类动作词(走 AI 教练单次能力,不走本 skill)。
---
## 入站参数(OpenClaw / 网关)
```json
{
"user": "OpenClaw 用户标识(必填,映射为 hardware userId)",
"model": "openclaw:{user}{orgId} 或 openclaw:{user}person",
"userMessage": "用户原话(必填,可在 metadata)",
"followUpMessage": "可选,第二轮补充",
"skipClarification": false,
"confirmedTime": "default",
"confirmedDimension": "default_ten",
"orgId": "可选;网关已从 model 解析时可直传"
}
```
Header:`Authorization: Bearer {JWT}`(**禁止** body.token)
### userId / orgId 取值(`resolve-openclaw-identity.mjs`)
与 tfd-api `AiService` 的 model 组装一致:
| model 形态 | 含义 | hardware 调用 |
|------------|------|-----------------|
| `openclaw:{user}{orgId}` | 组织上下文 | `userId=user`,`orgId` 为去掉前缀 `openclaw:{user}` 后的后缀 |
| `openclaw:{user}person` | 个人上下文 | `userId=user`,**不传 orgId**(或为空) |
规则:
1. **userId** = 请求体字段 **`user`**(兼容 `userId`)。
2. **model 以 `person` 结尾**(不区分大小写)→ 个人模式,**不传 orgId**。
3. **model 非 person** → `orgId = model` 去掉前缀 `openclaw:` + `user` 后的剩余部分。
4. 若 body 已带非空 **`orgId`**(如网关 metadata)→ 优先使用,不再从 model 解析。
5. 若 body 显式 `orgId: ""` → 视为个人模式。
示例(`user=abc`):
| model | orgId(查询) |
|-------|----------------|
| `openclaw:abc123` | `123` |
| `openclaw:abcperson` | 不传(个人) |
| `openclaw:abc` | 不传(后缀为空) |
---
## 时间规则(`parse-time-range.mjs`)
| 表述 | confidence | 行为 |
|------|------------|------|
| 最近 5 天 / 近 2 个月 | explicit | 按解析查询 |
| 最近 / 近期(无数字) | ambiguous | 先反问 |
| 无时间 | missing | 先反问 |
| 反问后仍无 | default | 近 **1** 个月 |
时区 `Asia/Shanghai`;上限:月 ≤12,天 ≤366。
---
## 维度与报告分支
| 条件 | 输出 |
|------|------|
| 无显式专题(走十维) | 十维拓客报告 + 默认维度说明(若适用) |
| 用户明确「十维 / 默认十维」 | 十维(无需「未提取维度」说明) |
| 显式专题且 `themeRelated=true` | 仅 `## 用户关注:{主题}` |
| 显式专题且 `themeRelated=false` | **仅**:`## 分析结果` → **无相关内容**(禁止十维、禁止编造) |
`themeRelated` 由脚本用 **主题核心词** 匹配 `asrText`(已避免单独「KYC」「趋势」误命中)。
### 样本量
| recordCount | 处理 |
|-------------|------|
| `0` | 十维骨架或专题内写明「样本为空」 |
| `< 5` | 标注「小样本,结论仅供参考」 |
| `> 80`(默认) | 见 stdout `recordsHint`,分析时优先近期并抽样 |
---
## 数据拉取与部署
| 项 | 说明 |
|----|------|
| 默认 baseUrl | `http://192.168.109.50:8900`(`LEGION_HARDWARE_BASE_URL` 可覆盖) |
| 接口 | `GET` 或 `POST` `/api/recordings/asr-completed` + `startTime`/`endTime` |
| **部署** | 须 **新 jar**(POST 支持 body 内时间);旧版 POST 仅 3 个月固定窗,自定义时间会失效 |
fetch 成功时 stdout 含:`query`、`analysisFocus`、`themeRelated`、`reportPlan`、`outputFormat`、`records[]`。
---
## 交付形态(`outputFormat`)
| mode | 行为 |
|------|------|
| `page`(默认) | 按 `templates/insight-report-page.md` 生成**完整报告页**(Markdown/HTML) |
| `text` | 用户要求「只要文字/不要页面」 |
| `custom` | 用户要求导出/邮件等,**从其要求** |
---
## 十维拓客(默认维度)
1. 拓客场景 2. 触达人群 3. 开口获客话术 4. 客户需求 5. 客户拒绝原因
6. 有效意向分类 7. 产品匹配 8. 成交阻碍痛点 9. 跟进动作 10. 拓客成效数据
每维:关键发现 / 典型摘录 / 量化指标 / 优化建议。
---
## 错误与安全
- 缺 `user` / `Authorization` → 不调 hardware;个人模式可无 `orgId`
- `needClarification` 时禁止编造数据
- 勿暴露 token、内网 IP/端口
- `user` / 解析出的 `orgId` 宜与业务身份一致(建议网关校验)
## 检查清单
- [ ] 已跑 `parse-user-intent`;`needClarification` 时已反问且未 fetch
- [ ] 默认时间/维度说明已写入报告(若适用)
- [ ] `themeUnrelated` 时仅输出「无相关内容」
- [ ] 交付形态符合 `outputFormat`
- [ ] 未使用 body.token
- [ ] `user` / `model` 已按规则解析;`person` 模式未传 orgId
don't have the plugin yet? install it then click "run inline in claude" again.