Hyper-Extract 实战教程

第 1 章 · 先装 skills，用 brainstorm 开个头

先说人话：Hyper-Extract 像一台「文档绞肉机」——左边进乱七八糟的文字，右边出整齐的结构化结果。但绞肉机要先有模具（YAML 模板）。本站免费包教助手怎么帮你设计模具；真正按下开关，还得另装 CLI。

本章只做一件事：装好 skills → 照抄提问 → 拿到一份类型建议或设计草稿。

安装包免费（Apache-2.0）。后面章节才讲装 he、跑第一次 parse。

---

你大概会卡在哪

1. 把整个 GitHub 仓当 Skill 解压，目录名对不上；
2. 一上来就要「抽完整本书」，却说不清要什么字段；
3. 以为下完包就能离线抽取——其实还没装 CLI、没配 API Key。

---

1. 装进 Cursor（约 5 分钟）

1. 登录 SkillBazaar，打开免费 Skill「Hyper-Extract 知识模板设计」，下载 zip。

2. 解压后顶层文件夹必须叫 hyper-extract，放到 skills 目录，例如：

   ~/.cursor/skills/hyper-extract

   里面应有根 SKILL.md，以及 brainstorm/、record-designer/、graph-designer/ 等子目录。

3. 新开对话。需要时 @hyper-extract，或说：「请使用 Hyper-Extract skills 帮我设计抽取模板。」

小检验：问助手「brainstorm 和 graph-designer 分别干什么？」——能说清「先选型、再画图模板」，就算装上了。

---

2. 照抄这段提问

使用 Hyper-Extract 的 brainstorm：我想从一份人物传记 Markdown 里抽出人物与作品关系。
请先跟我确认输入输出，再建议该用 model / list / set / graph / hypergraph 里的哪一种，并给出设计草稿。
先不要生成最终 YAML，也不要假装已经跑过 he parse。

万一它「不听话」

• 直接甩出一长段 YAML → 说：「先走 brainstorm，未确认类型前不要写完整模板。」
• 开始编造 he parse 结果 → 说：「本章只设计模板；本机尚未要求你执行 CLI。」
• 忽略官方子技能 → 说：「按 hyper-extract 工作流：brainstorm → designer。」

---

3. 本章验收清单

• hyper-extract/SKILL.md 与至少一个子技能目录在盘上
• 助手给出了类型建议（例如 graph）和简短设计草稿
• 你知道：skills ≠ 已安装的 he 命令
• 你知道下次要把「输入文档长什么样 / 输出要哪些字段」说清楚

往下滚解锁：怎么选记录型还是图谱型、怎么装 CLI 跑通第一次、翻车怎么救。