Make Knowledge Cards

一个面向 Codex 的开源 Skill：把用户粘贴的文章或本地 Markdown/TXT 文件，转换成忠于原文的知识卡片。该 Skill 由提示词和界面元数据组成，不需要安装依赖，也不包含可执行脚本。

1. 项目解决的问题

长文章的信息密度往往不均衡，真正重要的概念容易被背景、重复表述和细节淹没。人工整理知识卡片又需要反复筛选、合并和核对原文，耗时且容易遗漏或重复；普通总结还可能加入原文没有的信息。

本项目的目标是提供一套可复用的提炼规则，让 Codex 将文章整理为数量受控、每卡一个知识点、可直接用于复习的知识卡片，同时保留原文依据和信息边界。

2. 主要功能

输入

• 用户直接粘贴的文章正文。
• 用户提供路径的本地 .md、.markdown、.txt 文件。

输出

默认在对话中以 Markdown 返回 5～8 张知识卡片。每张卡片包含：

• 标题
• 核心知识
• 简明解释
• 例子或自测问题

提炼规则

• 根据重要性选择中心论点、关键概念、机制、方法、条件和限制。
• 合并含义重复的内容。
• 一张卡片只讲一个可独立理解的知识点。
• 卡片中的事实、数字、条件和结论必须来自原文或由原文必要关系推出。
• 原文信息不足 5 个独立知识点时，减少卡片数量，不强行凑数。
• 除用户另有指定外，使用用户提问时的语言；处理文件时默认沿用原文语言。

暂不支持

• 网页抓取
• PDF 或扫描件解析
• Anki 导出
• 图形界面

3. 安装方法

仓库中的 Skill 源目录为：

skills/make-knowledge-cards/
├── SKILL.md
└── agents/
    └── openai.yaml

将整个 skills/make-knowledge-cards 目录复制到 Codex 的个人 Skills 目录即可。Codex 默认使用 ~/.codex/skills；设置了 CODEX_HOME 时使用 $CODEX_HOME/skills。

Windows PowerShell

在本项目根目录执行：

$codexHome = if ($env:CODEX_HOME) { $env:CODEX_HOME } else { Join-Path $HOME '.codex' }
$targetSkills = Join-Path $codexHome 'skills'
New-Item -ItemType Directory -Force $targetSkills | Out-Null
Copy-Item -Path '.\skills\make-knowledge-cards' -Destination $targetSkills -Recurse -Force

macOS / Linux

在本项目根目录执行：

CODEX_HOME="${CODEX_HOME:-$HOME/.codex}"
mkdir -p "$CODEX_HOME/skills"
cp -R skills/make-knowledge-cards "$CODEX_HOME/skills/"

安装完成后，确认以下文件存在：

<CODEX_HOME>/skills/make-knowledge-cards/SKILL.md
<CODEX_HOME>/skills/make-knowledge-cards/agents/openai.yaml

重新打开或新建 Codex 对话后，可通过 $make-knowledge-cards 调用该 Skill。

4. 使用方法

粘贴文章

使用 $make-knowledge-cards 把下面的文章整理成知识卡片：

<粘贴文章正文>

读取本地文件

使用 $make-knowledge-cards 读取 articles/sleep.md，并生成知识卡片。

也支持 .markdown 和 .txt 文件。

保存结果

默认结果直接在对话中返回。需要写入本地 Markdown 文件时，请明确指定：

使用 $make-knowledge-cards 读取 articles/sleep.md，生成知识卡片并保存为 cards/sleep-cards.md。

5. 输入输出示例

输入

番茄工作法把工作拆成专注时段和短暂休息。一个常见做法是专注 25 分钟，
然后休息 5 分钟；每完成四个时段后，进行一次较长的休息。该方法只规定
时间节奏，并不保证任务本身一定重要或可完成。

输出

## 知识卡片

### 卡片 1：番茄工作法的基本时间结构

**核心知识：** 番茄工作法把工作拆成专注时段和短暂休息，常见结构是专注 25 分钟、休息 5 分钟，每完成四个时段后再进行较长休息。
**简明解释：** 该方法的核心是规定工作的节奏和分段方式。
**自测问题：** 原文给出的专注、短休息和长休息分别如何安排？

### 卡片 2：时间节奏不等于任务价值保证

**核心知识：** 番茄工作法只规定时间节奏，并不保证任务本身一定重要或可完成。
**简明解释：** 使用该方法仍需另行判断任务的重要性和可完成性。
**自测问题：** 番茄工作法不保证哪两件事？

**说明：** 原文可独立成卡的知识点不足 5 个，未强行凑数。

当原文信息充足时，输出会扩展为 5～8 张卡片；若原文没有合适例子，卡片会使用自测问题，而不会编造原文之外的案例或数据。