[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"project-94684":3},{"id":4,"name":5,"fullName":6,"owner":7,"repo":5,"description":8,"homepage":9,"htmlUrl":9,"language":10,"languages":9,"totalLinesOfCode":9,"stars":11,"forks":12,"watchers":13,"openIssues":14,"contributorsCount":14,"subscribersCount":14,"size":14,"stars1d":14,"stars7d":14,"stars30d":15,"stars90d":14,"forks30d":14,"starsTrendScore":14,"compositeScore":16,"rankGlobal":9,"rankLanguage":9,"license":17,"archived":18,"fork":18,"defaultBranch":19,"hasWiki":18,"hasPages":18,"topics":20,"createdAt":9,"pushedAt":9,"updatedAt":21,"readmeContent":22,"aiSummary":23,"trendingCount":14,"starSnapshotCount":14,"syncStatus":24,"lastSyncTime":25,"discoverSource":26},94684,"punk-ip-illustrations","adrianpunk\u002Fpunk-ip-illustrations","adrianpunk","Punk personal IP article illustration Agent Skill",null,"Python",112,14,103,0,1,43.63,"MIT License",false,"main",[],"2026-08-24 04:01:22","# Punk IP Illustrations\n\n**Punk 出品｜上传一张照片，创建自己的个人 IP，再让它进入每一篇文章。**\n\n这是一个完整的 Agent Skill：先把用户上传的人物照片转换成可确认、可复用的个人 IP；角色确认后，再使用同一个 Skill 自动读取文章并生成统一的复古彩色扁平 3D 小剧场插图。\n\n`Punk` 是这个 Skill 的品牌、作者印记和内置示例，不代表只能画 Punk。任何人都可以上传自己的照片，创建自己的角色，再让该角色进入文章、教程、工作流和观点插图。\n\n\u003Cp align=\"center\">\n  \u003Cimg src=\"assets\u002Fpunk-character-sheet.png\" width=\"560\" alt=\"Punk 内置个人 IP 角色设定图\">\n\u003C\u002Fp>\n\n## 效果展示\n\n\u003Ctable>\n  \u003Ctr>\n    \u003Ctd width=\"50%\">\u003Cimg src=\"docs\u002Fimages\u002Fpoverty-template.png\" alt=\"打破清贫模板\">\u003C\u002Ftd>\n    \u003Ctd width=\"50%\">\u003Cimg src=\"docs\u002Fimages\u002Fvalue-over-price.png\" alt=\"科研成果高于穿搭价格\">\u003C\u002Ftd>\n  \u003C\u002Ftr>\n  \u003Ctr>\n    \u003Ctd width=\"50%\">\u003Cimg src=\"docs\u002Fimages\u002Fdouble-standard.png\" alt=\"成功女性面对的双重标准\">\u003C\u002Ftd>\n    \u003Ctd width=\"50%\">\u003Cimg src=\"docs\u002Fimages\u002Farticle-workflow.png\" alt=\"收集资料、筛选证据、形成判断并输出文章的流程拆解\">\u003C\u002Ftd>\n  \u003C\u002Ftr>\n\u003C\u002Ftable>\n\n## 完整流程\n\n```text\n上传人物照片\n    ↓\n生成主角色＋正面／左侧／背面／右侧设定板\n    ↓\n生成干净人物参考图和人物规范\n    ↓\n用户修改或确认角色\n    ↓\n确认后的角色成为当前 IP\n    ↓\n读取完整文章并自动决定配图数量\n    ↓\n逐张生成小剧场插图并报告插入位置\n```\n\n角色确认是唯一必须停下来等待用户的环节。文章图片方案默认自动执行，不要求用户逐张确认。\n\n## 它会自动完成什么\n\n- 从真人照片提取可观察的辨识特征。\n- 生成主角色和正面、左侧、背面、右侧四视图。\n- 生成透明或纯白背景的干净单人物参考图。\n- 建立人物规范和本地角色资产包。\n- 支持修改、确认、保存、列出和切换多个角色。\n- 读取完整文章并按信息密度自动决定配图数量。\n- 自动选择“流程拆解”或“核心动作”模式。\n- 逐张生成独立的 16:9 文章插图。\n- 报告每张图片的实际路径、用途和建议插入位置。\n\n## 安装\n\n### 让 AI Agent 自动安装\n\n把下面这段话发送给能够访问终端和文件系统的 AI Agent：\n\n```text\n请帮我安装这个 Agent Skill：\nhttps:\u002F\u002Fgithub.com\u002Fadrianpunk\u002Fpunk-ip-illustrations\n\n请根据当前客户端确定正确的 Skills 安装位置。安装完成后确认 punk-ip-article-illustrations 可以使用。\n```\n\n### 手动安装到 Codex\n\nmacOS \u002F Linux：\n\n```bash\ngit clone https:\u002F\u002Fgithub.com\u002Fadrianpunk\u002Fpunk-ip-illustrations.git ~\u002F.codex\u002Fskills\u002Fpunk-ip-article-illustrations\n```\n\nWindows PowerShell：\n\n```powershell\ngit clone https:\u002F\u002Fgithub.com\u002Fadrianpunk\u002Fpunk-ip-illustrations.git \"$HOME\\.codex\\skills\\punk-ip-article-illustrations\"\n```\n\n如果使用其他支持 Agent Skills 的客户端，请把仓库克隆到该客户端的 Skills 目录，并保持目录名为 `punk-ip-article-illustrations`。\n\n## 怎么使用\n\n### 安装后的首次引导\n\n安装完成后，在客户端中选择 `$punk-ip-article-illustrations`。如果还没有创建过角色，Skill 会先显示：\n\n```text\nHi，我是 Punk，欢迎使用 Punk IP Illustrations。\n每个人都是独立的个体，也拥有属于自己的强大 IP。愿你在这里找到自己的品牌价值。\n\n请上传一张清晰的人物照片，并告诉我角色名称或昵称。\n\n接下来我会：\n1. 生成主角色和正面、左侧、背面、右侧设定图；\n2. 生成干净人物参考图；\n3. 请你确认或提出修改；\n4. 确认后，用这个角色为文章自动配图。\n```\n\n如果客户端没有自动带出默认提示，可以发送：\n\n```text\n使用 $punk-ip-article-illustrations 开始首次引导。\n```\n\n已经存在确认角色时，Skill 不会重复要求上传照片，而是直接提示使用当前角色并请你提供文章。\n\n### 直接使用内置 Punk 角色\n\n作者本人或希望先体验效果的用户，不需要重新创建角色：\n\n```text\n使用 $punk-ip-article-illustrations。\n启用内置 Punk 角色，然后完整读取下面的文章，自动决定配图数量并直接生成：\n\n\u003C文章正文、文件路径或文章链接>\n```\n\n内置 Punk 已经确认，会被复制到用户本地角色包并设置为当前角色。它也是仓库效果图所使用的角色。\n\n### 第一步：上传照片，创建个人 IP\n\n上传一张人物清晰的照片，然后发送：\n\n```text\n使用 $punk-ip-article-illustrations。\n请根据我上传的照片创建“\u003C名字或昵称>”个人 IP。\n保留我的脸型、五官比例、发型、肤色、服装、鞋子和已有配件。\n```\n\nSkill 会生成：\n\n- 竖版角色设定板。\n- 干净单人物参考图。\n- `character-spec.md` 人物规范。\n- 状态为 `draft` 的本地角色包。\n\n生成完成后，Skill 会展示角色并等待确认，不会立即开始文章配图。\n\n### 第二步：修改或确认角色\n\n不满意时直接说明要改哪里：\n\n```text\n发型再接近原照片一点，其他特征保持不变。\n```\n\n```text\n鞋子改回照片里的白色运动鞋，脸和服装不要变化。\n```\n\n满意后发送：\n\n```text\n确认这个角色，就用这一版。\n```\n\n只有明确确认后，角色才会变为 `confirmed`，并成为当前使用的个人 IP。\n\n### 第三步：使用同一个 Skill 给文章配图\n\n确认角色后，继续发送：\n\n```text\n继续使用 $punk-ip-article-illustrations。\n请完整读取下面的文章，自动决定配图数量并直接逐张生成。\n告诉我每张图片适合插在哪里：\n\n\u003C文章正文、文件路径或文章链接>\n```\n\n不需要重新上传人物照片。Skill 会自动读取当前已确认的角色资产。\n\n### 一次调用：生成配图并自动插入 Markdown\n\n如果文章是本地可编辑的 Markdown 文件，可以让 Skill 在生成图片后自动定位相关段落，把图片链接直接插回正文：\n\n```text\n使用 $punk-ip-article-illustrations。\n完整读取这篇文章并自动生成配图。\n根据内容判断图片数量，以及每张图使用“流程拆解”还是“核心动作”模式。\n生成后把图片自动插入 Markdown 的正确位置，使用相对路径，并在修改前保留一份原文备份：\n\n\u003CMarkdown 文件路径>\n```\n\nSkill 会以核心观点、逻辑转折和唯一段落作为定位锚点，把图片放在相关段落结束后，避免插进句子、列表或引用块，也会避免与原有图片连续堆叠。网页链接、粘贴正文或不可写文件不会被直接修改，交付时仍会报告每张图片的建议插入位置。\n\n### 为单个观点生成一张图\n\n```text\n使用 $punk-ip-article-illustrations，用当前角色给下面的观点生成一张核心动作模式正文插图：\n\n真正的效率不是同时做更多事情，而是减少无效切换。\n```\n\n### 指定配图数量\n\n```text\n使用 $punk-ip-article-illustrations，完整读取下面的文章，并使用当前角色生成 5 张正文插图：\n\n\u003C文章内容>\n```\n\n### 指定表现模式\n\n```text\n使用 $punk-ip-article-illustrations，把下面的工作流生成一张流程拆解图：\n\n收集资料 → 筛选证据 → 形成判断 → 输出文章\n```\n\n```text\n使用 $punk-ip-article-illustrations，把下面的观点生成一张核心动作图：\n\n写，是所有内容形态的底层能力。\n```\n\n## 多个角色\n\n可以为自己、团队成员或不同品牌分别创建角色。\n\n列出角色：\n\n```text\n使用 $punk-ip-article-illustrations，列出我已经创建的全部角色。\n```\n\n切换角色：\n\n```text\n使用 $punk-ip-article-illustrations，切换到“小明”，然后给下面的文章配图：\n\u003C文章内容>\n```\n\n只有已确认角色可以激活和用于文章配图。\n\n## 自动配图数量\n\n| 内容规模 | 默认数量 |\n| --- | ---: |\n| 单个观点或 500 字以内 | 1 张 |\n| 约 500—1500 字 | 1—3 张 |\n| 约 1500—3500 字 | 3—5 张 |\n| 约 3500 字以上 | 4—8 张 |\n\n数量跟随信息密度。Skill 会合并重复内容，不会为了凑数量制造无效图片；用户指定数量时优先遵循用户要求。\n\n## 两种插图模式\n\n### 流程拆解\n\n适用于步骤、方法、教程和工作流。内容被压缩为 3—5 个节点，同一角色可以在不同节点重复出现，但每个分身都必须执行具体动作。\n\n### 核心动作\n\n适用于观点、冲突、处境和反直觉关系。画面只保留一个角色、一个核心物件或紧凑物件组、一个动作和一个可见结果。\n\n两种模式均使用横版 16:9、纯白页面、大面积留白和复古彩色扁平 3D 小剧场风格。\n\n## 本地文件结构\n\n运行结果默认保存在当前项目的 `.punk-ip-assets\u002F`：\n\n```text\n.punk-ip-assets\u002F\n├── current-character.json\n├── characters\u002F\n│   └── \u003C角色名>\u002F\n│       ├── character.json\n│       ├── character-sheet.png\n│       ├── character-reference-clean.png\n│       └── character-spec.md\n└── illustrations\u002F\n    └── \u003Carticle-slug>\u002F\n        ├── 01-topic.png\n        └── 02-topic.png\n```\n\n没有可写项目目录时回退到 `~\u002F.punk-ip-assets\u002F`。同名文件不会被覆盖，而是创建 `-v2`、`-v3` 版本。\n\n## 安装后的最小测试\n\n1. 上传一张人物照片，使用第一步提示创建角色。\n2. 检查是否生成设定板、干净人物图和草稿角色包。\n3. 发送“确认这个角色”。\n4. 使用以下观点测试文章插图：\n\n```text\n使用 $punk-ip-article-illustrations，用当前角色生成一张核心动作模式插图：\n真正的效率不是同时做更多事情，而是减少无效切换。\n```\n\n预期结果：角色创建阶段会等待确认；确认后生成一张独立 16:9 PNG，背景纯白，人物身份与角色包一致，回复包含实际路径和建议插入位置。\n\n## 常见问题\n\n| 问题 | 处理方式 |\n| --- | --- |\n| 角色设定板的四视图不一致 | 只修正身份漂移，重新对照原照片并保持其他特征不变 |\n| 文章配图出现设定板标题或米色背景 | 移除设定板，只传干净人物参考图并强调纯白页面 |\n| 人物服装或配件变化 | 重新读取 `character-spec.md`，只修正漂移项目 |\n| Skill 直接开始给文章配图 | 检查角色是否已经明确确认；草稿角色不能用于配图 |\n| 找不到当前角色 | 列出角色，并激活一个状态为 `confirmed` 的角色 |\n| 图片中文字错误 | 减少非必要文字，使用短标签并重新生成该张 |\n| 无法写入目标目录 | 保留图像工具返回的实际路径，并在交付中原样报告 |\n\n## 隐私\n\n- 原始人物照片默认不会复制进角色包，也不会上传到本仓库。\n- 角色、文章和插图保存在用户本地，不提交到 GitHub。\n- Skill 不根据照片推断姓名、职业、民族、健康、政治、宗教、性取向等敏感属性。\n- 请只使用自己拥有或已经获得授权的人物照片。\n\n## 要求\n\n- AI Agent 支持 Agent Skills 和本地文件读写。\n- 客户端具备图像生成和参考图能力；否则 Skill 只能输出提示词与保存计划。\n- 使用网页文章时，Agent 需要能够获取完整正文。\n\n## 授权\n\n工作流、脚本和文档按 [MIT License](LICENSE) 发布。用户上传的照片、生成角色和文章插图不属于仓库内容，其权利由用户和所使用的图像服务条款决定。\n\n- 内置 Punk 人物设定图及角色资产不包含在 MIT 授权中，详见 [LICENSE-ASSETS](LICENSE-ASSETS)。\n- 工作流结构参考了 [jinchenma94\u002Fjinchenma-ip-skills](https:\u002F\u002Fgithub.com\u002Fjinchenma94\u002Fjinchenma-ip-skills) 的开源思路。\n\n## 关于作者\n\n**Punk**｜中科大 MBA｜HerName 首席设计师｜Stanley 商学院执行院长\n\n持续分享小白能看懂、复制能上手的 AI、内容与搞钱方法：[@AdrianPunk115](https:\u002F\u002Fx.com\u002FAdrianPunk115)\n","【任务一】项目简介（218字）：\n\n这是一个面向内容创作者的个人IP可视化Agent技能，用于将真人照片自动转化为统一风格的可复用角色形象，并基于该角色为文章自动生成匹配的插图。核心功能包括：四视图角色设定生成、人物特征提取与规范文档输出、多角色管理，以及文章语义分析驱动的配图决策（支持流程拆解\u002F核心动作模式），最终输出复古彩色扁平3D风格的16:9小剧场插图。技术上融合图像理解、提示工程与结构化输出控制，全流程仅需用户在角色确认环节介入。适用于自媒体写作、知识类教程、观点型长文、工作流说明等需强化作者人设与视觉一致性的场景。\n\n【任务二】搜索关键词（共8个）：\n\n个人IP  \n角色插图  \n文章配图  \nAI绘图  \n形象定制  \n内容可视化  \n小剧场插图  \nIP形象",2,"2026-08-14 02:30:03","CREATED_QUERY"]