关于 punk-avatar
punk-avatar 是用于编写头像图像生成提示词的工作流技能,面向需要人物、宠物或物体头像的用户。它从限定的样式库选取一种样式,并将主体特征、裁切与背景要求融入头像专用提示词。
主要功能
- 01从限定目录选择一种头像样式
- 02识别人物、宠物或物体主体
- 03支持图片输入与文字描述
- 04默认使用 1:1 画幅
- 05整合身份、构图与裁切要求
适用场景
- 01将人物照片转为风格化头像
- 02为宠物制作头像或纪念卡
- 03根据文字描述创建虚构头像
安装
复制下面的命令,在终端中运行。
npx skills add https:/ / github.com/ adrianpunk/ punk-skill --skill punk-avatar安装后在 Claude Code 中输入/punk-avatar确认已加载。
包含的文件
除 SKILL.md 外,安装时一起下载的参考资料和脚本。
agents/openai.yamlreferences/avatar-prompt-blueprint.mdstyle-catalog.md详细介绍
Punk Avatar
核心规则
punk-avatar 是一种头像形状工作流,而非风格的所有者。请从仓库级别的 styles/ 库中准确选择一种可复用风格,然后将该风格原子编译到头像形状中。
最终图像提示词不能只是将“头像说明 + 风格说明”宽松拼接在一起,而必须是一条完整的、适用于头像的提示词,将选定风格应用于个人资料图片、肖像头像、物品头像、宠物头像,或由头像衍生而来的纪念卡片。
使用以下三类输入:
punk-avatar任务字段:主体类型、源图像或文本描述、预期用途、肖像相似度策略、头像构图、宽高比、背景简化、裁切安全性,以及通用输出限制。- 所选风格的
META.md元数据和可复用视觉风格原子STYLE.md。 - 定义完整头像提示词结构的
references/avatar-prompt-blueprint.md。
风格文件定义可复用的视觉语言。头像蓝图定义输出形式。最终提示词必须将两者融合为一条完整的头像生成提示词。
资源
- 阅读
references/style-catalog.md,以列出或选择头像风格。 - 编写最终提示词前,阅读
references/avatar-prompt-blueprint.md。 - 对于所选风格,同时阅读:
../../styles/{style-id}/META.md../../styles/{style-id}/STYLE.md
punk-avatar菜单中仅展示以下七种风格:pixel-avatargrotesque-soul-sketchmessy-crayon-pet-portraitfashion-sketch-observationpolaroid-keepsakeminimal-paper-acrylic-block-illustrationsurreal-pop-up-paper-landscape
surreal-pop-up-paper-landscape有两种输出模式。阅读其META.md和STYLE.md后,准确阅读用户选定的一种模式参考文件:../../styles/surreal-pop-up-paper-landscape/references/before-after.md../../styles/surreal-pop-up-paper-landscape/references/final-artwork.md
punk-avatar菜单中不要展示封面或海报风格。- 头像任务中不要读取
punk-cover参考文件或模板。
工作流
-
分析源素材:
- 如果用户提供一张或多张图像,以图像输入为主。
- 判断主要主体类型:
person、pet、object或unclear。 - 仅提取头像所需的简洁视觉特征:脸部或头部形状、头发或皮毛、眼睛、表情、姿势、标志性色彩、服装、配饰、物品轮廓,以及任何必须保留的标记。
- 将文本用作补充背景信息:姓名、性情、预期用途、偏好的背景颜色、需要保留的元素,以及需要避免的元素。
- 如果没有图像,且用户描述的是虚构头像,则按基于描述的生成方式处理。不要承诺与真实照片相似。
-
确定宽高比:
- 在
punk-avatar中,默认比例始终为1:1。 - 如果用户指定
3:4、4:5、16:9或任何自定义比例,必须完全沿用用户指定的比例。 - 不要将所选风格元数据中的
default_ratio用作头像默认比例。 - 对于
polaroid-keepsake,在punk-avatar中默认使用1:1;只有用户明确要求竖版比例时,才生成竖版拍立得卡片。 - 对于
surreal-pop-up-paper-landscape,如果用户未指定比例,before-after模式使用3:2,final-artwork模式使用3:4。用户指定的任何比例都必须完全沿用。 - 用户未指定比例时,不要询问比例。
- 在
-
生成任何提示词前,确认风格:
- 如果用户指定了目录中的某种风格,就使用该风格。
- 如果用户提供了完整的视觉方向,且与目录中的某种风格相符,包括
极简纸感丙烯色块插画或立体人物扁平景色纸艺风格说明,就视为用户已指定该风格,并使用对应的风格原子,无需要求用户重复说明风格。 - 如果未指定风格,根据主题类型推荐 2-3 种符合条件的风格,并请用户选择一种。
- 如果缺少风格,提问后就停止。不要填写风格文件、保存提示词文件或生成图像。
- 仅当用户明确表示要自动决定所有内容时,才自动选择一种风格。
- 对于
surreal-pop-up-paper-landscape,还要确定输出模式。将用户提出的前后对比图、对比图、before/after或comparison映射为before-after;将效果图、单张效果图、成品图、final artwork或single image映射为final-artwork。 - 如果用户选择了
surreal-pop-up-paper-landscape,但未指定模式,只询问要使用哪种模式,并停止。除非用户明确要求两种模式都生成,否则不要同时生成两种。
-
推荐规则:
- 主题是宠物:推荐
凌乱蜡笔宠物肖像、拍立得纪念卡和怪诞灵魂手绘;如果更适合图标风格的头像,也推荐像素头像。 - 主题是人物:推荐
怪诞灵魂手绘、时尚速写观察页和像素头像。 - 主题是物体或不明确:优先推荐
像素头像。 - 对于需要小型象征性主体、粗糙白纸、清透亚克力色块和大面积留白的照片或主题:推荐
极简纸感丙烯色块插画。 - 对于有易于辨认的周围场景、且需要将人物照片转化为从扁平纸艺景观中浮现的写实直立人物的情况:推荐
立体人物扁平景色纸艺。 - 不要向人物主题推荐
messy-crayon-pet-portrait。 - 除非用户明确要求此风格,否则不要向宠物或物体主题推荐
fashion-sketch-observation。 - 不要向人物或物体主题推荐
polaroid-keepsake。
- 主题是宠物:推荐
-
使用以下确认流程:
- 缺少风格:请用户选择风格,然后停止。
- 缺少比例:静默使用步骤 2 中确定的默认值。
- 风格已知:无需询问,继续。
surreal-pop-up-paper-landscape缺少模式:询问用户选择前后对比图或单张效果图,然后停止。- 如果风格和主题都已明确到足以继续,就整理提示词。
-
编译最终图像提示词:
- 使用
references/avatar-prompt-blueprint.md作为prompts/avatar.md的必需结构。 - 从
../../styles/{style-id}/STYLE.md中恰好读取一个选定的风格视觉元素。 - 从
../../styles/{style-id}/META.md中读取所选风格的元数据。 - 对于
surreal-pop-up-paper-landscape,恰好读取并编译一个选定的模式参考。模式参考决定结果是并排对比,还是一幅独立作品;绝不可混用这两种输出规范。 - 提取所选风格不可妥协的视觉锚点:主体处理方式、构图、背景表现、线条或纹理体系、色彩逻辑、排版或手写字效果、相似度限制以及负面约束。
- 将头像任务字段和风格锚点融合成一份完整的头像提示词。最终提示词应像一份完整的头像生成说明,而不是把两段无关的提示词直接拼在一起。
- 添加头像专用章节,涵盖角色/任务、输入字段、源内容解读、主体身份、相似度策略、头像构图、裁切安全、背景、风格应用、色彩/材质/纹理、可选文本/名称处理、负面约束和最终标准。
- 不要将原始
STYLE.md内容作为单独的第二部分附加。应将其中的风格视觉元素改写并适配到头像蓝图中。 - 不要组合多种风格,也不要添加第二个自定义风格章节。
- 替换或明确处理所选风格文件中的所有显式占位符。
- 对于基于图像的输入,应保留可辨识的主体身份;除非所选风格要求写实结构,否则不要制作照片级真实的复制图。
- 对于仅含文本的虚构头像,应说明图像应遵循描述,并避免使用“保留照片相似度”之类的表述。
- 不要将封面标题层级、文章摘要、平台传播规则或社交封面构图带入头像提示词。
- 最终提示词中不要输出分析内容。
- 使用
-
在生成图像前保存文件:
- 将填充完整的提示词保存到
punk-assets/punk-avatar/{slug}/prompts/avatar.md。 - 如果图像生成返回了本次运行对应的明确本地文件路径、可下载 URL 或图像字节数据,请将该产物保存为
punk-assets/punk-avatar/{slug}/avatar.png。 - 不要通过扫描宽泛的生成图像目录来推断正确产物,因为这些目录可能包含其他运行生成的无关图像。
- 如果图像生成工具只返回内嵌预览,且没有提供本次运行可检索的产物,则不要伪造
avatar.png。
- 将填充完整的提示词保存到
-
保存提示词后,默认生成图像,只要有可用的图像生成工具(例如
image_gen)。将内嵌预览生成视为图像生成成功;只有当工具明确提供本次运行的产物时,才视为成功保存了本地avatar.png。仅当用户明确要求只提供提示词,或当前环境没有图像生成工具时,才跳过图像生成。如果无法生成图像,请返回提示词文件路径和完整提示词内容。
首次响应格式
对于未指定风格的输入,请简洁地询问:
默认画幅:1:1。
请选择一个头像风格:
- `风格 A`:reason tied to the subject.
- `风格 B`:reason tied to the subject.
- `风格 C`:reason tied to the subject.
也可以回复 "auto" 让我自动选择。
除非用户明确希望选择比例,否则不要询问比例。
风格选择启发式
- 对于人物、宠物、物体、象征性头像、类似图标的个人资料图片,以及主体不明确的情况,使用
pixel-avatar。 - 对于需要呈现富有表现力、风趣、随性素描感和个性的人物或宠物,使用
grotesque-soul-sketch。 - 仅对宠物及宠物肖像头像使用
messy-crayon-pet-portrait。 - 仅对人物使用
fashion-sketch-observation,尤其适用于时尚、旅行、街拍、电影剧照或编辑风格的个人肖像。 - 仅对宠物使用
polaroid-keepsake,尤其适用于纪念、收藏、带名字的宠物卡片,以及从头像衍生的纪念卡片。 - 对于需要用简化的纸张质感插画、鲜艳的丙烯颜料色块和非常小的主体来呈现的人物、宠物、物体、场景或主题,使用
minimal-paper-acrylic-block-illustration。 - 对于基于图像的人物肖像,如果要求真实人物保持直立且逼真,同时让拍摄环境向下折叠成浅景深的纸飞机景观,使用
surreal-pop-up-paper-landscape。
头像提示词蓝图
使用 references/avatar-prompt-blueprint.md 作为完整提示词结构。以下代码块仅保留必需的任务字段内容,这些内容必须体现在整合后的最终提示词中。
# punk-avatar task instructions
Create one single avatar image. Aspect ratio: {ratio}.
Use the following derived subject fields only:
- Subject type: {subject_type}
- Generation mode: {image_based_or_description_based}
- Subject identity: {subject_identity}
- Recognizable traits: {recognizable_traits}
- Name or text to include: {name_or_text}
- Intended use: {use_case}
- Background preference: {background_preference}
- Mood: {mood}
- Preserve: {preserve}
- Avoid: {avoid}
For image-based inputs, preserve the subject's most recognizable traits while translating them into the selected style. Do not claim exact biometric identity or photorealistic duplication.
For description-based inputs, create a fictional avatar from the description. Do not write that it preserves photo likeness.
The avatar must work as a profile image: readable at small size, centered or deliberately framed, clear silhouette, no important facial features or subject marks cropped out, simplified background, and one final output.
Generate only one final image. Do not output explanations, alternatives, grids, contact sheets, or multi-option compositions.
输出规范
- 最终生成的提示词必须是一个整合后的、针对头像的提示词,由头像任务字段、
references/avatar-prompt-blueprint.md和且仅一个选定的风格元素编写而成。 - 不要将选定风格的
STYLE.md作为独立的第二部分粘贴。应将其风格元素融入头像蓝图。 - 最终提示词必须保留所选风格在
META.md和STYLE.md中的不可妥协锚点。 - 不要将无关的用户文本复制到最终提示词中;请使用精简提炼的主体字段。
- 不要在提示词文件中加入风格选择理由。
- 不要混合多种风格。
- 不要添加封面/海报标题层级、文章摘要或平台封面规则。