single-number-analysis

Files (4)

• SKILL.md
• router_card.json
• single_number_analysis_wrapper.py · scripts/
• test_single_number_analysis.sh · scripts/

SKILL.md (first lines)

# single-number-analysis

## 这个 skill 是做什么的

这个 skill 不是“子图抽取子技能”，而是一个 **完整的单号码综合分析 skill**。

它面向 **单个号码** 做下面几类事情：

1. 输出号码画像摘要
2. 从通话 / 设备 / 混合关系三个视角分析该号码
3. 评估关系圈规模，并区分“截断前 / 截断后”
4. 输出 Top 可疑节点排序
5. 输出共享设备主线索
6. 识别局部 Hub 和桥接点
7. 推荐下一步最值得下钻的节点
8. 自动生成 Markdown 报告并提供附件

---

## 什么时候优先使用它

当用户的问题属于下面这些类型时，应该优先使用本 skill：

- “帮我完整分析这个号码”
- “这个号码值不值得重点查”
- “围绕这个号码，谁最可疑”
- “这个号码的共享设备线索强不强”
- “输出这个号码的画像、关系圈规模、可疑节点和调查建议”
- “请生成 markdown 报告并给我下载”

### 不要误用成 subgraph-extraction-analysis 的情况

如果用户明确要求的是 **完整单号码综合分析**，就不要只调用子图技能。

也就是说：

- 要完整分析一个号码 → 用 `single-number-analysis`
- 只想抽 1 跳 / 2 跳局部图 → 用 `subgraph-extraction-analysis`

---

## 输入参数

### 必填参数

- `--phone-id`：目标号码 ID

### 可选参数

- `--hops`：关系圈跳数，默认 `2`
- `--max-nodes`：最多保留多少个关键节点，默认 `200`
- `--top-k`：输出多少个 Top 可疑节点，默认 `10`
- `--analysis-mode`：分析模式，可选 `mixed` / `call_only` / `device_only`，默认 `mixed`
- `--directed-call`：是否按有向通话图分析
- `--user-node-path`：号码画像表路径
- `--call-graph-path`：通话边表路径
- `--device-graph-path`：号码-设备边表路径
- `--source-col`：通话边源列名，默认 `src_user_id`
- `--target-col`：通话边目标列名，默认 `dst_counterparty_id`
- `--device-source-col`：设备边号码列名，默认 `user_id`
- `--device-target-col`：设备列名，默认 `imei`
- `--output-dir`：报告输出目录，默认 `/mnt/user-data/outputs`

---

## 输出内容

脚本输出 JSON，重点字段包括：

- `phone_profile`：号码画像摘要
- `analysis_view`：当前分析模式和参数
- `call_relation_analysis`：通话关系统计
- `shared_device_analysis`：共享设备统计与线索
- `subgraph_analysis`：关系圈规模、截断状态、结构边数统计
- `top_suspicious_nodes`：Top 可疑节点
- `key_roles`：局部 Hub / 局部桥接点
- `drilldown_seeds`：推荐二次下钻节点
- `human_summary`：一句话结论
- `investigation_next_steps`：下一步调查建议
- `report_path`：Markdown 报告路径
- `report_exists`：报告文件是否存在
- `artifacts`：前端可展示附件信息

---

## 特别说明：边数统计口径

本 skill 里会明确区分三类数字：

1. **原始通话记录数**
   - 按原始通话表逐条统计
   - 重复通话会重复计数

2. **设备关系投影次数**
   - 一台设备关联多个号码时，会被投影成多个号码对
   - 不同设备可重复贡献多次

3. **图去重边数**
   - 用于关系图展示和结构规模描述
   - 同一对号码只算一条结构边

所以如果你看到“原始记录数”和“图边数”不一样，属于正常现象，不是 bug。

---

## 命令行使用示例

### 示例 1：完整混合分析

```bash
cd /mnt/skills/custom/phone-network-analysis/single-number-analysis/scripts && python3 single_number_analysis_wrapper.py \
  --phone-id "<PHONE_ID>" \
  --hops 2 \
  --max-nodes 200 \
  --top-k 10 \
  --analysis-mode mixed
```

### 示例 2：仅通话 + 有向模式

From bettercallfan/deerflow, MIT.

More from bettercallfan/deerflow