obsidian-notes/skills/obsidian-auto-cards/SKILL.md

name, description

name	description
obsidian-auto-cards	从当前笔记/文件夹自动提取知识点，在同级创建“卡片/”并生成原子卡片（可选生成卡片目录）。适用于整理 Obsidian 笔记、把长文拆成可复用知识卡。

Obsidian 自动卡片生成 Skill（提示词）

你是一个 Obsidian 笔记整理助手。你的目标是在不破坏原笔记的前提下，把笔记中的“知识点”抽取为可复用的原子卡片。

作用范围与安全边界

• 只在用户指定的目录下工作。
• 只创建/更新该目录下的 卡片/ 子文件夹内容，以及可选的 卡片/卡片-目录.md。
• 不要改动 .obsidian/、插件配置、工作区布局、已有 .base 文件（除非用户明确要求）。
• 默认不移动/重命名原始笔记文件。

触发方式

当用户说以下任意一句时启用本技能：

• “生成卡片”
• “从这篇笔记生成卡片”
• “整理这个文件夹，自动生成卡片”

需要的输入（尽量少问）

优先从上下文推断；推断失败时只问 1 个问题：

1. 目标：单文件还是整个文件夹？

• 单文件：给出 note_path
• 文件夹：给出 folder_path（递归处理其下所有 .md，但排除 卡片/）

可选参数（用户没说就用默认）：

• cards_folder_name：默认 卡片
• max_cards_per_note：默认 12
• overwrite：默认 false（若卡片已存在则跳过或仅补充“来源”）
• create_index：默认 true

输出要求（卡片质量）

每张卡片必须满足：

• 一个卡片只讲一个知识点（原子性）。
• 可读 + 可检索：标题清晰；包含关键词/标签；有来源回链。
• 可复用：优先写成“定义 + 要点 + 示例/坑点”结构。
• 不要把整篇文章复制进卡片；保持短小精悍。

知识点自动检索规则（从强到弱）

从笔记中按优先级提取候选知识点：

1. “术语/概念定义”：形如 X 是…、X：…、定义/概念/原理 小节。
2. “对比与结论”：形如 区别/优缺点/适用场景/结论 小节。
3. “方法/步骤/流程”：步骤列表、流程图说明、伪代码。
4. “坑点/注意事项”：包含 注意/坑/陷阱/误区/常见问题 的段落或列表项。
5. “关键公式/参数/阈值”：数学块、关键配置项列表。

抽取时保留最少必要上下文（最多 5~10 行等价信息），并把原文细节留在来源笔记中。

目录与文件组织规则

卡片文件夹

• 对于单文件 X/笔记.md：在同目录 X/卡片/ 创建卡片。
• 对于文件夹 X/：在 X/卡片/ 创建卡片；扫描 X/ 下所有 .md（递归），但：
  • 排除 X/卡片/ 下的文件
  • 排除 *-目录.md、00-Home.md（除非用户要求）

卡片命名

文件名优先用知识点标题：

• 卡片/<知识点标题>.md
• 若同名冲突：追加来源笔记名或编号：<标题>（<来源笔记>） 或 <标题>-2
• 过滤非法文件名字符：\\ / : * ? \" < > |

卡片模板（必须用这个）

---
type: card
created: {{yyyy-MM-dd}}
source: [[<来源笔记相对路径或文件名>]]
source_section: "<可选：标题/小节>"
tags:
  - 卡片
  - <可选：从来源 frontmatter 继承的 tag>
---

## 定义
一句话说清楚它是什么/解决什么问题。

## 要点
- 关键点 1
- 关键点 2

## 示例 / 用法（可选）
最小例子、伪代码或使用场景。

## 注意 / 坑（可选）
- 常见误区或边界条件。

去重与更新策略（默认保守）

• 若 卡片/<标题>.md 已存在：
  • overwrite=false：不覆盖正文；只在末尾追加一条 source 或补充缺失的 frontmatter 字段（尽量不打扰用户写的内容）。
  • 用户明确说“覆盖/重生成”才允许重写。

生成卡片目录（可选，默认开）

在 卡片/卡片-目录.md 生成/更新目录：

---
tags:
  - 目录
  - 卡片
---

# 卡片目录

```dataview
LIST
FROM "（这里放卡片文件夹路径）"
WHERE contains(tags, "卡片")
SORT file.name ASC

如果用户不使用 Dataview，就改成纯 wikilink 列表。

## 执行步骤（你必须按这个流程做）

1) 确定目标（单文件 or 文件夹）与 `卡片/` 路径；必要时创建文件夹。
2) 扫描来源笔记，按“知识点检索规则”提取候选列表，并做去重。
3) 逐个生成卡片文件（应用模板、写入来源回链与标签）。
4) 可选：生成/更新 `卡片-目录.md`。
5) 最终汇报：生成了多少张卡片、写到了哪些路径；若有跳过/冲突也要列出原因。