冀石雨区域信息研究 skill

让任意一级行政区划（省 / 市 / 县 / 区）在一份「数据可溯源、图表可交互、结论可落地」的双格式报告中立体呈现。版本：1.0.1 ｜ slug：jishiyu-region-research ｜来源：skillhub

一、这个 skill 能做什么

当用户给出具体行政区划名称（如「浙江省」「杭州市」「义乌市」「仁化县」），并要求获得该地区综合画像时，本 skill 会自动产出：

HTML 可视化看板（自包含单文件，内嵌 echarts.min.js，断网亦可完整打开）——含指标卡、组合图表、标签页交互、真实行政/区位地图、悬浮提示。
Markdown 结构化报告——章节清晰，数据段后紧跟来源标注。

即使是未显式要求「两种格式」，本 skill 默认同时交付这两份产物。

二、触发条件

关键词包括但不限于：区域分析、城市画像、省份报告、地区 GDP、产业分析、地方志、区域看板、县域经济、招商研判。

用户给出具体行政区划名称 + 要求综合画像 → 进入工作流。
用户未指定具体区域 → 先通过 AskUserQuestion 确认目标区域。

三、使用流程（五阶段）

| 阶段 | 动作 | |---|---| | 1 · 接收与解析 | 确认区域行政级别与上级政区、确定数据基准年（默认最新已公布完整年度，如 2025）。 | | 2 · 多维采集 | 按 SKILL.md「采集清单」联网调研，优先政府网站（统计局/发改委/政府门户）与权威媒体，记录每条关键数据来源 URL。 | | 3 · 统计与咨询分析 | 施加 PESTEL / SWOT / 产业集群 / 标杆对比 / 排名差距 / 时间序列 / 区位交通 / 发展阶段 / 竞争战略 / 风险韧性等方法（除 SWOT 外至少 3–5 种）。 | | 4 · 双格式生成 | 整理 region_data.json → 运行生成器产出 HTML + Markdown。 | | 5 · 来源核查与交付 | 复核每个数字有对应来源 → 用 verify_region_data.py 校验 → 交付。 |

四、数据契约（region_data.json）

将所有调研结果整理为一个 JSON 文件，字段详见 SKILL.md「四、数据契约」。完整可运行范例见 references/example-china-region_data.json（中国全国样例，26 个顶层字段，已通过校验）。

关键必填维度：meta、overview、geography、geo、gdp_trend、industry、benchmark / comparison、rankings、sources（每条来源须含 label / url / covers）。字段缺失时生成器会优雅降级，不会报错。

五、本地运行生成器与校验器

生成器与校验器为纯 Python 脚本，依赖仅 Python 3，无需额外第三方库（echarts.min.js 已内联）。

# 1) 生成看板与报告
python build_dashboard.py <path>/region_data.json <output_dir>/
#   产出：<区域>_区域信息看板.html 与 <区域>_区域信息报告.md

# 2) 数据一致性校验（生成前/后强制关卡）
python verify_region_data.py <path>/region_data.json \
       --html <生成的看板.html> --skill <技能目录>
#   退出码 0 = 无 FAIL（可有 WARN）；1 = 存在 FAIL，须修正后再生成

校验维度含：单位—数值量级一致性、GDP 跨章节一致性、排名与对标交叉核对、省级口径自洽（34 含港澳台 / 31 不含港澳台须有口径说明）、来源覆盖与可追溯、模板占位符扫描、行政地图名称匹配、核心板块覆盖等。

六、目录结构

jishiyu-region-research__skillhub/
├── SKILL.md                      # 技能方法论（工作流 + 数据契约 + 输出规范 + 质量清单）
├── README.md                     # 本使用说明
├── build_dashboard.py            # 看板/报告生成器
├── verify_region_data.py         # 数据一致性校验器
├── echarts.min.js                # 内联图表库（已授权 Apache-2.0，仅保留许可头）
├── _icon.png                     # 技能图标（512×512，本地生成，无品牌标识）
├── _meta.json                    # 发布元数据
├── _skillhub_meta.json           # SkillHub 安装元数据
├── maps/                         # 真实行政区划 GeoJSON（阿里云 DataV.GeoAtlas，含台湾省与南海诸岛）
│   ├── 100000_full.json          # 全国
│   └── 130000_full.json          # 河北（示例）
└── references/
    └── example-china-region_data.json  # 完整可运行数据范例（中国）

七、合规与来源说明

数据来源：优先采用政府网站（统计局/发改委/政府门户）与权威媒体（央广网/人民网/央视等），报告中逐条标注来源链接与「所支撑内容」。
地图边界：取自阿里云 DataV.GeoAtlas，符合国家标准，含台湾省与南海诸岛；生成时内联进 HTML，完全离线自包含。
图标与品牌：图标为本地程序化生成（科技蓝圆角方块+柱状图+定位针），不含任何企业标识或受版权保护的视觉元素，规避侵权风险。
第三方组件：echarts.min.js 为 Apache License 2.0 开源库，仅保留其许可头，未做修改。
结论边界：所有结论基于公开资料整理，部分细分数据以最新公布口径为准，不臆造数字。

八、版本记录

1.0.1（当前）：净化示例数据内容，统一为中性事实性表述；默认国家名简化为「中国」；生成器中硬编码的默认区域名改为动态获取；补充 README；头图/尾图统一为主版块科技蓝 #2563EB 纯色、去除发光特效。
1.0.0：初始发布——双格式交付、真实地图版块、多维分析框架、数据核实流程、可离线自包含 HTML。