SuperAPI AI 工具集

video-note

写作与研究

查看项目

更新于 10-16 09:10

技能介绍

用途

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"

转换工作流

  1. 读取源 Vault 笔记。
  2. 从 source URL 中提取视频 ID。
  3. 用 Joel 的口吻撰写笔记(参考同一 .agents/skills/ 目录下的 joel-writing-style skill)。关键规则:以钩子开头而非摘要;在相关处使用 Joel 提供的表述框架,绝不虚构其经历、观点或个人反应;使用短段落、策略性脏话、加粗强调;结尾戛然而止,不做勉强的收束。
  4. 在引言之后用 <YouTube id="VIDEO_ID" /> 嵌入视频。
  5. 选择适合发布受众、且有来源支撑的材料,排除完整转录、私人上下文、客户信息和付费语料。随后改编相关部分:Executive summary → 改写为引言(Joel 的口吻);Key points → 保留实质、精炼行文;Speaker context → “Who is [Speaker]” 小节;Notable quotes → 精选的 “Quotes that stuck with me”;Related links → 保留为 “Related” 小节。
  6. 去除 Obsidian 语法:> [!info] 提示框转为纯文本,[[wikilinks]] 转为 markdown 链接。
  7. 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 的安装方式、依赖要求、收费或价格、运行平台及自动化程度等信息。