card-creator

name: card-creator description: >- Create knowledge cards from user input. Automatically detects card type if not specified, then fills in the appropriate template and saves to 04_Knowledge/00_Cards/. Use this whenever the user wants to create a knowledge card, note, or atomic piece of content for their knowledge base—even if they don't explicitly mention "cards" or "templates". Keywords: create card, new card, add note, save to cards, knowledge card, card from...

Card Creator

根据用户输入创建原子化知识卡片，保存到 04_Knowledge/00_Cards/ 目录

工作流程

0. 检查内容范围（原子化原则）

原子化原则：一张卡片只讲一件事、一个观点、一个概念

在创建卡片前，先检查用户提供的内容是否符合原子化原则。

需要拆分的信号：

• 内容包含多个独立的观点或概念
• 有明显不同的主题（用"###"、"---"、分段标题分隔）
• 包含"另外"、"此外"、"再者"等连接多个话题的词
• 内容长度超过 300 字
• 一个主题下有多个并列的子观点

拆分流程：

1. 识别内容中的独立主题/观点
2. 为每个主题确定最合适的卡片类型
3. 询问用户确认拆分方案
4. 按确认后的方案创建多张卡片
5. 在卡片的 related 字段中建立关联

示例：

用户输入包含多个观点的内容
→ 识别为 3 个独立观点
→ 询问：这包含 3 个观点，建议拆分为 3 张观点卡片，是否同意？
→ 用户确认后创建 3 张卡片，并通过 related 字段关联

1. 确定卡片类型

如果用户明确指定了类型：直接使用指定的类型

如果用户没有指定：根据内容特征自动判断

2. 收集/补全内容

根据卡片类型，提取用户提供的核心信息，并补全模板中必要的字段：

必填字段：

• created: 当前日期 (YYYY-MM-DD)
• source: 信息来源（必须提供）
• type: 卡片类型
• card_type: 具体类型

类型特有字段：

• book: book, author, douban_url, cover
• book-note: book, author
• quote: 引用内容、作者/出处
• person: 姓名、领域
• tool: 工具名称、类型、网址、定价、平台
• opensource: 项目名称、作者/组织、网址、语言、许可证、Stars
• course: 课程名称、讲师/机构、平台、难度级别、时长、价格
• mentalmodel: 模型名称、提出者、学科领域、来源
• resource: 资源名称、类型（博客/YouTube/Newsletter/Podcast/网站）、语言、更新频率
• subscription: 服务名称、套餐、价格、周期、续费日期
• moc: MOC 名称、类型（主题/项目/人物/概念/时间）、主题描述

辅助补全：

• 根据用户输入，补充模板中 {{}} 占位符的内容
• 保持用户的原话和表达风格
• 不确定的信息留空或用 {{待补充}} 标记

3. 生成文件名

格式：{类型}_{卡片标题}.md

• 类型使用小写，用连字符连接：book-note, counterintuitive 等
• 标题从用户输入中提取，或根据内容生成
• 去除特殊字符，保持简洁

特殊规则：Skills 项目命名

当创建名为 "Skills" 的项目时，使用格式：opensource_Skills_{项目名}

示例：

opensource_Skills_MinimalistEntrepreneur.md  # The Minimalist Entrepreneur
opensource_Skills_Principles.md              # 《原则》
opensource_Skills_Rails.md                   # Rails on Guides

原因：避免同名冲突（Skills 是常见的项目名），清晰标识具体项目

4. 查找相关卡片并建立双向链接

在创建新卡片前，检查已有卡片，建立知识网络

查找相关卡片的依据：

• 相同或相似的标签
• 相同的来源（如同一本书、同一个人）
• 内容中的关键词匹配
• 相同的主题或概念

双向链接的建立方式：

1. 读取已有卡片：扫描 04_Knowledge/00_Cards/ 目录下所有 .md 文件
2. 匹配相关卡片：根据关键词、标签、内容匹配已有卡片
3. 新卡片的 related 字段：只添加一条关联强度最高的卡片链接
4. 更新已有卡片的 related 字段：在新卡片创建后，更新相关卡片的 related 字段，添加指向新卡片的链接

frontmatter 中的 related 字段格式：

related: "[[insight_最相关的卡片]]"

正文中"关联卡片"部分格式：

## 关联卡片
- [[insight_相关卡片]] — 简短说明
- [[quote_另一张卡片]] — 简短说明

规则说明：

