utility-pdf-compress

name	utility-pdf-compress
description	qpdf で PDF を品質劣化なし (ロスレス) で圧縮する。画像の再エンコードは行わないため画質・フォント・レイアウトは完全に維持される。「PDF を圧縮して」「PDF のサイズを減らして」「品質を落とさずに PDF を軽くして」などのリクエストで起動。画質を犠牲にしてでも大幅に減らしたい依頼 (ダウンサンプリング) は対象外。
argument-hint	<入力PDFのパス> [出力先パス]
allowed-tools	Bash

PDF ロスレス圧縮 (qpdf)

qpdf の構造最適化 (ストリーム再圧縮・オブジェクトストリーム化) で PDF をロスレス圧縮する。画像・フォント・ベクターデータは一切再エンコードしないため、品質は完全に維持される。

前提

• qpdf がインストール済みであること (qpdf --version で確認)。無ければユーザに報告して停止する
• 入力 PDF が存在すること。パスが渡されていなければユーザに確認する

手順

1. 圧縮前の情報取得

stat -f "%z" "<input.pdf>"          # バイト数 (Linux は stat -c "%s")
qpdf --show-npages "<input.pdf>"    # ページ数

2. 圧縮実行

元ファイルは上書きしない。出力先の指定がなければ、入力と同じディレクトリに <basename>_compressed.pdf として出力する。

qpdf --recompress-flate --compression-level=9 \
  --object-streams=generate --stream-data=compress \
  "<input.pdf>" "<output.pdf>"

• --recompress-flate --compression-level=9: 既存 flate ストリームを最高圧縮率で再圧縮 (ロスレス)
• --object-streams=generate: オブジェクトをまとめて圧縮ストリーム化
• --stream-data=compress: 非圧縮ストリームを圧縮

暗号化済み PDF で失敗した場合は --decrypt の追加をユーザに提案する (パスワード保護が外れる旨を明示して確認を取る)。

3. 整合性検証

qpdf --check "<output.pdf>"           # エラーがないこと
qpdf --show-npages "<output.pdf>"     # ページ数が圧縮前と一致すること

いずれかが失敗したら出力ファイルを削除し、エラー内容をユーザに報告する。

4. 結果報告

以下を報告する:

• 圧縮前後のサイズと削減率 (例: 3,498,937 → 3,259,391 bytes (6.8% 削減))
• 整合性検証の結果 (qpdf --check パス / ページ数一致)
• 出力ファイルのパス

削減率の目安と限界

ロスレス圧縮のため、削減率は PDF の中身に依存する:

• 効果が出る: 非圧縮・低圧縮ストリームやオブジェクト構造に無駄がある PDF (例: フォント・ベクター主体のスライドで 5〜10% 程度)
• ほぼ縮まない: JPEG 画像主体の PDF (JPEG データはロスレスでは再圧縮できないため削減率 1% 未満もありうる)

削減率が 1% 未満だった場合は「この PDF は既に圧縮済みデータ (JPEG 等) が大半で、品質を維持したままではこれ以上縮まない」旨を報告する。画質を落として大幅削減したい場合は Ghostscript 等によるダウンサンプリングが必要だが、それは本スキルの対象外なので提案に留める。