chengyi-ai/cy-carousel-skill

解決する課題

本プロジェクトは、単一の概念、論文、または製品に基づいて、高品質な10ページのビジュアルカルーセル（1440x1920）を作成するための構造化されたワークフローとツールセットを提供します。教育コンテンツのレイアウトとレンダリングを自動化し、一貫したプロフェッショナルな美学（ダークまたはライトの紙の背景、書道のタイトル、ハイライトされた紙のストリップ）を維持しながら、厳格な事実の正確性とライセンス遵守を強制します。

仕組み

システムは一連の Python スクリプトを使用して、トピックから最終パッケージまでを処理します：

1. トピックの選択と検証：トピックを特定し、PyMuPDF を使用して元の文章を特定し、一次ソースと照らし合わせて事実を検証します。
2. 素材の収集：オープンライセンスの素材を収集し、その SHA256 ハッシュと権限を記録します。
3. 手動レイアウト (Hand-arrangement)：scripts/手排.py を使用して、画像、紙のストリップ、赤い円、およびテキスト要素（見出し、本文、ラベル）を各ページにプログラムで配置します。
4. レンダリング：scripts/render.py はレイアウトスクリプトを最終画像に変換し、書道タイトルの英語/数字のフォント切り替えを処理します。
5. チェック：scripts/check_all.py は、テキストのオーバーフロー、ページ番号の欠落、その他の「レッドライン」違反がないか技術的なチェックを実行します。
6. パッケージング：scripts/package.py は、最終的な画像とメタデータを配信フォルダにまとめます。

対象ユーザー

手動のグラフィックデザインソフトウェアを必要とせずに、ソーシャルメディア向けに視覚的に印象的で事実に基づいた教育用カルーセルを作成したいコンテンツクリエイター、研究者、AI教育者。

ハイライト

• 厳格な品質管理：事実の追跡可能性を確保し、オープンライセンスの素材のみを使用するための「レッドライン」システムを実装しています。
• プロフェッショナルなタイポグラフィ：特定のフォントの組み合わせ（例：馬善政書体）や、改行と配置に関する正確なレイアウトルールをサポートしています。
• AIエージェント対応：Claude Code および Codex の「スキル」として設計されており、AIエージェントがレイアウトスクリプトを生成し、プロセスを管理できます。
• クロスプラットフォーム対応：Windows および Linux で動作し、スキャンされたページ内のOCRベースの単語検索用に macOS Vision 統合を備えています。