1仕組みと動作原理
「どのようなカバーにするか」を6つの確認可能な次元（Type/Palette/Rendering/Text/Mood/Font）＋アスペクト比に分解し、各次元に選択肢とデフォルト値を設けて構造化プロンプトを組み立てる。
skills/baoyu-cover-image/SKILL.md
Generate elegant cover images for articles with 5-dimensional customization.
SKILL.md の Five Dimensions 表に各次元の選択肢とデフォルト（Text は title-only、Mood は balanced、Font は clean、Aspect は 16:9）が定義されている。Font は実質的な第6の次元（概要文ではカウント外）。
次元が未指定の場合、「コンテンツ信号 → 値」の自動選択テーブルにより、キーワードの一致に基づいてコンテンツタイプ、カラーパレット、レンダリング手法、テキスト量、ムード、フォントを1対1でマッピングする。
skills/baoyu-cover-image/references/auto-selection.md
When a dimension is omitted, select based on content signals.
例: 'Education, tutorial, knowledge, onboarding, concept explainer → macaron'、'Poster, movie, album, concert, silhouette, mondo, limited-edition → screen-print'。デフォルト値は主に Text/Mood/Font の3箇所に集約されている。
確認は厳格なゲートとなっており、単にテキストの表を提示するのではなく、ホストの対話ツール（AskUserQuestion または同等機能）を使って選択可能な質問形式にする必要がある。
skills/baoyu-cover-image/SKILL.md
**MUST use `AskUserQuestion` tool** to present options as interactive selection — NOT plain text tables.
1バッチあたり最大4問まで。--quick / quick_mode: true が指定されている場合、または6次元と --aspect がすべて指定されている場合のみスキップ可能。アスペクト比は明示的に --aspect が与えられない限り必ず確認する。
生成前にプロンプトを prompts/cover.md（content context / visual design / text elements / mood / font / composition の各セクションを含む）として保存し、frontmatter に references リストを含める。
skills/baoyu-cover-image/SKILL.md
Save to `prompts/cover.md`.
書き込み前に参考画像ファイルの存在確認（test -f）を義務付けている。本文では色指定を「レンダリング指示」に限定し、hex値や色名を画像上の可視テキストとして描画することを明示的に禁止している。
参考画像は「優先度の高い視覚的入力」として扱い、--ref を渡すだけでは不十分であり、再現すべき要素をプロンプト本文内でも同時に言語化する必要があると警告している。
skills/baoyu-cover-image/references/workflow/prompt-template.md
**Passing `--ref` alone is NOT enough.**
--ref をサポートしないモデル（ドキュメント内では Jimeng、Seedream 3.0 を名指し）の場合は、refs/ref-NN-{slug}.md にキャラクターごとのテキスト説明を記述し、MUST/REQUIRED プレフィックスを付けてプロンプトに埋め込む代替策をとる。
バックエンドの解決はリポジトリの統一ルールに従う: リクエストによる指定 > EXTEND.md の設定 > 自動選択（Codex imagegen > codex-imagegen > Cursor GenerateImage > その他のネイティブ > 唯一インストール済みのもの > ユーザーに確認）。
skills/baoyu-cover-image/SKILL.md
**Codex (`imagegen`)** — first, inspect your available-skills / tool inventory.
スキルが単一の生成バックエンドを指定する構成であることの根拠。生成時にはプロンプトファイル、出力パス、アスペクト比をバックエンドに渡し、失敗時は自動で1回リトライする。
構図とテキストに関する厳格なルール: 余白40〜60%、人物は簡略化されたシルエットのみ、タイトルはユーザー/原文の正確なタイトルを使用し勝手に創作しない。文字の誤りはプロンプトを修正して再生成することとし、画像上でのレタッチは禁止する。
skills/baoyu-cover-image/SKILL.md
**Title**: Use exact title from user/source; never invent
同セクションには「Characters: Simplified silhouettes; NO realistic humans」とも記載。修正手順として「regenerate from a corrected prompt, switch to a lower-text or no-title variant」が明記されている。
出力ディレクトリと成果物の構造は固定: デフォルトでは independent モードで cover-image/{topic-slug}/ に保存され、内部に source、refs/、prompts/cover.md、cover.png が含まれる。再生成前には既存画像をバックアップする。
skills/baoyu-cover-image/SKILL.md
- `independent` (default): `cover-image/{topic-slug}/`
Step 4 の項目1で「Backup existing cover.png if regenerating」を義務付け。Slug は2〜4単語の kebab-case とし、重複時はタイムスタンプを付与する。
2コア機能
016次元のカバーカスタマイズ ＋ プリセットによるショートカット（--style で一括指定可能）
02コンテンツ信号に基づく自動選定（11パレット / 7レンダリング / 6タイプ / テキスト量 / ムード / フォント）
03構造化プロンプトテンプレート（Content Context / Visual Design / Text Elements / Composition のセクション分け ＋ frontmatter references）
04参考画像のハンドリング: --ref 対応モデルには直接渡し、非対応モデルにはキャラクターごとのテキスト説明に変換
05生成前後の検証とバックアップ（参考画像の test -f、cover.png のバックアップ、失敗時の1回リトライ）
06多彩なアスペクト比対応（16:9 / 2.35:1 / 4:3 / 3:2 / 1:1 / 3:4）、明示的な指定がない限り確認を実施
07プレースホルダーおよび色指定の規律（カラー値はレンダリング指示のみとし、画像上の文字として出力させない）
08ユーザー設定の永続化（EXTEND.md: watermark / preferred_* / default_aspect / quick_mode / language）
3外部依存関係
| Kind | Dependency / Endpoint |
|---|---|
| api | Codex 原生 imagegen skill（Skill 工具调用） |
| cli | codex CLI / baoyu-image-gen（codex-imagegen 分支） |
| api | Cursor 原生 GenerateImage / Hermes image_generate |
| network | codex-imagegen wrapper（自述认证走用户 Codex 订阅） |
4推奨統制措置と判定根拠
安全運用のための推奨統制措置
Agent 向け
段階的・都度認可、サンドボックス推奨
管理者向け
承認フロー、ロールバック可能、全履歴監査
判定根拠（ファイルパスと抜粋）
- 本地工作目录: ファイルの読み書きと成果物の出力: SKILL.md の指示に基づき、エージェントが cover-image/{topic-slug}/ 配下の source-{slug}、refs/（参照画像）をディスクに保存
- SKILL.md: ホストのCLIインタープリタまたは外部実行環境の呼び出しを宣言
監査ノート： (a) SKILL.md にて実行時に呼び出す外部生成バックエンドが明記されている: '**Codex (`imagegen`)** — first, inspect your available-skills / tool inventory.' および 'route through `baoyu-image-gen --provider codex-cli` (preferred)'（Cursor `GenerateImage`、Hermes `image_generate` も同様のルール）。SKILL.md に従った実行により、記事のタイトル/要約/キーワードおよび参考画像が外部のサードパーティ画像モデルへ送信され、ユーザーアカウントのクォータを消費する。(b) ローカルディスクへの書き込みが明確に存在: prompts/cover.md、refs/、cover.png、EXTEND.md。(c) 当該スキルディレクトリ自体にはスクリプト、内蔵ネットワークエンドポイント、認証情報の読み取り処理は含まれず、通信および認証情報の取扱いは呼び出されるバックエンド側に委ねられているため、red（重大リスク）とは判定しない。類似事例（ai-image-generation、nano-banana-2 など）に準じ、生成バックエンドへ素材を送信する処理として orange と評価する。
5二重目の独立検証
- [ok] 自身无脚本/无端点/无凭证 — 目录内全是 markdown；URL 扫描只命中 github.com/JimLiu/baoyu-skills。
- [ok] SKILL.md 点名生成后端（orange 依据） — Codex imagegen / codex CLI via baoyu-image-gen / Cursor GenerateImage / Hermes image_generate 均在 SKILL.md 正文，且写成“一次选定、生成前必须完成”。
- [ok] 维度数量说法核对（描述写 5 dimensions） — SKILL.md 正文 Actually 列 Type/Palette/Rendering/Text/Mood 五维于 Five Dimensions 表，Font 单列在枚举与 Options 中——描述与正文不冲突，侦查按正文六项记录。
- [ok] 文字/色值纪律 — prompt-template.md 的 Color constraint 与 SKILL.md 的 Title/Characters/Composition Principles 三处对得上；位图涂改禁令与 article-illustrator 同款。
- [ok] 参考图不支持 --ref 时的降级路径 — SKILL.md Step 1 与 reference-images.md 一致：写 refs/ref-NN-{slug}.md 逐人物描述，并以 MUST/REQUIRED 嵌入 prompt。
- [ok] meta 元数据 — GitHub API：MIT、25926 stars、pushed_at 2026-09-10T15:13:43Z；本地 HEAD 与 pin 1567581c26ec… 一致。
6結論
最適な用途： 安定したビジュアル規準でカバー画像を生成したいブログ、WeChat公式アカウント、技術記事の執筆者に向いており、トピックごとにバッチ作成しつつ色彩やフォントの統一感を保ちたい場合に適しています。また、カバーのデザイン決定を構造化されたワークフローに落とし込みたいチームにも最適です。
不向きな用途： 厳密なタイポグラフィ（ピクセル単位のアライメントなど）が要求されるカバー（デザインツールの使用を推奨）、外部へのデータ送信が厳格に禁止されている環境、デフォルト値を受け入れられない非対話型のホスト環境には適していません。
Install Agent-Ready
① Verified Mirror 2026-09-15
Option A · Direct DownloadDownload baoyu-cover-image.tar.gz
sha256:
Option B · Copy Guide for Agente68671656994141a…Agent はこの JSON ガイドから自動的にダウンロードして検証します。
② Upstream GitHub
GitHub Repo ↗
Pinned to commit 1567581c26.