---
name: material-retrieve
description: 从素材库中按主题、标签、类型检索可复用的写作素材。当用户说"找素材""查素材""关于XX的素材""检索素材库""有没有关于XX的东西""翻翻素材库"时使用此技能。当用户在写作过程中需要支撑材料时也应主动建议使用。
license: MIT
metadata:
  author: simonwong
  version: "1.1.0"
---

# 素材检索

从素材库中按条件检索相关素材。

## 数据路径

素材库位于 `./writing-workspace/materials/`：
- `index.jsonl` — 素材索引（JSONL 格式，每行一条 {id, summary, tags, type, source_title, reusability}）
- `entries/{id}.json` — 素材完整内容

## 执行流程

### 1. 读取索引

读取 `./writing-workspace/materials/index.jsonl`。

- 如果文件不存在或为空：告诉用户"素材库还是空的，可以用 material-ingest 技能先入库一些文章。"然后结束。
- 如果有内容：继续检索。

### 2. 解析用户查询

从用户输入中提取检索条件，支持以下维度的任意组合：

| 维度 | 示例 |
|------|------|
| 关键词 | "关于创业的素材" → 关键词"创业" |
| 标签 | "标签是AI的" → 标签匹配"AI" |
| 类型 | "找一些案例" → type=case |
| 情绪 | "有没有比较犀利的观点" → sentiment=provocative |
| 复用度 | "找那些可以直接用的" → reusability=high |

如果用户只给了一个主题词，同时按关键词和标签两个维度匹配。

### 3. 多维匹配

遍历 index.jsonl 中的所有条目，按以下逻辑匹配：

**关键词匹配**（模糊）：
- 检查 summary 和 tags 中是否包含查询词或其近义词
- "创业"应匹配"初创公司""创业者""startup"
- "AI"应匹配"人工智能""大模型""LLM"

**标签匹配**（精确 + 模糊）：
- 精确匹配优先
- 同义标签也算匹配（如上）

**类型/情绪/复用度匹配**（精确）：
- 直接对比字段值

### 4. 排序

匹配结果按以下优先级排序：
1. 相关度（匹配维度越多越靠前）
2. 可复用程度（high > medium > low）
3. 时间（新的优先）

### 5. 读取完整内容

对排序后的前 10 条结果，读取 `entries/{id}.json` 获取完整 content。

### 6. 展示结果

```
## 素材检索结果

查询：关于"创业"的素材
匹配：共 X 条

| # | ID | 类型 | 摘要 | 标签 | 复用度 |
|---|-----|------|------|------|--------|
| 1 | mat_xxx | viewpoint | ... | 创业, AI | high |
| 2 | mat_xxx | case | ... | 初创公司 | medium |

---

### 详细内容

**1. mat_xxx** [viewpoint] — 来自《原文标题》
> 完整内容...

**2. mat_xxx** [case] — 来自《原文标题》
> 完整内容...
```

如果没有匹配结果，告诉用户"没有找到相关素材"，并建议扩大搜索范围或入库更多文章。

## 注意事项

- 结果不超过 10 条。如果匹配太多，只展示最相关的 10 条并告知用户总数。
- 展示完整内容时保留原文措辞，不做改写。
- 如果用户的查询太模糊（比如只说"找素材"），询问具体主题或方向。