用途
video-note 用于把 Obsidian Vault 中的视频笔记转换为 joelclaw.com 网站上发布的 MDX 笔记。源笔记存放于 /Users/joel/Vault/Resources/videos/,发布产物写入站点内容目录 apps/web/content/。适用于发布视频笔记、把 Vault 视频内容转换到站点等场景。
源格式
Vault 视频笔记是 Obsidian markdown,frontmatter 字段包括:
- type: video
- source: 视频 URL(如 https://www.youtube.com/watch?v=ID)
- channel: 频道名称
- published: YYYY-MM-DD
- duration: "HH:MM:SS"
- nas_path: /volume1/home/joel/video/...
- transcribed: YYYY-MM-DD
- tags(含 video 等)
正文包含:H1 标题、> [!info] Source 提示框、Executive Summary、Key Points、Speaker Context、Notable Quotes、Related links、Tags,以及可折叠的 Full Transcript。
输出格式
以 .mdx 形式发布到 apps/web/content/,frontmatter 包括:
- title: 简短描述性标题
- type: "note"
- date: "YYYY-MM-DD"(使用当天日期)
- description: 一句吸引人的开头(以 Joel 的口吻)
- source: 视频 URL
- channel: 频道名称
- duration: "HH:MM:SS"
转换工作流
- 读取源 Vault 笔记。
- 从 source URL 中提取视频 ID。
- 用 Joel 的口吻撰写笔记(参考同一 .agents/skills/ 目录下的 joel-writing-style skill)。关键规则:以钩子开头而非摘要;在相关处使用 Joel 提供的表述框架,绝不虚构其经历、观点或个人反应;使用短段落、策略性脏话、加粗强调;结尾戛然而止,不做勉强的收束。
- 在引言之后用 <YouTube id="VIDEO_ID" /> 嵌入视频。
- 选择适合发布受众、且有来源支撑的材料,排除完整转录、私人上下文、客户信息和付费语料。随后改编相关部分:Executive summary → 改写为引言(Joel 的口吻);Key points → 保留实质、精炼行文;Speaker context → “Who is [Speaker]” 小节;Notable quotes → 精选的 “Quotes that stuck with me”;Related links → 保留为 “Related” 小节。
- 去除 Obsidian 语法:> [!info] 提示框转为纯文本,[[wikilinks]] 转为 markdown 链接。
- Slug 采用 kebab-case 且简洁(例如 openclaw-peter-steinberger-lex-fridman)。
口吻参考
关于 Joel 的写作风格细节,阅读 joel-writing-style 的 SKILL.md 及其口吻示例。要点:第一人称仅用于 Joel 已记录的言辞或提供的经历;在有用时直接对读者说话;始终使用缩写;用加粗对关键短语做行内强调;谨慎使用 emoji(每篇最多 1–2 个);标题作为叙事节拍而非提纲;链接融入句子,绝不使用“点击这里”;点名并链接到相关人员。
内容系统细节
joelclaw.com 的内容类型、MDX 组件和路由参见 content-system.md。完整的目标格式与口吻示例参见 example-note.md。
限制
资料未提供该 Skill 的安装方式、依赖要求、收费或价格、运行平台及自动化程度等信息。