group-risk-analysis

Files (5)

• SKILL.md
• router_card.json
• group_risk_analysis_wrapper.py · scripts/
• sample_group_ids.txt · scripts/
• test_group_risk_analysis.sh · scripts/

SKILL.md (first lines)

# group-risk-analysis

## 能力定位

`group-risk-analysis` 是面向**号码集合**的群体级风险分析技能。

它不是单号码画像，也不是简单的 TopN 排序，而是把一组号码当成一个整体来做：

- 群体级统计
- 风险模式归纳
- 关系证据链整合
- 共享设备池识别
- 子群结构与群体形态判断
- 后续下钻建议

它面向电话网络数据场景，重点支持识别以下主要群体特征：

1. **高通话量型**
2. **夜间异常型**
3. **联系人广度异常型**
4. **共享设备型**

在基础能力之外，这个最终版还额外支持：

- **号码对关系证据链**：把共享设备、内部通话、共同对端三类证据并到一张关系矩阵里
- **群体形态判断**：输出更像“设备池型紧密群组”“联系人扩张型群组”等结论
- **过滤影响解释**：当 `risk_only`、`province`、`min_shared_device_count` 等过滤没有改变样本时，自动说明“样本同质性”
- **证据完整度与置信度**：告诉你当前群体分析链路是否完整，结论有多稳
- **更完整的附件导出**：markdown 报告 + 成员 CSV + 号码对 CSV + 设备证据 CSV + 共同对端 CSV

---

## 它解决什么问题

适合回答这类问题：

- 这批号码是不是一个明显的高风险群体？
- 这批号码主要是哪种风险特征更突出？
- 群体内部是否形成共享设备池？
- 群体内部是“设备驱动”还是“共同对端驱动”？
- 群体内部是否已经形成多个子群/小团体？
- 哪些号码最值得优先下钻？
- 当前过滤条件是否真的改变了群体分析对象？

---

## 输入方式

支持三种输入方式，至少提供一种：

### 方式 1：直接传号码列表
```bash
--phone-ids "号码1,号码2,号码3"
```

### 方式 2：传文本文件
```bash
--phone-id-file /path/to/group_ids.txt
```

文本文件要求：每行一个号码 ID。

### 方式 3：传 CSV 文件
```bash
--input-csv /path/to/input.csv --phone-id-column phone_id
```

---

## 主要参数

### 基础参数
- `--group-name`：群体名称，默认 `group`
- `--top-k`：报告里展示前多少个重点成员/设备/号码对/共同对端，默认 `10`
- `--pattern-min-members`：某类模式至少命中多少成员才算群体特征，默认 `2`

### 群体过滤参数
- `--risk-only`：只保留风险标签号码
- `--province sichuan`：只保留指定省份号码
- `--include-sub-labels risk,purefraud`：只保留这些 sub_label
- `--exclude-sub-labels whitelist,normal`：剔除这些 sub_label
- `--min-call-records 100`
- `--min-counterparties 50`
- `--min-shared-device-count 1`
- `--min-shared-peer-total 20`
- `--min-device-pool-count 2`

### 模式阈值参数
- `--high-call-threshold`：高通话量阈值（默认自动）
- `--broad-contact-threshold`：联系人广度阈值（默认自动）
- `--shared-peer-threshold`：共享设备牵出号码阈值（默认自动）
- `--shared-device-threshold`：共享设备数阈值，默认 `1`
- `--min-common-counterparty-members`：至少多少个群体成员共同接触某个对端才纳入“共同对端证据”，默认 `2`

### 夜间分析参数
- `--night-start-hour 22`
- `--night-end-hour 6`
- `--night-ratio-threshold 0.30`
- `--night-count-threshold 10`

---

## 输出内容

技能会输出：

### 1. 群体总体结论
- 群体规模
- 重点信号
- 群体形态判断
- 已识别主要群体特征
- 省份分布
- 标签分布
- 证据完整度与分析置信度

### 2. 过滤与样本影响说明
- 初始输入成员数
- 标签过滤后成员数
- sub_label 过滤后成员数

From bettercallfan/deerflow, MIT.

More from bettercallfan/deerflow