zach22-1999/generic-skills / skills/zach-term-miner
zach-term-miner
Verified术语挖掘:做一件事之前,先弄清楚这个领域里 AI 听得懂的专业术语,再用这些术语改写你的 prompt。 输入三句话(要做什么 / 已经知道什么 / 哪个领域),产出一个离线 HTML:5 个核验过来源的必要术语、 每个术语对应的「大白话 prompt → 术语版 prompt」前后对照、以及一条 30 分钟学习顺序。 用户说"术语挖掘""我要做 X,需要懂哪些术语才能跟你讲清楚""AI 总是理解偏""这个 prompt 怎么写得更专业" "帮我看看我该学什么术语"时使用。普通词义查询、已有完整 prompt 只想执行、或用户明确要求直接开始做原任务时不要触发。 本 skill 只出术语和 prompt 改写,不执行原任务;不编造术语和来源。
| File | Kind | Size |
|---|---|---|
| .gitignore | other | 60 B |
| LICENSE | other | 1.0 KB |
| README.md | markdown | 5.0 KB |
| SKILL.md | skill md | 5.7 KB |
| examples/listing-bullets.html | other | 20.5 KB |
| examples/non-ecommerce.html | other | 20.3 KB |
| examples/review-mining.html | other | 21.3 KB |
| references/prompt-rewrite-guide.md | markdown | 3.3 KB |
| references/term-prompt-pack.schema.json | config | 4.8 KB |
| references/term-selection-rubric.md | markdown | 2.7 KB |
| scripts/fixtures/listing-bullets.json | config | 7.5 KB |
| scripts/fixtures/non-ecommerce.json | config | 7.5 KB |
| scripts/fixtures/review-mining.json | config | 8.0 KB |
| scripts/render_pack.py | script | 12.9 KB |
| scripts/test_pipeline.py | script | 6.5 KB |
| scripts/validate_pack.py | script | 15.0 KB |
README.md
View on GitHub# zach-term-miner · 术语挖掘
> 做一件事之前,先弄清楚这个领域里 AI 听得懂的专业术语,再用这些术语改写你的 prompt。
同一个模型,用大白话写 prompt,AI 只能给出你明确提出来的东西;换成这个领域的专业术语,AI 会把你没想到、但这个术语默认包含的维度一起补上。问题是多数人讲不出自己不熟悉领域的行话。这个 skill 做的就是那个前置动作。
## 推荐安装方式:让 AI 帮你装
推荐在以下 IDE 中直接用自然语言安装:
- Claude Code
- Codex
- Cursor
- Kiro
- Antigravity
把下面这句话直接发给你的 AI:
```text
帮我安装 `zach-term-miner` 这个 skill,来源仓库是 `generic-skills`。直接装到当前工作区,并把依赖一起检查好。
```
## 它做什么
你只需要说三句话:**要做什么、已经知道什么、哪个领域**。
它会:
1. 从任务反推候选术语,筛到 5 个真正会改变 AI 输出方式的词(最多 8 个)。
2. 逐个核验来源,标明「已核验 / 有来源 / 非行业共识 / 待核验」。
3. 给每个术语写一组 **prompt 前后对照**:大白话版 → 术语版,并列出 AI 会多补的维度。术语版更短,可以直接复制去用。
4. 给一条 **30 分钟学习顺序**。
5. 生成一个单文件离线 HTML,手机能看、能打印、不联网。
然后停下来。它不执行你的原任务。
## 怎么用
在装好 skill 的 IDE 里直接说:
```text
术语挖掘:我要从一批产品评论里找产品改进方向;手上有从工具导出的评论数据,知道要看人群、场景和痛点;领域是消费品产品开发。
```
或者更随意:
```text
我要给团队写下季度目标,没写过,需要先懂哪些术语才能跟你讲清楚?
```
信息不够时它最多追问一轮、最多两个问题。你说「直接来」,它就把缺的写进假设继续做。
## 示例产物
三个渲染好的示例,直接在浏览器打开:
- [评论挖掘 → JTBD](./examples/review-mining.html):文章里的第一个例子
- [电商卖点文案 → FABE + COSMO](./examples/listing-bullets.html):文章里的第二个例子
- [团队季度 OKR](./examples/non-ecommerce.html):非电商领域,证明它不是电商专用
对应的数据在 `scripts/fixtures/`。
## 产物长什么样
五个区块,单线读下来:
| 区块 | 内容 |
|---|---|
| 30 秒摘要 | 几个术语、几个已核验、几组对照 |
| 你的任务 | 三句话 + AI 补的假设 |
| 必要术语 | 标准名、中文名、一句话定义、为什么影响这个任务、来源与状态 |
| prompt 前后对照 | 左大白话、右术语版(可复制)、下方「AI 会多补的维度」 |
| 30 分钟学习顺序 + 待核验 | 先学哪个、为什么;没核验的词单独列 |
## 依赖与降级
- 只需要 Python 3.10+,标准库,不装任何包。
- 术语来源核验需要 AI 能联网搜索。**没有搜索工具时**,所有术语标「待核验」,HTML 顶部提示你自行核验,其余产物照常生成。
- HTML 不依赖任何外部资源,浏览器离线打开即可。
## 手动运行脚本
```bash
python3 scripts/validate_pack.py pack.json # 校验数据
python3 scripts/render_pack.py pack.json output.html # 渲染 HTML
python3 scripts/validate_pack.py pack.json --html output.html # 顺带校验 HTML
python3 scripts/test_pipeline.py # 回归测试
```
数据合同见 `references/term-prompt-pack.schema.json`。
## 它不做什么
- 不执行你的原任务,只给术语和改写后的 prompt。
- 不编术语、不编来源。找不到就标待核验。
- 不出项目计划、需求文档,不写知识库。
## 如果安装或运行出错,直接让 AI 帮你排查
把下面这段直接发给你的 AI,并把报错信息、截图或终端输出一起贴上:
```text
我已经安装了 `zach-term-miner`,但现在遇到了问题。请你直接帮我排查并尽量修复:
1. 先判断是 skill 文件缺失、依赖缺失、MCP 未连接、路径错误,还是当前 IDE 没有正确加载
2. 自动检查当前工作区里和 `zach-term-miner` 相关的文件、配置和依赖
3. 如果可以自动修复,就直接修复
4. 修复后告诉我还需要重启 IDE、重新加载工作区,还是重新运行哪个命令
5. 最后给我一个最短的验证步骤,确认这个 skill 已经能用了
```
## 手动安装
把本目录复制到你的 skill 目录(例如 Claude Code 的 `~/.claude/skills/zach-term-miner/`),重新加载 IDE 即可。
仓库地址:https://github.com/zach22-1999/generic-skills
## 关于作者
关注「**Zach的进化笔记**」,获取 AI x 跨境电商的实战经验、工具和方法论
也会分享对应跨境电商和AI相关的一些思考:
<img src="../../assets/traffic/wechat-official-account.jpg" width="200" alt="公众号二维码" />
扫码加入交流群,一起交流 AI + 跨境电商的实战玩法:
<img src="../../assets/traffic/wechat-group.jpeg" width="200" alt="交流群二维码" />
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| reverse-engineer-anythingmorluto/reaReverse engineer native, managed, Electron/JavaScript, packaged, firmware, and browser targets with REA, and build agent environments (AgentEnv bundles) of web applications from a live instance or a capture, and of Linux desktop apps with a task from a request. Use shipped-artifact or requested runtime evidence to explain features, compare versions, decompile code, or guide a reconstruction. Skip REA for ordinary source-repository architecture analysis. | Stars: 472k | Updated | Claude CodeCodex | Verified | Install |
| diagnosing-superpowersobra/superpowersUse when a superpowers session went wrong and your human partner wants to know why — repeated work, ignored plans, stumbles, poor results, a skill that didn't fire, "it took too long", "why is it so expensive", "what is it doing" — or wants to build a bug report for the superpowers maintainers, for the current session or a past one identified by id or path, on any harness. | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| dispatching-parallel-agentsobra/superpowersUse when facing 2+ independent tasks that can be worked on without shared state or sequential dependencies | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| executing-plansobra/superpowersUse when executing an implementation plan in the current session as the implementer yourself — your human partner chose inline execution, or no subagent tool is available | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |