test(speakerdeck-knowledge): 画像処理の回帰テストと利用手順を補完

[9uiLe]

概要

SpeakerDeck の画像を段階的に取得・加工する際のキャッシュ再利用、失敗時の扱い、出力仕様を、回帰テストと利用手順で明確にします。最新の master を取り込み、前の PR に含まれていなかった11ファイルの差分を反映します。

関連 Issue

Refs #102

対象プラグイン

• その他: speakerdeck-knowledge
• marketplace / リポジトリ全体

変更の種類

• ドキュメント (docs)
• リファクタリング / 内部改善（回帰テストを含む）

変更内容

• 画像取得 CLI の段階的な実行を検証し、取得状態の保持、指定した失敗ページのみの再取得、既存画像の再利用を確認する。
• 画像生成の JSON 出力形式・終了コード、EXIF の向きを反映した切り出し、途中失敗時の生成済みファイルの保持をテストする。
• 取得・画像生成の引数、出力先、終了コード、観察メモを記録する主体を README・参照資料・CLI ヘルプで明確にする。
• 画像生成キャッシュのバージョンを定数化し、不要になった .gitattributes と古い ADR への参照を整理する。

動作確認

• python3 -m unittest discover -s plugins/speakerdeck-knowledge/tests -v（22件成功）
• bash scripts/verify-versions.sh
• shellcheck -S warning -x scripts/*.sh scripts/lib/*.sh scripts/tests/*.sh
• git diff --check
• master 取り込み前後のパッチが完全に一致し、残っていた差分を保持していることを確認

チェックリスト

• 既存の挙動を壊していない（補助スクリプトの回帰テストで確認）
• README など関連ドキュメントを更新した

バージョン変更は含みません。ローカル Marketplace への登録と AI による資料生成は今回の検証対象外です。