| 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 字
- 一个主题下有多个并列的子观点
拆分流程：
- 识别内容中的独立主题/观点
- 为每个主题确定最合适的卡片类型
- 询问用户确认拆分方案
- 按确认后的方案创建多张卡片
- 在卡片的
related 字段中建立关联
示例：
用户输入包含多个观点的内容
→ 识别为 3 个独立观点
→ 询问：这包含 3 个观点，建议拆分为 3 张观点卡片，是否同意？
→ 用户确认后创建 3 张卡片，并通过 related 字段关联
1. 确定卡片类型
如果用户明确指定了类型：直接使用指定的类型
如果用户没有指定：根据内容特征自动判断
| 类型 | 触发关键词/特征 |
|---|
book | 书籍档案、整本书信息、豆瓣链接 |
book-note | 提到"书"、书名、作者、章节、页码 |
quote | 引用号、引号、"xx说"、名言、金句 |
insight | 观点、想法、我认为、我的理解、领悟 |
counterintuitive | 反常识、意外、没想到、相反、颠覆认知 |
paradox | 悖论、矛盾、看似...其实... |
story | 故事、案例、例子、经历 |
question | 问题、疑问、困惑、思考、为什么 |
person | 人物、作者、创始人、科学家 |
term | 术语、概念、定义、什么意思 |
tool | 工具、软件、App、开发工具、AI工具 |
opensource | 开源项目、GitHub、Repo、库、框架 |
course | 课程、学习视频、训练营、在线课、教程、讲师 |
mentalmodel | 思维模型、心智模型、查理芒格、决策框架、第一性原理 |
resource | 博客、YouTube、Newsletter、Podcast、网站、资源推荐 |
subscription | 订阅、会员、SaaS、付费工具、ChatGPT、Cursor |
moc | MOC、Map of Content、内容地图、索引笔记、主题导航、知识地图 |
prompt | 提示词、Prompt、AI 指令、提示词模板 |
2. 收集/补全内容
根据卡片类型，提取用户提供的核心信息，并补全模板中必要的字段：
必填字段：
created: 当前日期 (YYYY-MM-DD)source: 信息来源（必须提供）type: 卡片类型card_type: 具体类型
类型特有字段：
book: book, author, douban_url, coverbook-note: book, authorquote: 引用内容、作者/出处person: 姓名、领域tool: 工具名称、类型、网址、定价、平台opensource: 项目名称、作者/组织、网址、语言、许可证、Starscourse: 课程名称、讲师/机构、平台、难度级别、时长、价格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. 查找相关卡片并建立双向链接
在创建新卡片前，检查已有卡片，建立知识网络
查找相关卡片的依据：
- 相同或相似的标签
- 相同的来源（如同一本书、同一个人）
- 内容中的关键词匹配
- 相同的主题或概念
双向链接的建立方式：
- 读取已有卡片：扫描
04_Knowledge/00_Cards/ 目录下所有 .md 文件
- 匹配相关卡片：根据关键词、标签、内容匹配已有卡片
- 新卡片的 related 字段：只添加一条关联强度最高的卡片链接
- 更新已有卡片的 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 属性能被正确解析，包含特殊字符的值必须加双引号
需要加双引号的情况
| 字段 | 触发条件 | 示例 |
|---|
book | 中文书名 | book: "认知天性" |
author | 包含 [] （） 、 | author: "[美] Charles Petzold" |
source | 包含 : , () 中文 | source: "Sweller, J. (1988)" |
cover | 包含 [[ ]] | cover: "[[book.png]]" |
douban_url | URL（可选加引号） | douban_url: "https://..." |
不需要引号的情况
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."
注意事项
- 原子化原则：一张卡片只讲一件事，多观点内容必须拆分
- 来源信息：
source 字段是必需的，如果用户没有提供，需要询问
- 文件冲突：如果同名文件已存在，询问用户是否覆盖
- 内容保留：尽量保留用户的原话，不要过度改写
- 占位符处理：用户没有提供的信息，用
{{待补充}} 标记
- related 字段规则（重要）：
- frontmatter related：只放一条链接，选关联强度最高的
- 正文 关联卡片：放所有相关卡片，每条附带简短说明
- 这样做的好处：frontmatter 简洁，正文完整
- 卡片关联：
- 拆分后的卡片通过
related 字段建立关联
- 双向链接：创建新卡片时，也要更新相关已有卡片的
related 字段
- 链接格式使用 wikilink：
[[卡片文件名]]
- 关联数量：建议控制在 3-5 个以内，避免过度链接
- MOC 特殊规则：
- MOC 是"内容地图"，不是知识单元，用于组织和导航其他卡片
- MOC 命名格式：
moc_{主题名}.md（如 moc_学习科学.md）
- MOC 的
source 字段可以留空或填写"自己整理"
- MOC 主要内容是 wikilink 列表，不需要大量正文
