关于 kb-yt-channel
用于将 YouTube 频道或播放列表视频导入知识库的工作流技能。它结合 `kb ingest channel` 与辅助脚本,支持主题整理、元数据、索引、验证和运行报告。
主要功能
- 01解析频道或播放列表输入
- 02选择视频及转录策略
- 03按主题整理内容
- 04为导入材料建立索引并验证
- 05查看运行报告与失败项
适用场景
- 01将频道视频导入知识库
- 02限定导入指定视频
- 03出错后继续导入
- 04索引后检查主题内容是否可搜索
安装
复制下面的命令,在终端中运行。
$
npx skills add https:/ / github.com/ pedronauck/ skills --skill kb-yt-channel安装后在 Claude Code 中输入/kb-yt-channel确认已加载。
包含的文件
除 SKILL.md 外,安装时一起下载的参考资料和脚本。
assets/report-template.mdreferences/channel-topic-contract.mdtroubleshooting.mdscripts/ingest-channel.py详细介绍
KB YouTube 频道
使用原生的 kb ingest channel 处理频道解析、字幕转录、去重与续传、重试和请求间隔。捆绑的 scripts/ingest-channel.py 会在 yt-channels/ 下添加主题组织、元数据、索引、验证和运行报告。
- 根据请求确定知识库位置、频道/播放列表 URL、主题 slug/标题/领域、视频选择(
--limit N或--all)以及字幕转录策略(captions、auto或stt)。只询问无法合理推断的选项。 - 检查必需工具时仅检查一次,并复用当前已有的证据:
kb、yt-dlp,以及用于建立索引的qmd;如果请求 STT,还需检查ffmpeg和已配置的提供方。默认的预检中不要安装可选的网络依赖项。 - 使用
--vault、--channel-url、--topic-slug、--title、--domain、视频选择参数和--transcribe运行python3 <kb-yt-channel-dir>/scripts/ingest-channel.py。从此技能目录解析辅助脚本。默认使用原语言字幕;仅在需要时覆盖--sub-langs。--no-index会延后建立索引;--embed会请求生成嵌入。 - 预览是可选的。现有的
--dry-run会创建/更新主题框架和元数据,然后列出摄取计划,但不会处理字幕转录;它不是只读预览。仅在已获授权创建/更新主题的范围内使用。不要强制要求先预览,再重复完整预检。 - 检查辅助脚本的 JSON 摘要和失败项。复用其已完成的主题信息/lint/索引验证;仅在缺少证据时补充检查。如果任务包含验证可搜索性,则在建立索引后,于该主题/集合中验证一次有代表性的
kb search。 - 报告实际摄取/跳过/失败的数量以及报告路径。仅当任务包含综合整理时才编写 wiki 文章;仅摄取字幕转录并不意味着需要编写文章。
失败处理与参考资料
首先使用现有网络配置,以及原生的有限重试/退避机制。遇到速率限制时,遵循服务器指引、降低并发量或延长请求间隔。仅当实际遇到访问/网络问题时,才配置经过身份验证的 Cookie 或获准使用的代理;绝不要泄露凭据,也不要为大型频道强制要求使用住宅代理。
如需了解元数据/输出详情,请阅读 references/channel-topic-contract.md;如需查看实际故障案例,请阅读 references/troubleshooting.md。修复后继续处理同一请求;原生去重机制会保留已成功摄取的内容。缺少字幕时,如果相应范围和提供方费用已获授权,可使用 auto/STT。保留部分输出;针对特定字幕转录,使用受支持的刷新方式,而不是默认删除用户数据。
评论
支持 Markdown