• frontmatter related：只放一条链接，选关联强度最高的
• 正文关联卡片：放所有相关卡片，每条附带简短说明
• 这样做的好处：frontmatter 简洁，正文完整

示例：

新卡片：insight_数量优于质量
已有卡片：insight_写作是思考过程、insight_刻意练习的适用边界

→ frontmatter related: [[insight_写作是思考过程]]  (只放最相关的一条)
→ 正文关联卡片：
  - [[insight_写作是思考过程]] — 数量带来质量突破
  - [[insight_刻意练习的适用边界]] — 质量与数量的关系

注意事项：

• 只创建真正有意义的关联，避免过度链接
• 正文关联数量建议控制在 3-5 个以内
• 如果相关卡片超过 10 个，考虑是否过于宽泛

5. 创建文件

• 读取对应的模板文件：04_Knowledge/00_Cards/.templates/{类型}_Card.md
• 替换模板中的占位符
• 将文件写入 04_Knowledge/00_Cards/ 目录
• 告知用户文件已创建的路径

模板文件位置

所有卡片模板统一存放在 04_Knowledge/00_Cards/.templates/ 目录

04_Knowledge/00_Cards/.templates/
├── Book_Card.md
├── Book_Note_Card.md
├── Insight_Card.md
├── Quote_Card.md
├── Counterintuitive_Card.md
├── Paradox_Card.md
├── Story_Card.md
├── Question_Card.md
├── Person_Card.md
├── Term_Card.md
├── Tool_Card.md
├── Opensource_Card.md
├── Course_Card.md
├── Mental_Model_Card.md
├── Resource_Card.md
├── Subscription_Card.md
├── MOC_Card.md
├── Checklist_Card.md
├── Tip_Card.md
├── Tech_Stack_Card.md
└── Prompt_Card.md

使用示例

用户明确指定类型：

创建一个观点卡片：数量优于质量

用户不指定类型：

从《原则》这本书中学到一个观点：痛苦+反思=进步

→ 自动识别为 book-note 类型

金句识别：

马斯克说过一句话让我印象深刻："数量自有质量的品味"

→ 自动识别为 quote 类型

资源卡片识别：

推荐一个很棒的博客：Paul Graham's Essays

→ 自动识别为 resource 类型

课程卡片识别：

推荐一门很棒的课程：Andrej Karpathy 的 Neural Networks: Zero to Hero

→ 自动识别为 course 类型

思维模型卡片识别：

查理芒格提到一个思维模型叫"逆向思维"

→ 自动识别为 mentalmodel 类型

MOC 卡片识别：

创建一个学习科学的 MOC
帮我做一个关于编程的知识地图
整理一下关于查理芒格的所有内容，做成 MOC

→ 自动识别为 moc 类型

YAML 引号规则

为确保 frontmatter 属性能被正确解析，包含特殊字符的值必须加双引号

需要加双引号的情况

不需要引号的情况

tags: [card, book]              # 列表
created: 2026-04-11             # 纯数字/日期
related: []                     # 列表

示例对比

# ❌ 错误 - 可能解析失败
book: 认知天性
author: [美] Peter C. Brown
source: Sweller, J. (1988). Title.

# ✅ 正确 - 加双引号
book: "认知天性"
author: "[美] Peter C. Brown"
source: "Sweller, J. (1988). Title."

注意事项

1. 原子化原则：一张卡片只讲一件事，多观点内容必须拆分
2. 来源信息：source 字段是必需的，如果用户没有提供，需要询问
3. 文件冲突：如果同名文件已存在，询问用户是否覆盖
4. 内容保留：尽量保留用户的原话，不要过度改写
5. 占位符处理：用户没有提供的信息，用 {{待补充}} 标记
6. related 字段规则（重要）：
   • frontmatter related：只放一条链接，选关联强度最高的
   • 正文 关联卡片：放所有相关卡片，每条附带简短说明
   • 这样做的好处：frontmatter 简洁，正文完整
7. 卡片关联：
   • 拆分后的卡片通过 related 字段建立关联
   • 双向链接：创建新卡片时，也要更新相关已有卡片的 related 字段
   • 链接格式使用 wikilink：[[卡片文件名]]
8. 关联数量：建议控制在 3-5 个以内，避免过度链接
9. MOC 特殊规则：
   • MOC 是"内容地图"，不是知识单元，用于组织和导航其他卡片
   • MOC 命名格式：moc_{主题名}.md（如 moc_学习科学.md）
   • MOC 的 source 字段可以留空或填写"自己整理"
   • MOC 主要内容是 wikilink 列表，不需要大量正文