这是什么
Punk IP Illustrations 是一个面向内容创作者和自媒体运营者的 Agent Skill。它先让你在「松散线描水彩」和「复古彩色扁平 3D」两种画风中选择,然后上传一张人物照片,创建属于自己的个人 IP 角色;角色确认后,使用同一个 Skill 自动读取文章,并生成与角色绑定的统一风格插图。


该仓库由 adrianpunk 维护,在 GitHub 上已获得 208 个 Star、24 个 Fork,当前没有开放的 Issue。
适合谁
适合需要为长文、教程、观点或工作流配图的创作者,尤其是想要打造稳定个人视觉形象的博主、公众号作者、课程讲师和一人公司运营者。无需技术背景,只要会使用支持 Agent Skills 的 AI 客户端(如 Codex、Claude Code、Cursor 等)即可上手。
能做什么
- 从真人照片提取可观察的辨识特征,生成角色设定图(水彩风格含五视图,扁平 3D 含四视图)。
- 生成透明或纯白背景的干净单人物参考图,并建立人物规范与本地角色资产包。
- 支持修改、确认、保存、列出和切换多个角色,每个角色绑定独立画风。
- 读取完整文章后自动决定配图数量(按信息密度),并自动选择「流程拆解」或「核心动作」模式。
- 逐张生成 16:9 的文章插图,报告实际路径、用途和建议插入位置;可直接插入 Markdown 文件并保留备份。
- 支持为单个观点、指定数量或指定模式生成插图,也能处理多角色切换。
使用前准备
- 一个支持 Agent Skills 和本地文件读写的 AI 客户端,例如 Codex、Claude Code、Cursor 或 Gemini CLI。
- 客户端需具备图像生成和参考图能力,否则 Skill 只能输出提示词与保存计划。
- 准备一张清晰的人物照片(自己拥有或已获授权),用于创建个人 IP。
安装方法
推荐让 AI Agent 自动安装:将下面这段话发送给能访问终端和文件系统的 Agent:
请帮我安装这个 Agent Skill:
https://github.com/adrianpunk/punk-ip-illustrations
请根据当前客户端确定正确的 Skills 安装位置。安装完成后确认 punk-ip-article-illustrations 可以使用。
也可以手动安装到 Codex(macOS / Linux):
git clone https://github.com/adrianpunk/punk-ip-illustrations.git ~/.codex/skills/punk-ip-article-illustrations
Windows PowerShell 用户则使用:
git clone https://github.com/adrianpunk/punk-ip-illustrations.git "$HOME\.codex\skills\punk-ip-article-illustrations"
其他支持 Agent Skills 的客户端请将仓库克隆到对应 Skills 目录,并保持目录名为 punk-ip-article-illustrations。
使用示例
安装后,在客户端中选择 $punk-ip-article-illustrations,Skill 会先询问画风,然后引导上传照片。示例提示:
使用 $punk-ip-article-illustrations。
选择松散线描水彩风格。
请根据我上传的照片创建“我的IP”个人IP。
保留我的脸型、五官比例、发型、肤色、服装、鞋子和已有配件。
生成角色后进行确认:
确认这个角色,就用这一版。
确认后,即可为文章自动配图:
继续使用 $punk-ip-article-illustrations。
请完整读取下面的文章,自动决定配图数量并直接逐张生成。
告诉我每张图片适合插在哪里:
<文章正文、文件路径或文章链接>
如果文章是本地 Markdown 文件,还可以让 Skill 自动插入图片并保留原备份。
风险与注意事项
- 原始人物照片默认不会复制进角色包,也不会上传至仓库;角色、文章和插图均保存在本地。
- Skill 不根据照片推断姓名、职业、民族、健康、政治、宗教、性取向等敏感属性,请只使用自己拥有或已获授权的人物照片。
- 仓库采用「个人非商用免费 + 商业付费授权」双轨模式,商业使用须获得书面授权。
- 内置 Punk 角色及其资产受单独许可约束;仓库效果图也按示例图条款使用。
- 如果客户端没有图像生成能力,Skill 只能输出提示词和保存计划,无法直接生成图片。