mcpField
M
material-retrieve

material-retrieve

github.com/simonwong创意与媒体963 次安装1 天前更新
代码仓库

关于 material-retrieve

素材检索技能根据关键词、标签、类型、情绪和复用度，从本地素材库中筛选并排序内容，适用于需要查找写作素材的工作流。它会读取最多 10 条匹配项的完整内容。

主要功能

  1. 01多维度组合检索
  2. 02关键词与标签模糊匹配
  3. 03按相关度及复用度排序
  4. 04读取匹配项完整内容
  5. 05最多展示 10 条结果

适用场景

  1. 01按主题查找写作素材
  2. 02筛选特定类型或情绪的条目
  3. 03寻找高复用度素材
  4. 04检查素材库并定位相关内容

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/simonwong/skills --skill material-retrieve

安装后在 Claude Code 中输入/material-retrieve确认已加载。

详细介绍

来自项目 README

素材检索

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

数据路径

素材库位于 ./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 条并告知用户总数。
  • 展示完整内容时保留原文措辞，不做改写。
  • 如果用户的查询太模糊（比如只说"找素材"），询问具体主题或方向。

评论

支持 Markdown