Tags
AI
视频介绍
资源地址
备注
创建 Skill:Obsidian 笔记关联整理
你现在要帮我在当前 AI 工具中创建一个可复用的 skill 文件夹,而不是直接帮我整理这一次笔记。
这个 skill 的目标是:把 Obsidian 里的采集笔记 / 素材笔记,与长期主题笔记、表达输出笔记建立清晰关联。它不是自动归档,也不是移动文件,也不负责生成正文摘要;它默认接在摘要整理 skill 之后,利用已有摘要、状态和 Obsidian 双链,让信息从「素材层」流向「主题层」和「产出层」。
请按下面流程创建真实的 skill 文件夹和文件。
一、创建前向我收集配置
先一次性问我下面这些问题。每个问题都有默认值;如果我没有回答某一项,就使用默认值继续。
- 这个 skill 文件夹叫什么名字?
- 默认:
obsidian-note-organizer - 说明:这是 AI 工具里用于触发的 skill 名称,不是 Obsidian 仓库名。
- 你的 Obsidian 仓库叫什么,仓库路径在哪里?
- 默认仓库名:
Shiki's Obsidian Starter - 默认路径策略:先让 AI 在常见 Obsidian 目录中查找同名仓库;找不到时再向用户询问路径。
- Mac 找路径方法:右键点击仓库文件夹,按住 Option 键,选择「拷贝……的路径名称」。
- Windows 找路径方法:打开仓库文件夹,点击顶部地址栏,复制显示的路径。
- 你的三类笔记分别放在哪些文件夹?
- 素材层 / 采集层:默认
01. 采集 Grasp - 主题层 / 归类层:默认
02. 归类 Arrange - 产出层 / 表达层:默认
03. 表达 Present - 说明:不要求你使用这些名字。只要说明哪个文件夹存原始素材,哪个文件夹存长期主题,哪个文件夹存文章、视频脚本、方案、项目等输出内容。
- 用哪个属性字段保存「笔记之间的关联」?
- 默认:
相关笔记 - 默认关联逻辑:只把主题层和产出层笔记链接写入素材笔记的
相关笔记;主题层和产出层默认不反向写入大量素材链接,避免属性区变得很长。 - 如果你的仓库用
LINK、related、connections等字段,请说明字段名。
- 你的关联逻辑是哪一种?
- A. 默认:素材笔记链接到主题笔记和产出笔记;主题 / 产出不反向写入素材链接。
- B. 双向属性:素材笔记写主题 / 产出链接,主题 / 产出笔记也写回素材链接。
- C. 只做正文双链:不维护属性字段,只在正文中写
[[双链]]。 - D. 自定义:请说明哪些类型的笔记互相链接,以及写入哪个字段。
- 建议默认选 A。它最适合素材很多的知识库,能避免主题笔记和产出笔记的属性区被大量素材链接塞满。
- 用哪些属性字段保存摘要、外部链接和状态?
- 摘要字段默认:
摘要 - 外部来源字段默认:
链接或原始来源 - 状态字段默认:
tags - 未整理状态默认:
未整理 - 已整理状态默认:
已整理 - 主题 / 产出进行中状态默认:
进行中 - 主题 / 产出已完成状态默认:
已完成 - 说明:这里的「属性」指 Markdown 文件开头的 frontmatter。
- 新建主题笔记或产出笔记时,是否使用模板?
- 默认:使用模板。
- 主题模板默认:
模版 Template/02. 归类笔记.md - 产出模板默认:
模版 Template/03. 表达模版.md - 如果没有模板,就让 AI 创建一个最小可用笔记:标题、摘要、状态、相关笔记字段。
- 整理时是否允许新建主题或产出笔记?
- 默认:允许,但每次新建前必须先展示建议并等待确认。
- 可选:只关联已有笔记,不新建。
- 可选:允许新建主题,但不新建产出。
请提醒用户:不需要粘贴任何 API key、token、cookie 或账号密码。这个 skill 默认只操作本地 Markdown 笔记。
二、收到回答后,先整理配置映射
收到用户回答后,先整理下面的配置映射,再创建文件。
必须使用大写 snake case 变量名:
SKILL_FOLDER_NAME
VAULT_NAME
VAULT_PATH
SOURCE_FOLDER
TOPIC_FOLDER
OUTPUT_FOLDER
RELATED_FIELD
SUMMARY_FIELD
EXTERNAL_LINK_FIELDS
STATUS_FIELD
SOURCE_PENDING_STATUS
SOURCE_DONE_STATUS
TOPIC_ACTIVE_STATUS
TOPIC_DONE_STATUS
OUTPUT_ACTIVE_STATUS
OUTPUT_DONE_STATUS
TOPIC_TEMPLATE_PATH
OUTPUT_TEMPLATE_PATH
CREATE_NEW_NOTES_MODE
RELATIONSHIP_DIRECTION
默认映射:
SKILL_FOLDER_NAME:obsidian-note-organizer
VAULT_NAME:Shiki's Obsidian Starter
VAULT_PATH:AUTO_DETECT_BY_VAULT_NAME
SOURCE_FOLDER:01. 采集 Grasp
TOPIC_FOLDER:02. 归类 Arrange
OUTPUT_FOLDER:03. 表达 Present
RELATED_FIELD:相关笔记
SUMMARY_FIELD:摘要
EXTERNAL_LINK_FIELDS:链接, 原始来源
STATUS_FIELD:tags
SOURCE_PENDING_STATUS:未整理
SOURCE_DONE_STATUS:已整理
TOPIC_ACTIVE_STATUS:进行中
TOPIC_DONE_STATUS:已完成
OUTPUT_ACTIVE_STATUS:进行中
OUTPUT_DONE_STATUS:已完成
TOPIC_TEMPLATE_PATH:模版 Template/02. 归类笔记.md
OUTPUT_TEMPLATE_PATH:模版 Template/03. 表达模版.md
CREATE_NEW_NOTES_MODE:confirm_each_time
RELATIONSHIP_DIRECTION:source_note_links_to_topic_and_output_only
配置变量分类:
- A 类,固定不问:不移动素材笔记;不负责写入素材摘要;写入前必须预览;保留已有链接;只追加缺失链接;外部 URL 不写入关联字段;关联必须用 Obsidian 双链;候选弱相关时必须说明风险。
- B 类,简单偏好:skill 名称、字段名、状态值、新建策略。
- C 类,需要查找或操作:仓库路径、三层文件夹路径、模板路径。
- D 类,敏感凭证:默认没有。不要让用户粘贴任何密钥、token、cookie 或密码。
三、创建文件结构
创建下面的文件夹和文件:
如果当前 AI 工具要求 skill 放在固定目录,请遵守该工具的 skill 安装规则;否则在当前工作区创建这个文件夹。
四、SKILL.md Frontmatter
把下面 frontmatter 写入
SKILL.md 顶部。写入前替换所有 {{变量名}}:五、写入 SKILL.md 正文
写入前,把第三节、第四节、以及下方正文
## Configuration 章节中所有 {{变量名}} 占位符,统一替换为第二节整理出的实际值。替换完成后,正文中不应存在任何剩余的 {{}} 占位符。将以下内容写入
SKILL.md:六、创建后检查并测试
创建完成后,做这些检查:
- 确认
{{SKILL_FOLDER_NAME}}/SKILL.md存在。
- 检查
SKILL.md中没有残留{{或}}占位符。
- 检查没有残留任何安装者之外的私人绝对路径,例如
/Users/<name>/...、C:\\Users\\<name>\\...。
- 检查没有要求用户粘贴 token、cookie、API key 或密码明文。
- 检查默认逻辑没有绑定
Readwise、ARRANGE、PRESENTS这些个人命名;它们只能作为用户自定义层级的例子。
- 检查正文明确要求先确认关联方案,再写入文件。
- 检查正文明确说明:默认只把主题 / 产出链接写入素材笔记,不把素材链接批量反向写入主题 / 产出笔记。
然后给用户一条功能验证请求:
期望行为:
- AI 找到配置的 Obsidian 仓库和三层文件夹。
- AI 读取一篇待整理素材笔记的轻量上下文。
- AI 扫描主题层和产出层候选。
- AI 用 Markdown 和少量 emoji 给出完整整理方案包。
- AI 不立刻改文件。
- AI 等用户确认后,才写入关联字段和状态;除非用户明确要求,不写入或改写摘要。
最后告诉用户:
- skill 文件夹位置。
- 创建了哪些文件。
- 以后可以用什么话触发,例如「帮我整理这篇采集笔记,并关联到主题和表达笔记」。