| name | geopolitical-elite-mapping |
| version | 1.0.0 |
| description | 地缘政治精英网络图谱工具。适用于分析特定议题下的精英集团/派系网络(政治派系、财阀、军工集团、资源控制方),通过系统性调研构建利益关系网络,输出带置信度编码的交互式 HTML 图谱查看器 + 文字分析报告。触发词:「地缘政治图谱」「精英网络」「elite network」「geopolitical mapping」「权力网络分析」。 |
Geopolitical Elite Network Mapping Skill (v1.0.0)
Overview
系统性生成指定地缘政治议题下的精英网络图谱。通过 6 个阶段的工作流,完成议题框架确认、行为体发现、关系网络调研、置信度审计、可视化输出和分析报告生成。
核心特点:
- 🔒 强制议题确认:每次运行前必须与用户确认议题范围、时间范围、分析粒度,确认后才开始调研
- 🎯 强制置信度标注:所有节点和边必须标注 HIGH/MED/LOW/INFERRED,置信度编码进图谱视觉本身(边的粗细/虚实、节点边框样式)
- 🌐 多层关系建模:主边(利益关系:贸易投资、战争冲突、资源控制)+ 注释层(条约框架、思想谱系)
- 📊 叙事竞争意识:地缘政治数据不透明、存在叙事竞争,没有 ground truth,置信度标注是诚实性的核心保障
When to Use
当用户需要对一个地缘政治议题进行精英网络分析时使用:
- "分析中东石油地缘政治中的关键势力网络"
- "冷战时期军工复合体的精英图谱"
- "印太地区安全同盟网络分析"
- "全球稀土供应链的权力网络"
不适用:纯历史事件叙述(无网络结构)。
输入与输出
输入
用户提供一个地缘政治议题关键词或描述:"中东石油地缘政治" / "印太安全同盟" / "全球半导体供应链权力博弈"
输出
output/[Topic]_EliteNetwork_Viewer.html — 交互式图谱查看器(置信度编码进视觉,内置纪元筛选器)
output/[Topic]_EliteNetwork_Report.md — 文字分析报告(行为体简介 + 置信度审计表 + 关系验证 + 分析结论)
generate_elite_network.py — 图谱生成脚本(可复现、可迭代修改)
数据 Schema
节点类型表、边类型表、置信度规则详见 data_schema.md
四级置信度系统(判定标准 + 证据要求 + 视觉编码)详见 confidence_spec.md
可视化节点配色/边样式/置信度视觉编码/Legend 规范详见 visual_spec.md
关系类型判定标准 + 边界案例详见 relation_types.md
地缘政治分析框架详见 analysis_framework.md
搜索工具选择规范
在任何需要执行网页搜索的步骤中,按以下流程选择工具:
1. 尝试调用 tavily-search 技能
2. IF tavily-search 调用成功 → 使用结果
3. IF tavily-search 未安装 OR 调用报错(ImportError / HTTP 错误 / 超时):
→ 记录降级原因
→ 调用系统原生 search_web 工具(相同 query)
→ 使用 search_web 结果
4. IF search_web 也失败 → 标记该搜索步骤为「未完成」,继续下一步
执行工作流
[!CAUTION]
严格按照 Phase 0 → 1 → 2 → 3 → 4 → 5 的顺序执行。每个 Phase 完成后,在内部检查输出质量,再进入下一个 Phase。
[!CAUTION]
强制机制 #1:Phase 0 未经用户明确确认,禁止进入 Phase 1。
强制机制 #2:Phase 3 中,任何无置信度标注的节点/边将被拒绝进入 Phase 4。
Phase 0: 议题确认 & 分析框架生成 🔒
目的:理解用户需求,与用户确认分析的精确边界,生成定制化的分析框架。
[!CAUTION]
⛔ 强制机制:本 Phase 必须与用户完成至少一轮确认交互。禁止跳过。禁止自行假设议题边界。
步骤:
-
议题解析:基于用户输入,分析以下维度并生成 issue_profile 草案:
{
"issue": "中东石油地缘政治",
"scope": {
"geographic": ["中东", "波斯湾", "北非"],
"thematic": ["石油定价权", "运输通道控制", "产油国联盟"],
"excluded": ["南美石油", "天然气(除非直接相关)"]
},
"time_range": {
"start": "1973(石油危机)",
"end": "2025",
"focus_period": "2010-2025(重点关注)"
},
"granularity": {
"level": "faction",
"description": "以国家级派系/集团为主要节点,关键个人作为辅助标注",
"expected_node_count": "20-40"
},
"known_anchor_actors": [
"OPEC", "沙特王室(MBS 派系)", "美国页岩油集团",
"俄罗斯能源集团", "伊朗革命卫队经济体系"
],
"narrative_competition": [
"\"石油武器\"叙事 vs \"市场驱动\"叙事",
"\"什叶vs逊尼\" vs \"民族国家利益\"框架"
],
"data_opacity_warning": [
"沙特内部派系关系不透明",
"伊朗革命卫队经济活动数据有限",
"非公开军售关系"
],
"search_templates": {
"actor_discovery": "[议题] key actors stakeholders power brokers",
"relation_discovery": "[actor A] [actor B] trade investment conflict alliance",
"treaty_discovery": "[议题] treaty agreement pact framework",
"ideology_discovery": "[议题] ideology doctrine school of thought influence"
}
}
-
与用户确认 ⛔(强制,不可跳过):
- 展示
issue_profile 摘要
- 必须明确询问并等待用户回答以下四个问题:
- 议题范围是否正确?是否有需要排除或新增的地理/主题范围?
- 时间范围是否合适?重点关注时段是否正确?
- 分析粒度(国家级 / 派系级 / 个人级)是否符合需求?
- 锚点行为体列表是否需要补充或修改?
- ⚠️ 用户未回复前,禁止进入 Phase 1
-
根据用户反馈修正 issue_profile:如用户要求修改,更新后再次确认。
-
纪元划分确认 ⚠️:基于议题时间范围,向用户提议 3-5 个关键纪元划分,并确认:
- 纪元数量和分界年份是否合适?
- 每个纪元的标签/描述是否准确?
- 用户是否有特定关注的纪元转折点?
Phase 0 交付物:issue_profile(议题框架 + 纪元划分方案 + 搜索策略 + 锚点列表),经用户明确确认。
Phase 1: 行为体发现 (Actor Discovery)
目的:系统性发现议题相关的核心精英集团、派系和关键行为体。
步骤:
-
搜索核心国家行为体:使用 search_templates.actor_discovery,查找议题中的关键国家及其内部权力派系。
- ⚠️ 不仅关注国家整体,更关注国家内部的权力派系和利益集团
-
搜索非国家行为体:
- 跨国企业/财阀集团(能源巨头、军工企业、金融集团)
- 国际组织(联合国机构、区域组织、同盟体系)
- 非正规行为体(代理武装、游说集团、智库影响网络)
-
搜索关键人物:掌握决策权的核心个人(国家领导人、企业领袖、军事指挥官)。
- ⚠️ 关键人物作为辅助标注附属于其所属的集团/派系节点,一般不单独成为主节点
- 例外:如果某人本身就是一个权力中心(如 MBS),可以单独成为节点
-
搜索思想/意识形态节点:影响议题走向的意识形态和理论框架。
-
构建时间线:提取议题中的 3-7 个关键转折点/事件年份。
-
Wikidata 辅助查询:使用 scripts/wikidata_geopolitics_client.py 查询政治实体的 Wikidata 条目,获取正式名称、成立时间、成员国等结构化信息。
-
互动确认 ⚠️:向用户展示已发现的行为体列表 + 时间线,等待补充。
Phase 1 交付物:Actor 列表(15-40 个节点) + 事件时间线,经用户确认。
Phase 2: 关系网络调研 (Relationship Investigation)
目的:调研所有行为体之间的关系,区分主边(利益关系)和注释层(条约、思想谱系),并为每条关系标注初步置信度。
⚠️ 关系类型规则:所有关系必须按 relation_types.md 分类。主边和注释层使用不同的视觉编码。
步骤:
-
调研主边关系(利益关系):
- 贸易/投资关系:搜索行为体之间的贸易协定、投资项目、经济制裁
- 战争/冲突关系:搜索直接军事冲突、代理战争、武器供应、军事同盟
- 资源控制关系:搜索能源/矿产/粮食/航道等战略资源的控制与争夺
-
调研注释层关系:
- 条约/协定框架:搜索正式条约、非正式协议、同盟条款
- 思想/意识形态谱系:搜索意识形态传播路径、智库影响网络、学术-政策转化链
-
初步置信度评估:在调研过程中,为每条关系标注初步置信度:
-
叙事竞争标注:当同一关系存在竞争性叙事时(如"A 入侵了 B" vs "A 发起了防御性行动"),必须在关系注释中标注两种叙事,不选边站。
-
交叉验证:对关键关系使用多源交叉验证。特别注意:
- 单一来源的关系 → 最高 LOW 置信度
- 来自冲突一方的来源 → 需要对方来源或中立来源交叉验证
- 推断性关系(从公开行为推断的隐含联盟)→ 标注为 INFERRED
-
关系完整性检查:逐一检查行为体,确保核心行为体之间的关键关系不被遗漏。
-
纪元标注 ⚠️:为每个节点和每条边标注 era 字段(所属纪元 ID 列表):
- 节点:该行为体在哪些纪元活跃?新崛起的行为体只标注近期纪元;长期存在的标注多个纪元
- 边:该关系在哪些纪元活跃?新形成的关系只标注近期;已断裂的关系只标注历史纪元
- 按纪元拆分标签 (重要) ⚠️:对于跨越多个纪元的复杂关系,推荐将
label 设置为字典格式,以定义每个纪元特有的事件。
- 示例:
{"era1": "...", "era3": "..."}
- 这种方式可以消除长周期关系在详情面板中的历史信息冗余。
Phase 2 交付物:关系边列表(含初步置信度 + 证据来源 + 纪元标注) + 叙事竞争标注清单。
Phase 3: 置信度审计 & 剪枝 (Confidence Audit & Pruning)
目的:对所有节点和边进行严格的置信度审计,清洗数据质量。
[!CAUTION]
⛔ 强制机制:本 Phase 结束时,所有节点和边都必须有明确的置信度标注。任何无标注项禁止进入 Phase 4。
步骤:
-
置信度终审:对每个节点和每条边,按 confidence_spec.md 进行最终置信度判定:
- HIGH(高置信度):3+ 独立来源交叉验证,含官方文件或权威学术来源
- MED(中等置信度):2 个独立来源,或 1 个权威来源 + 合理推断
- LOW(低置信度):仅 1 个来源,或来源有偏见但信息有价值
- INFERRED(推断):无直接证据,从行为模式/已知事实推断
-
节点剪枝:
- 保留:议题核心行为体 / 连接 2+ 个其他核心节点 / 控制关键资源 / 关键事件参与方
- 删除:与议题边缘相关 / 仅有 INFERRED 关系的孤立节点 / 信息过度不足
- ⚠️ 被删除节点如果有 MED+ 置信度的关系,不能直接删除,应降级为注释
-
边剪枝:
- 保留全部 HIGH/MED 关系
- LOW 关系:仅保留对理解核心权力结构有关键意义的
- INFERRED 关系:仅保留对填补明显认知空白有关键意义的(需在图谱中明确标注为推断)
-
聚类分组:按利益阵营/地理区域/议题维度聚合为 3-8 个阵营或利益集群。
- ⚠️ 分组依据应该是利益关系和实际行为,而非刻板的国家/种族/宗教分组
- 同一国家的不同派系可以分属不同阵营
-
置信度完整性检查 ⛔:逐一扫描——
- 每个节点是否有置信度标注?→ YES 才能进入 Phase 4
- 每条边是否有置信度标注?→ YES 才能进入 Phase 4
- 是否有 INFERRED 关系未标注为 INFERRED?→ 必须修正
- 置信度分布统计:HIGH / MED / LOW / INFERRED 各占多少比例?→ 记录到报告
Phase 3 交付物:审计后的 graph 数据(nodes + edges + groups + confidence_audit),所有节点/边均有置信度标注。
Phase 4: 可视化输出 (Interactive Viewer)
目的:将图数据转化为高质量、带置信度视觉编码的交互式 HTML 图谱查看器。
技术方案:在 generate_elite_network.py 中用 Python 数据结构定义节点、边、阵营、纪元,调用 export_html() 将数据注入 viewer_template.html,生成纯前端可交互的 Cytoscape.js 查看器。无需安装 Graphviz 或任何额外依赖。
步骤:
-
创建/更新 generate_elite_network.py,定义以下数据结构:
NODES:节点列表,每个节点含 id、label、type、group、confidence、era、desc 等字段
EDGES:边列表,每条边含 source、target、rel、label、confidence、era 等字段
GROUPS:阵营列表(势力框),含 id、label、color 字段
ERAS:纪元列表,含 id、label、range、desc 字段
-
置信度视觉编码 ⚠️(核心差异点)— 严格遵守 confidence_spec.md + visual_spec.md:
置信度通过节点/边的 confidence 字段传入,由 viewer_template.html 的 Cytoscape.js 样式自动渲染:
节点边框置信度编码:
| 置信度 | 边框样式 | 边框宽度 | 效果 |
|---|
| HIGH | 实线 | 粗 | 传达高确定性 |
| MED | 实线 | 中等 | 中等确定性 |
| LOW | 虚线 | 细 | 提示不确定性 |
| INFERRED | 点线 | 极细 | 明确标注为推断 |
边置信度编码:
| 置信度 | 线型 | 线宽 | 效果 |
|---|
| HIGH | 实线 | 粗 | 传达高确定性 |
| MED | 实线 | 中等 | 中等确定性 |
| LOW | 虚线 | 细 | 提示不确定性 |
| INFERRED | 点线 | 极细 | 明确标注为推断 |
-
节点配色、边样式 — 严格遵守 visual_spec.md 和 data_schema.md
-
调用 export_html() 生成查看器:
export_html(nodes=NODES, edges=EDGES, groups=GROUPS, eras=ERAS,
title="议题名称", output_path="output/[Topic]_EliteNetwork_Viewer.html")
-
布局验证 — 生成查看器后按 调试 checklist 检查
Phase 4 交付物:output/[Topic]_EliteNetwork_Viewer.html 交互式查看器 + 生成脚本。
- 由
export_html() 自动生成,内置纪元筛选器 + 时间线控件
- 用户可通过左侧「📅 时代纪元」筛选器或底部时间线切换纪元视图
- 支持多纪元叠加、单纪元独显、全部纪元(长曝光模式)
Phase 5: 分析报告 & 质量验证 📊
目的:生成地缘政治分析报告,让用户了解图谱的可信度、完整度和分析结论。
步骤:
-
生成分析报告 (output/[Topic]_EliteNetwork_Report.md):
报告结构(必须包含所有章节):
一、议题概述
- 议题定义 + 分析框架 + 时间范围 + 分析粒度
二、行为体清单表
| 行为体 | 类型 | 阵营 | 置信度 | 简介 | 关键来源 |
三、关系网络概述
四、权力结构分析
详见 analysis_framework.md:
- 权力中心识别
- 利益冲突热点
- 关键脆弱节点(移除某节点会导致网络重组的关键连接点)
- 叙事竞争图景
五、置信度审计报告 ⚠️(必须包含)
- 置信度分布统计:HIGH / MED / LOW / INFERRED 各占多少
- 数据不透明区域标注
- 叙事竞争影响评估
六、关系验证表 ⚠️(必须包含)
| 行为体 A | 行为体 B | 关系类型 | Source 1 (URL) | Source 2 (URL) | 置信度 | 叙事竞争? |
七、局限性声明
- 数据来源局限
- 时间范围局限
- 分析框架的偏见可能性
- INFERRED 关系的依据和风险
-
质量统计:
- 节点覆盖率(核心行为体中有多少被纳入)
- 关系调研完成率
- 多源验证率
- 平均置信度
Phase 5 交付物:
output/[Topic]_EliteNetwork_Viewer.html — 交互式图谱查看器(Phase 4 生成,Phase 5 最终确认)
output/[Topic]_EliteNetwork_Report.md — 文字分析报告(含置信度审计 + 关系验证表 + 局限性声明)
依赖技能
| 技能 | 用途 | 必需 |
|---|
tavily-search | 首选搜索:环境缺失则降级为 search_web | 可选(有 fallback) |
辅助脚本
| 脚本 | 用途 |
|---|
scripts/wikidata_geopolitics_client.py | 查询 Wikidata 政治实体信息(组织、条约、政治人物) |
参考文档
重要原则
- 强制议题确认:⛔ Phase 0 必须与用户完成至少一轮确认。禁止自行假设议题边界。
- 强制置信度标注:⛔ 所有节点和边必须标注 HIGH/MED/LOW/INFERRED。无标注项禁止进入图谱。
- 置信度即视觉:置信度编码进图谱的边粗细/虚实和节点边框样式,不是附加注释。
- 叙事竞争意识:地缘政治数据存在叙事竞争。当出现竞争性叙事时标注双方观点,不选边站。
- 诚实性优先:不确定时标注低置信度或 INFERRED,绝不编造关系或伪装确定性。
- 利益关系为主:主边聚焦贸易投资、战争冲突、资源控制等利益关系。条约和思想谱系作为注释层。
- 适度密集:目标节点数 20-50 个(视议题复杂度调整)。
- 按利益分组:聚类分组基于利益关系和实际行为,不基于刻板的国家/种族/宗教标签。
- 时间线必备:左侧必须有时间轴锚定关键事件。
- 中文标注:组织/人名保留原文名 + 中文注释。
- 可视化标准:白底 + 置信度视觉编码,通过交互式 HTML 查看器呈现。
- 局限性透明:报告必须包含局限性声明,明确数据来源受限、分析框架偏见等。