z-skills

z-skills 是一组可复用的本地 Agent Skills，用来把常见工作流沉淀成稳定能力：网页素材采集、视频下载、视频学习网页、文档解析、邮件读取、表格处理、Markdown 转 Word、证据型资料问答、docx 模板格式刷、手写幻灯片、手写 HTML 动画，以及文章四格漫画配图

这些 skill 默认面向中文创作、知识管理和自动化任务，适合放到本地 .agent/skills/ 或 Codex/Claude Code 等支持 Skills 的环境里使用

z-web-pack 负责网页素材包采集，包含正文、正文相关链接、图片、本地阅读地图、媒体链接清单，以及受限来源恢复说明

z-video-downloader 负责视频下载，包含 YouTube、Bilibili、Vimeo、X/Twitter、TikTok、抖音、Instagram、Facebook、微信视频号、m3u8 和常见视频直链，并支持断点续传、批量清单、字幕、封面和下载历史。视频号分享链接（weixin.qq.com/sph/）通过在线解析服务自动获取视频地址，无需额外安装

z-web-pack 发现视频时只写入 04-media-inventory.md。如果要把视频保存到本地，把清单中的 Source URL 交给 z-video-downloader

/Users/zz/miniconda3/bin/python3 z-web-pack/scripts/collect_web_pack.py \
  --out-root "/Users/zz/Library/Mobile Documents/iCloud~md~obsidian/Documents/zhangAI/Clippings/Reading" \
  --title "主题名" \
  --max-depth 0 \
  --max-pages 1 \
  "https://example.com/article"

输出里重点看：

• README.md
• 00-research-brief.md
• 01-link-inventory.md
• 02-image-inventory.md
• 03-reading-map.md
• 04-media-inventory.md

/Users/zz/miniconda3/bin/python3 z-video-downloader/scripts/download_video.py \
  --title "主题名" \
  "https://www.bilibili.com/video/BV..."

如果视频链接来自网页素材包，使用 04-media-inventory.md 里的 Source URL

也可以直接读取媒体清单：

/Users/zz/miniconda3/bin/python3 z-video-downloader/scripts/download_video.py \
  --inventory "/path/to/04-media-inventory.md"

把需要的 skill 目录复制到本地 skills 目录：

cp -R z-xkcd-panda-comic "/path/to/your/.agent/skills/"

如果希望一次性安装全部：

cp -R z-* "/path/to/your/.agent/skills/"

安装后，新会话开始时，Agent 会根据每个 SKILL.md 的 name 和 description 自动匹配触发词

通过 npx skills 单独安装通用证据问答 Skill：

npx skills add tjxj/z-skills --skill z-grounded-source-qa

z-md-to-word 用来把本地 Markdown 文章转换成 Word 文档，适合公众号文章、Obsidian 笔记、商单稿件和需要交付 .doc / .docx 的场景。

它会自动处理几个常见问题：

• 保留 Markdown 标题、作者和日期
• 写入远程图片和本地图片
• 跳过空上传占位符
• 修正常见列表识别问题
• 生成后检查文档是否能打开和渲染

默认输出：

output/doc/<原文件名>.docx
output/doc/<原文件名>.doc

z-docx-format-brush 用来把一份模板 docx 的格式"刷"到另一份 docx 上，核心思想是格式参数从模板实测提取、收敛到唯一出口应用

典型场景：

• 修复 pandoc / 大模型产出的格式混乱 docx（字体混排、标题带蓝色、表格无边框、引号反向）
• 参照模板从零生成格式一致的公文类文档
• 诊断两份 docx 的格式差异

三步工作流：

# 1. 解剖模板 → 格式指纹 JSON
python3 z-docx-format-brush/scripts/extract_fingerprint.py 模板.docx --json fp.json

# 2A. 从零新建：结构化内容统一经过格式工厂
python3 z-docx-format-brush/scripts/gen_from_template.py content.json --config fp.json --out 新文档.docx

# 2B. 修复已有文档：五层格式刷（样式/段落/封面/表格/文字）
python3 z-docx-format-brush/scripts/apply_format.py 目标.docx --config fp.json

# 3. 验证收敛度，退出码 0 才算完成
python3 z-docx-format-brush/scripts/verify_format.py 目标.docx

详细方法论和踩坑记录见 z-docx-format-brush/README.md

z-xkcd-panda-comic 用来把文章或主题变成一张 2x2 四格漫画，默认风格是：

• 黑白手绘漫画
• 金馆长熊猫表情味 / 金教授熊猫脸
• 中文短对白
• xkcd 式冷幽默节奏
• 适合插入公众号、Obsidian、Markdown 文章

它会先提炼文章核心观点，再设计四格节奏：

1. 设定痛点或误会
2. 普通办法暴露荒诞
3. 熊猫角色给出解决动作
4. 用一句话收束核心观点

目录内包含一张参考风格图：

z-xkcd-panda-comic/assets/reference-codex-computer-housekeeper-panda-comic.png

• 每个 skill 都以自己的 SKILL.md 为准
• 有脚本的 skill 优先使用脚本，避免手工重复操作
• 处理外部文件、邮件、视频和网页时，先确认路径、链接和权限
• 生成文章或图片后，尽量做一次实际查看或运行验证
• 网页素材采集和视频下载分开维护，降低单个 skill 的复杂度
• 视频平台风控、cookie、画质、播放列表等逻辑统一放在 z-video-downloader
• z-web-pack 的媒体清单只做发现和转交提示，避免采集资料时意外下载大文件
• 单篇新闻默认使用保守采集模式；遇到付费墙或验证码时保留受限说明，再补公开来源
• 视频下载支持 .part 续传；输入无效时会在创建空目录前停止

z-skills/
  z-wanghong-handwritten-ppt/
    SKILL.md
    templates/
    assets/
    examples/
    references/
    scripts/
    evals/
  z-wanghong-handwritten-video/
    SKILL.md
    scripts/
    examples/
    references/
    tests/
    evals/
  z-xkcd-panda-comic/
    SKILL.md
    assets/
    evals/
  z-docx-format-brush/
    SKILL.md
    README.md
    scripts/
  z-md-to-word/
    SKILL.md
    README.md
    scripts/
    evals/
  z-video-downloader/
    SKILL.md
    scripts/
    tests/
  z-video-study-webpage-qwen/
    SKILL.md
    scripts/
    tests/
  z-liang-wenfeng-grounded-voice/
    SKILL.md
    examples/
    references/
    tests/
  z-grounded-source-qa/
    SKILL.md
    README.md
    scripts/
    references/
    tests/
    evals/
  z-expense-policy-qa/
    SKILL.md
    references/
    scripts/
    examples/
    tests/
    evals/
  ...

新增 skill 时建议包含：

• SKILL.md：触发词、执行流程、输出规范
• scripts/：可复用脚本
• assets/：参考图、模板或固定素材
• evals/：示例输入和评估用例
• README.md：复杂 skill 可单独补充说明

保持触发词清楚、流程可执行、输出可验证，是这个库的核心原则