Skip to content

Latest commit

 

History

1 Commit

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 

Repository files navigation

make-knowledge-cards

一个 Codex skill:把用户粘贴的文章或本地 Markdown/TXT 文件,自动提炼为 5-8 张知识卡片,用于学习、复习和知识整理。

项目解决什么问题

长文章读完容易“看过就忘”,手动整理要点既费时,又容易遗漏或重复。本项目用知识卡片的形式,把整篇文章压缩成一组聚焦的知识点:

  • 每张卡片只讲一个知识点,便于逐点消化和复习;
  • 自动去重、按重要性筛选,把篇幅压缩到 5-8 张卡片;
  • 卡片内容忠于原文、不编造,避免整理过程中的信息失真。

主要功能

  • 输入支持:用户粘贴的文本,或本地 .md / .txt 文件。
  • 卡片格式:每张卡片固定包含标题、核心知识、简明解释、例子或自测问题四个部分。
  • 自动处理:识别独立知识点 → 合并重复内容 → 按重要性选出 5-8 个 → 生成 Markdown 卡片。
  • 质量约束
    • 只保留真正重要的知识,一张卡片只讲一个知识点;
    • 重复内容自动合并;
    • 不补充原文没有的信息,例子不扩展原文细节;
    • 信息不足时不强行凑数(允许少于 5 张并说明原因)。
  • 输出方式:默认直接在对话中输出 Markdown 卡片;也可按要求保存为本地 .md 文件。
  • 明确不支持:网页抓取、PDF 文件、Anki 和图形界面。

安装方法

skills/make-knowledge-cards 目录复制到本机 skills 目录即可,无需安装其他依赖或脚本:

  • Windows:C:\Users\<用户名>\.codex\skills\make-knowledge-cards
  • macOS / Linux:~/.codex/skills/make-knowledge-cards

如果 Codex 已把本项目配置为 skills 目录,也可以不复制,直接使用本项目路径。

使用方法

在 Codex 对话中直接请求即可(skill 会自动被调用,也可显式用 $make-knowledge-cards):

  1. 粘贴文本:把文章内容粘贴进对话,并说“请用 $make-knowledge-cards 把下面这篇文章转成知识卡片”。
  2. 本地文件:给出文件路径,例如“请用 $make-knowledge-cards 把 D:\notes\article.md 转成知识卡片”。支持 .md.txt;文件不存在或打不开时会提示你。

卡片默认显示在对话中;需要保存为文件时,追加一句“保存为 knowledge-cards.md”即可。

输入输出示例

输入(科普文章节选):

睡眠分为非快速眼动睡眠(NREM)和快速眼动睡眠(REM)两个大类。NREM 睡眠又细分为浅睡和深睡,深睡阶段身体修复肌肉和组织、分泌生长激素;REM 睡眠阶段大脑活动活跃,梦境大多发生在这个阶段,它和记忆巩固关系密切。一夜之中,NREM 和 REM 交替出现,形成睡眠周期,每个周期大约 90 分钟。成年人一晚通常会经历 4 到 5 个这样的周期。

输出(对应生成的知识卡片,节选):

睡眠分 NREM 与 REM 两个阶段

核心知识:睡眠分为非快速眼动睡眠(NREM,含深睡)和快速眼动睡眠(REM);深睡修复身体,REM 与梦境和记忆巩固有关。

简明解释:NREM 中的深睡阶段修复肌肉和组织、分泌生长激素;REM 阶段大脑活跃、多做梦,与记忆巩固关系密切。

例子或自测问题:自测:生长激素主要在哪个睡眠阶段分泌?梦境大多发生在哪个阶段?


睡眠周期约 90 分钟,一晚经历 4-5 个

核心知识:NREM 与 REM 交替出现形成睡眠周期,每个周期约 90 分钟,成年人一晚通常经历 4 到 5 个周期。

简明解释:整夜睡眠不是一段连续的深睡,而是多个周期交替,深睡和 REM 在不同周期的比例会变化。

例子或自测问题:自测:一个成年人睡 7.5 小时左右大约会经历多少个睡眠周期?

About

A Codex skill that turns articles or local Markdown/TXT files into 5-8 focused knowledge cards. 将文章或本地 Markdown/TXT 文件自动提炼为 5-8 张知识卡片。

Topics

Resources

Stars

1 star

Watchers

0 watching

Forks

Releases

Packages

Contributors