技能介绍

要解决的问题

SkillHub 是 SPA 站点，直接抓 skillhub.cn 的页面 HTML 只能拿到前 10 条技能。要做完整的离线归档，得走 api.skillhub.cn 这个同源子域上的真实数据接口。此外列表接口本身不含评分字段，必须对每个技能再请求一次详情接口；少数技能的 description 还是泄漏的 YAML 块标量（>-）脏数据，需要用详情接口的 summary_zh 回填。这些「翻页、取详情、算评分、洗字段、排版」的动作高度重复，手工做既慢又容易算错。

工作原理

核心是一个「抓 → 算 → 排 → 出 doc」的固定流程：

抓取：fetch_skills.py 接收完整用户主页 URL（如 https://skillhub.cn/user/user_00c9b356）或裸 user_id，分页拉取列表并逐技能请求详情，输出 skills_data.json（列表 + evaluation + 清洗后的描述 + 计算好的 score）。运行时自动 pip install python-docx，用受管 Python 执行。
评分计算：页面显示的评分 = 各评测维度均值的平均，四舍五入保留 1 位。实测「判断标准制定」维度均值 4.65 → 页面显示 4.7；若改用子项均值会算成 4.64，是错的。
生成文档：gen_docx.py 按评分降序排列（无评分的排最后），每条套用固定模板：N.名称 skillhub评分 X.X → 描述：… → 可点击链接。链接通过 python-docx + relationship 写成真正的超链接，不是纯文本 URL。
可选精炼：用户要求「描述浓缩成三句话」时，用并行子代理对 skills_data.json 的 description 做摘要（每技能 3 句中文，覆盖功能 / 适用场景 / 核心特点），覆盖回字段后再生成。这一步依赖 AI 判断，脚本不会自动做。

注意点

默认输出不含「总体评测」区块，除非用户明确要求。
有出口闸门：宣布完成前必须验证「技能数 == 超链接数」，即用 zipfile 打开 docx 统计 word/_rels/document.xml.rels 里的超链接关系数，禁止凭感觉自评。
描述回填后仍为空的，标记为 （无描述）。
这套脚本的骨架可复用：换个「给页面 → 抓清单 → 出 doc」的场景，核心是①找到目标站点的真实数据 API（别信 SPA 首屏 HTML）②确认评分/字段的真实计算公式③本地 docx 超链接生成。迁移时基本只需改 fetch_skills.py 的 API 与字段映射，gen_docx.py 不用动。