md-pdf-reportlisted
Install: claude install-skill 0xcjl/md-pdf-report
# md-pdf-report · Markdown 双产物报告（PDF + MD）
**MD 是事实源，PDF 是交付物。** 同一份内容，两个产物：
- `.md` — 可二次编辑、可分发给其他 Agent
- `.pdf` — 打开即看、可分享给他人
（详见下一节"🚨 必做最后一步"）
**核心用户偏好（Jialin）：** 调研类内容要同时产出 PDF（方便看/分享）和 MD（方便二次编辑或分发给其他 Agent）。MD 是单一事实源，不要写两份。
---
## 何时使用
| 触发 | 用法 |
|------|------|
| "做个 PDF 报告" / "转成 PDF" / "给我 PDF 版本" | → 本 skill |
| "调研报告"、"fact-check 报告"、"方案 PDF" | → 本 skill |
| 长文分析（> 1 页 A4）需要可编辑源文件 | → 本 skill |
| 用户说"以后经常用" 类长文输出 | → 本 skill |
**不适用：**
- 简历、一页纸、产品白皮书、品牌文档 → 用 `kami`
- PPT/slides → 用 `kami` 的 slides 路径
- 简短消息/通知 → 直接发文字
- 不需要 PDF，只要 MD → 直接写 .md，不调用本 skill
---
## 快速开始
```bash
# 0. 首次使用：安装 Python 依赖（macOS 系统 Python 缺这两个模块）
pip3 install --user markdown weasyprint
# 注意：pip3 install 的脚本会装到 ~/Library/Python/3.9/bin（不在 PATH）
# 这是正常的；不影响 python3 -m 形式调用
# 1. 选模板（首次使用）
cp ~/.hermes/skills/md-pdf-report/templates/research-report.md ~/my-report.md
# 或 fact-check.md, scheme.md
# 2. 编辑内容（用任何 MD 编辑器）
# 3. 生成 PDF（用绝对路径调用，最稳）
python3 ~/.hermes/skills/md-pdf-report/md2pdf.py ~/my-report.md
# 等价但更短（前提：依赖已装）：
# python3 -m md2pdf ~/my-report.md
# 4. 交付（飞书/Telegram）
# 在对话中：MEDIA:/Users/you/my-report.pdf
```
> ⚠️ **macOS 真实调用姿势**：本 skill 的 `md2pdf.py` 实际位于 skill 根目录（不是 `scripts/` 子目录，SKILL.md 旧版本写错了）。系统 Python (`/usr/bin/python3`) **不预装** `markdown` 和 `weasyprint` 两个包，必须先 `pip3 install --user`。验证命令：`python3 -c "import markdown, weasyprint"` —— 两者都 OK 才能跑成功。
**Python 用法：**
```python
from md2pdf import md_to_pdf
md_to_pdf("report.md") # 同名 .pdf
md_