canghe-cover-image
Generates article cover images with 5 dimensions (type, palette, rendering, text, mood) combining 9 color palettes and 6 rendering styles. Supports cinematic (2.35:1), widescreen (16:9), and square (1:1) aspects. Use when user asks to "generate cover image", "create article cover", or "make cover".
1How It Works & Mechanism
Deconstructs "what the cover looks like" into six confirmable dimensions (Type/Palette/Rendering/Text/Mood/Font) plus aspect ratio, each having value enumerations and default values, ultimately assembling a structured prompt.
Generate elegant cover images for articles with 5-dimensional customization.
Provides an automatic selection mapping table of "content signal -> value" when dimensions are missing.
Auto-selection rules: [references/auto-selection.md](references/auto-selection.md)
Confirmation is a soft gate: skipped only with --quick or when all dimensions are specified; aspect ratio is still asked unless explicitly provided via --aspect.
| `--quick` or `quick_mode: true` | 6 dimensions | Aspect ratio (unless `--aspect`) |
Persists the prompt to disk as prompts/cover.md (including frontmatter references) prior to generation.
**CRITICAL - References in Frontmatter**:
Routes reference images by purpose: direct pass-through via --ref, while style/palette features are extracted and appended to the prompt.
- `direct` usage → pass via `--ref` (use ref-capable backend)
Output directory and artifact structure are fixed, defaulting to an independent folder at cover-image/{topic-slug}/.
- `independent` (default): `cover-image/{topic-slug}/`
Enforces strict composition and text rules: 40-60% negative space, simplified silhouettes for characters, and exact user/original text for the title.
- **Whitespace**: 40-60% breathing room
Backs up existing assets before regeneration, requiring the prompt file to be updated prior to re-generating.
| **Regenerate** | Backup → Update prompt file FIRST → Regenerate |
2Core Capabilities
3External Dependencies
| Kind | Dependency / Endpoint |
|---|---|
| api | 图像生成 skill(Step 4 在宿主可用 skill 中挑选;多个时问用户偏好,SKILL.md 未点名具体后端) |
4Recommended Governance & Evidence
- 本地工作目录: File read/write and artifact output: Agent writes to disk driven by SKILL.md instructions, saving source-{slug}, refs/ under cover-image/{topic-slug}/
- SKILL.md: Declares invocation of host CLI interpreters or external execution environments
5Second-Pass Verification
- [ok] 自身目录无任何脚本或可执行文件 — 文件清单只有 .md;扫描“执行外部程序/写盘/网络请求”均为 0 命中,脚本执行面为空。
- [discrepancy] 外部生成后端名称 — SKILL.md 仅写 'Check image generation skills; if multiple, ask preference',未点名具体后端;出网事实由 skill 的声明用途(生成封面)推出,档位仍为 orange。
- [ok] EXTEND.md 查找只探测存在性 — $HOME 命中仅是 test -f 的存在性判断,未读取文件内容之外的凭证或环境变量。
- [ok] 维度取值集合一致 — SKILL.md Five Dimensions 表与尺寸/palette 目录文件数对齐;prompt 模板与确认流程均存在。
- [ok] 参考图分流与自检 — Step 3/4 要求 frontmatter 列 references、写入前 test -f、direct 走 --ref、style/palette 抽取特征,规则闭环。
- [ok] meta 元数据 — commit dd0bf355…、path skills/canghe-cover-image、license MIT 与 bundle §0 核定值一致。
6Verdict & Scenarios
92d75c156ff10b20…