将任意 YouTube 视频链接转换为结构化中文深度解读文章或对话体逐字稿，并自动归档至 Notion 与 Obsidian。适用于 AI/科技讲座、播客访谈、行业大会演讲等内容类型。
环境配置与使用指南 → PLAYBOOK.md
📄 查看完整 Blog 预览图
在 Claude Code 中打开此目录，发送 YouTube 链接，工作流自动执行以下步骤：
- 抓取字幕 — 调用 youtube-transcript.io API 获取带时间戳的完整字幕，同时保存为本地
transcript.json - 意图路由与生成 — 根据用户输入（例如"生成深度文章"或"整理逐字稿"），调用
skills/article_generation.md或skills/dialogue_transcript.md中的规范，生成对应的 Markdown 输出 - 归档文件 — 按系统自动生成的中文标题建立子目录，保存对应的 Markdown 文件（如
<标题> - 深度文章.md或<标题> - 逐字稿.md）与原始字幕数据 - 同步 Notion — 上传文章内容（含封面图、元数据），已有页面自动归档旧版本后重建（幂等）
- 同步 Obsidian — 将带 YAML frontmatter 标签的 Markdown 复制到 Second Brain 目录
.
├── CLAUDE.md # 系统 Prompt，控制 Agent 执行逻辑
├── fetch_transcript.py # 字幕抓取脚本（支持 --output 参数）
├── notion_upload.py # Notion 上传脚本（幂等 upsert）
├── tags.json # 标签字典（约束分类标签与双链术语的边界）
├── skills/
│ ├── article_generation.md # 深度解读文章生成规范
│ └── dialogue_transcript.md # 对话体逐字稿生成规范
├── logs/
│ ├── workflow_execution.md # 每次执行记录
│ └── system_changelog.md # 系统架构变更日志
├── output/
│ └── <生成的中文标题>/
│ ├── <生成的中文标题> - 深度文章.md
│ ├── <生成的中文标题> - 逐字稿.md
│ └── transcript.json
├── requirements.txt
├── .env.example
└── .gitignore
| 层级 | 文件 | 职责 |
|---|---|---|
| 控制层 | CLAUDE.md |
定义执行步骤与异常处理规则，是 Agent 的唯一入口 |
| 技能层 | skills/ |
存放按需加载的专项规范，与控制层解耦 |
| 数据层 | tags.json |
强约束标签收敛，防止知识库发散 |
| 执行层 | *.py |
各步骤对应的独立脚本，可单独调用 |
| 观测层 | logs/ |
执行日志与系统变更记录，本地保留不进 Git |
| 输出层 | output/ |
按视频标题归档的 Markdown 文章与字幕原文 |