Skill: legionspace-hackathon/legion-loan-outreach-insight (version 1.0.0)

--- name: legion-loan-outreach-insight description: >- 录音转写洞察：先 parse-user-intent 反问确认时间与维度，再 fetch 拉数；默认近 1 个月 + 十维；默认报告页面。 触发：对象词（含教练/coach）+ 动作词，或完整口令，或显式 intent。 --- # Legion Loan Outreach Insight ## 目标 拉取 **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 '{"userId":"u","orgId":"o","userMessage":"帮我总结录音"}' | \ node "{baseDir}/scripts/parse-user-intent.mjs" # 步骤 2：确认后拉数（token 仅来自 Header / LEGION_AUTH_TOKEN） export LEGION_AUTH_TOKEN="<JWT>" echo '{"userId":"u","orgId":"o","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 教练"` / `"股票趋势"` | 锁定维度或专题 | --- ## 触发词速查 **激活（其一）：** 对象词 + 动作词；[完整口令](#完整口令)；[REDACTED_SECRET]。 **动作词：** 总结、汇总、归纳、梳理、概括、小结、复盘、盘点、整合、整理、摘要、报告、结论（及英文同义，须配对象词）。 **对象词：** | 类别 | 中文 | 英文 | |------|------|------| | 录音 / 转写 | 录音、转写、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）。 --- ## 入站参数 ```json { "userId": "...", "orgId": "...", "userMessage": "用户原话（必填）", "followUpMessage": "可选，第二轮补充", "skipClarification": false, "confirmedTime": "default", "confirmedDimension": "default_ten" } ``` Header：`Authorization: Bearer {JWT}`（**禁止** body.token） --- ## 时间规则（`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. 拓客成效数据 每维：关键发现 / 典型摘录 / 量化指标 / 优化建议。 --- ## 错误与安全 - 缺 `userId` / `orgId` / `Authorization` → 不调 hardware - `needClarification` 时禁止编造数据 - 勿暴露 token、内网 IP/端口 - body `userId`/`orgId` 宜与 JWT 一致（建议网关校验） ## 检查清单 - [ ] 已跑 `parse-user-intent`；`needClarification` 时已反问且未 fetch - [ ] 默认时间/维度说明已写入报告（若适用） - [ ] `themeUnrelated` 时仅输出「无相关内容」 - [ ] 交付形态符合 `outputFormat` - [ ] 未使用 body.token


Security scan verdicts — ClawScan: clean | static analysis: suspicious | VirusTotal:  | SkillSpector: clean (LOW)