Agent Skills
返回列表
Obsidian 结构化笔记

Obsidian 结构化笔记

知识管理 更新于 2026.08.30

将以下提示词粘贴到你的 AI 对话框中:

请根据 https://skillhub.cn/install/skillhub.md,安装 @user_733f3aed/obsidian-notes-skill。

技能介绍

要解决什么问题

对话、微信文章、PDF、会议记录和项目文件往往停在「当时能看懂」的状态:过几天只剩链接、零散摘要,或一篇指针笔记,读者必须重新打开原始资料才能继续工作。Obsidian 库若缺少统一的 Properties、callout 区块和 Key references / 文件引用 边界,笔记之间也难以形成可检索的知识关系。

技能如何工作

本技能把「整理成笔记」当成一条可重复流水线,而不是自由发挥写 Markdown:

  1. 识别主题与类型:区分 agent-workflow、project-note、technical-note、decision-record、reference-note 等,业务归档时对照 references/note-types.md 选领域模板。
  2. 按来源处理:微信、URL、Office、本地文件等走 references/source-types.md 的规则,避免把抓取中间件当成长期正文。
  3. 落盘位置:Agent 工作流默认 00-Agent(工作流沉淀)/;业务档案优先 06-Archives(重要档案)/(除非用户指定)。
  4. 固定结构起草:YAML(created_at、note_type、tags 等)+ ## Key takeaway / ## 摘要 / ## Context + 主体块 + ## 后续可复用关键信息 + ## Key references + ## 文件引用;写入前套用 note-template.md 与 style-guide.md。
  5. 关联与验证:检索同目录/同主题笔记,补齐 related_notes 与 wiki 链接;有 Obsidian MCP 或 Local REST API 时优先 vault_write 并读回验证,否则输出 Markdown 供手动写入。

对 06-Archives 中的工作项目笔记,正文要求「脱离原文件仍可理解」:机制、案例、数据口径和可复制启示写在正文里,页码只作证据放在 Key references。

边界与注意点

  • 本技能是 Obsidian 笔记的结构权威;obsidian-markdown 只补语法,obsidian-bases / json-canvas 各管 .base / .canvas,obsidian-cli 仅在 MCP 不够时用于插件调试。
  • tags 只放稳定主题,不把 note_type、年份或带特殊符号的品牌写法塞进标签。
  • 默认不写密钥类敏感信息;删除、移动、整篇替换需用户明确确认。

使用场景

  • 把微信长文、PDF 或会议记录整理进 `06-Archives`,正文保留机制与案例,读者不必再打开原文件
  • 在 `00-Agent(工作流沉淀)/` 记录 MCP、CLI 与可重复 Agent 步骤,并写清验证方式与已知坑点
  • 项目复盘后写 `decision-record`:已选方向、被排除方案、依据与影响,并链接同项目已有笔记
  • 多来源资料(URL、DOCX、本地路径)入库前按 `source-types.md` 处理,Key references 与 Context 保留可点击来源

适合人员

  • 负责社群/会员或品牌活动复盘,需要把运营资料写成可检索、可复用的项目归档笔记的运营同学
  • 在 Obsidian 里维护 Agent 工具链,希望 Properties、callout 与 `vault_patch` 写入规则一致的技术维护者
  • 跨部门项目结束后要把决策过程与数据口径沉淀进知识库、并避免「只有链接」指针笔记的产品或项目负责人
  • 长期用 Obsidian 做第二大脑、需要统一 YAML、`related_notes` 与 wiki 引用边界的个人知识库维护者