- name
SKILL.md
Le fichier du skill reste dans le dépôt de l'éditeur.
Collez la commande copiée dans un terminal. Elle installe ce SKILL.md dans cet agent.
npx skills add zenstory-ai/oh-story-claudecode --skill story-cover -a cursor -yCollez la commande copiée dans un terminal. Elle installe ce SKILL.md dans cet agent.
npx skills add zenstory-ai/oh-story-claudecode --skill story-cover -a claude-code -yCollez la commande copiée dans un terminal. Elle installe ce SKILL.md dans cet agent.
npx skills add zenstory-ai/oh-story-claudecode --skill story-cover -a codex -yCollez la commande copiée dans un terminal. Elle installe ce SKILL.md dans cet agent.
npx skills add zenstory-ai/oh-story-claudecode --skill story-cover -a grok -yEnvoyez le message copié dans un chat Grok Bot. Le Bot récupère ce SKILL.md sur GitHub et l'ajoute aux skills que partagent tous vos Bots.
Install this skill: https://github.com/zenstory-ai/oh-story-claudecode/tree/HEAD/skills/story-coverDe l'éditeur
根据书名和题材生成包含书名、笔名的完整封面,让读者一眼看出题材和氛围。
仅提示词模式:用户只要提示词,或 story-publish 选了仅提示词时,只做 Step 1-3,交付完整提示词,不需要生图工具、API Key 或输出目录;要封面图才继续 Step 4-6。由 story-publish 调用时,它传来的已确认书名、简介、笔名、平台和题材不再重问;结束时返回完整提示词原文,生图成功再附图片路径和质量检查结果,失败就说明原因。
$imagegen / image_gen 或 Antigravity generate_image / image-generator 时,直接调用生成并保存,无需 OPENAI_API_KEY 或 GPT_IMAGE_API_KEY,不跑 curl。GPT_IMAGE_API_KEY;变量和命令见 references/api-fallback.md,走该通路再读。工具缺失不等于订阅不支持生图;内置失败先报错,不静默切到收费 API。先找当前书:项目根 .active-book 指向项目内现有目录时就是当前书;否则从项目根往下最多 4 层找(跳过 . 开头的目录、node_modules、拆文库/、对标/),含 追踪/、正文/、设定/ 子目录,或含 正文.md,或同时含 设定.md 与 小节大纲.md 的是书目录,找到多本时请作者选择。有 正文/ 或 设定/ 子目录的是长篇,其余为短篇。找到后读:
设定/题材定位.md「基本信息」的书名、题材类型、目标平台、核心梗;设定.md「基本信息」的标题、目标平台、目标情绪,以及「一句话梗概」「这篇用的套路」(旧书叫「题材招式」)。已有或调用方传入的已确认字段不再问;笔名没有明确提供时才问。没有书目录或缺项时,用宿主可用的提问方式一次问齐缺少的书名、笔名、目标平台。
书名和笔名是封面必需信息:缺任一时先请作者补全,不得编造或留空。
选填:参考图 REF_IMAGE(本地路径或 URL)、风格偏好;参考图的用法见 Step 4。
保存位置:有书目录时存到 {书目录}/封面/,不用问;没有书目录时用 ./covers/{书名}/封面/。下文 BOOK_DIR 指 封面/ 的上一层。
按目标平台定比例和上传尺寸:番茄、起点、七猫常用 600×800(3:4),晋江常用 200×280(约 5:7),未说明规格的平台按竖版 3:4 或 2:3 交付;作者给出上传像素时按该尺寸导出,避免二次裁剪切掉书名或笔名。平台画风见 references/cover-styles.md「平台风格」。
在 references/cover-styles.md 的「风格库」里选一个题材:
仅提示词模式没有题材依据时先问作者,不用下面第 2 条的「都市」兜底。
提示词 = 文字层 + 风格层 + 画面层。设计指令用英文,书名和笔名保留作者提供的原文。所选题材的字体、标签、色彩、人物、背景、光效都在「风格库」同一节里查。
文字层:GPT-Image-2 可直接渲染中文。书名在上方居中,用该题材的书名字体;笔名在下方居中,用该题材的笔名字体。笔名要和书名风格呼应、清晰可读而不抢焦点:
small;位置 at bottom center,与画面底部留出间距;风格层:目标平台在「平台风格」表里有对应时,取它的关键词串;没有对应(如黑岩、点众小程序)时省掉这一层,只靠题材风格。
画面层:题材的风格标签、人物、背景、色彩、光效,加上一种构图(见「构图变体」)。
完整提示词模板(唯一一份,示例和改版都按它拼):
Chinese web novel cover design, [平台风格].
Title text '{书名}' at top center in [书名字体].
Author name '{笔名}' at bottom center in [笔名字体].
[题材风格标签]. [构图关键词]. [人物描述]. [背景描述].
[色彩指令]. [光效指令].
Professional book cover, high detail digital painting, portrait [平台比例:如 3:4 / 5:7 / 2:3] ratio, keep title and author name inside the central safe area away from edges (inner ~85%), no watermark
仅提示词模式在这里交付 1-3 个完整提示词方案后结束;还没确认的画面细节写成可选方向,不当成小说里的事实。
写法要点:
a man;dramatic golden light from above;digital painting style,不用 photo,避免真人照片感。先从「构图变体」里挑 2-3 种适合本题材的构图,每种用一句话描述画面(构图、主色、书名字体),连同 Step 2 定的题材一起给作者挑。作者选定后只生成那一张;作者说「都出」时每个方案单独生成一次。
image_gen(Codex)或 generate_image / image-generator(Antigravity)。比例和安全区写进提示词,不传 GPT_IMAGE_MODEL、GPT_IMAGE_SIZE、response_format 等 API 参数。REF_IMAGE 时,本地文件先载入会话(或传给 image-generator);URL 先下载再载入。说明是编辑目标还是风格参考,并列出须保持的内容。BOOK_DIR/封面/,把生成的图片复制为 封面_vN.png(N 自增不覆盖旧版);保留 $CODEX_HOME/generated_images/ 等原文件,并存同名 .prompt.txt(有参考图再存 .ref.txt)。确认可读后把原图绝对路径交给 Step 5。读 references/api-fallback.md,按其中的环境变量和命令生成;没有参考图走文生图,有参考图走图生图。生成后把原图绝对路径交给 Step 5。
平台有固定上传像素(番茄 600×800)时,把原图居中裁剪+缩放到精确尺寸,保持画面比例,原图保留并另存 _上传 版。SRC 填 Step 4 的原图绝对路径,TARGET 填 Step 1 的上传尺寸,不依赖上一段 shell 的临时变量:
SRC='<Step 4 生成的原图绝对路径>'
TARGET='<Step 1 确定的平台上传尺寸;无则留空>'
[ -f "$SRC" ] || { echo "封面原图不存在: $SRC" >&2; exit 1; }
if [ -n "$TARGET" ] && [ -f "$SRC" ]; then
UP="${SRC%.png}_上传.png"; W="${TARGET%x*}"; H="${TARGET#*x}"
if command -v magick >/dev/null 2>&1; then M=magick
elif command -v convert >/dev/null 2>&1; then M=convert; else M=""; fi
if [ -n "$M" ]; then
"$M" "$SRC" -resize "${W}x${H}^" -gravity center -extent "${W}x${H}" "$UP" # 缩放填满后居中裁
elif command -v sips >/dev/null 2>&1; then
cp "$SRC" "$UP"
sw=$(sips -g pixelWidth "$UP" | awk '/pixelWidth/{print $NF}')
sh=$(sips -g pixelHeight "$UP" | awk '/pixelHeight/{print $NF}')
if [ $((sw*H)) -ge $((sh*W)) ]; then sips --resampleHeight "$H" "$UP" >/dev/null
else sips --resampleWidth "$W" "$UP" >/dev/null; fi
sips -c "$H" "$W" "$UP" >/dev/null # sips -c 是 高 宽,居中裁
else
echo "无 magick/convert/sips,跳过;手动把 $SRC 居中裁剪+缩放到 $TARGET 再上传" >&2
fi
[ -f "$UP" ] && file "$UP"
fi
提示词中的中心安全区用于减少裁切风险;导出后仍按 Step 6 检查书名和笔名是否完整。
未达标或作者希望调整时,可更换构图、色调、字体或平台风格重出;生僻字多次渲染仍错笔时,可征询作者改出无字底图再自行加字。
交付时这样告诉作者;命令、环境变量和接口报错不贴给作者,失败时用一句话说原因和办法(如「生图接口没配好,需要先设置 API Key」):
封面做好了:`{封面图路径}`{;{平台}上传版({上传尺寸}):`{上传版路径}`}
这版的思路:{构图 + 色调 + 书名字体,一句话}
想调的话可以说:{2-3 个具体方向,如「换成人物特写」「书名改成毛笔字」}
小说封面生成与提示词设计。根据书名、作者名和题材构建封面提示词;用户只要提示词时不生图,要求封面图时调用 GPT-Image-2,Codex CLI 优先使用内置 ImageGen。触发方式:/story-cover、/封面、「帮我做个封面」「生成封面图」「封面提示词」「封面设计」。
---name: story-coverdescription: 小说封面生成与提示词设计。根据书名、作者名和题材构建封面提示词;用户只要提示词时不生图,要求封面图时调用 GPT-Image-2,Codex CLI 优先使用内置…---# skills/story-cover/SKILL.mdFAQ
Téléchargez skills/story-cover/SKILL.md auprès de l'éditeur, ou copiez le chemin et ouvrez le dépôt. PlugMCP répertorie le skill et n'héberge pas le fichier.
L'éditeur le maintient sur https://github.com/zenstory-ai/oh-story-claudecode.
Claude, Cursor, Codex et Grok Build peuvent lire un SKILL.md que vous ajoutez depuis le dépôt de l'éditeur. Grok Bot l'installe lorsque vous envoyez dans un chat le lien du dossier GitHub du skill.