CommunityImagegithub.com

Reimagica/handdrawn-portrait-kit

A four-stage workflow in Codex for creating hand-drawn cartoon portrait posters, prioritizing pop-up selection bars and fill-in-the-blank inputs to collect photos, landscapes, decorations, and revision feedback. Characters feature thick black outlines, light inner lines, warm ivory highlights, and restrained light ochre shadows, delivering independent transparent layers and a composite draft.

What is handdrawn-portrait-kit?

This skill provides a structured four-phase workflow (Character → Landscape → Decoration → Display & Revision) for generating hand-drawn cartoon portrait posters within Codex. It is designed for developers and AI agent users who need a systematic, reproducible method for multi-layered artistic composition. The workflow ensures all inputs are gathered sequentially and rigorously validated before proceeding; character photos define identity, posture, and facial structure, while optional landscapes and decorations are added via pop-up selection or free-text inputs. Each stage emits transparent PNGs with independent layers, culminating in a composite image that respects visual hierarchy (character over landscape, landscape cropped to the midline if decorations are present). The skill script tightly integrates with Codex’s `functions.request_user_input_async` for interactive prompting and expects attachments for photos. It also includes inline quality checks (head-to-shoulder ratio, neck connection, eye shape) and a revision loop that locks the face from the most recent approved layer—making it ideal for iterative user feedback or one-shot delivery. Supporting references and a local compose script are available for advanced users.

Works with~Claude Code✓Codex CLI~Cursor
npx skills add https://github.com/Reimagica/handdrawn-portrait-kit/tree/HEAD

Installed? Explore more Image skills: steipete/songsee, affaan-m/frontend-design, mattpocock/improve-codebase-architecture · View all 6 →

Ask in your favorite AI

Open a new chat with this agent skill pre-loaded.

Documentation

手绘肖像四阶段工作流

新作严格按 1 人物 → 2 风景 → 3 装饰 → 4 展示与修改 执行,在同一次 Codex 对话中推进。前三项均明确后才开始生成与拼接。复用用户已给的输入,每次只收集最早缺失的阶段,问题标题标明“阶段 N/4”。用户说“只画人物”时可直接跳过风景和装饰。其他缺项用当前阶段的问题确认。

Codex 交互方式

  • 默认用 functions.request_user_input_async 发出弹出问题。需要选项时传 questions: [{title, options}],需要自由填空时传 questions: [{title}]。每次只发当前阶段的问题;用实际收到的答复继续同一任务。工具返回只表示弹窗已发出,预选项或等待超时都不算用户选择。等待时保留任务和阶段进度,收到回复后继续。
  • 图片通过当前对话的附件入口接收,选项栏和填空只收集文字。缺少人物照片,或用户选了上传实景照时,在当前对话提示添加附件,收到后继续。弹窗工具不可用时,在当前对话用简短编号选项或填空问题推进。
  • 输入已给齐时直接进入下一阶段。前三阶段的问题由弹窗推进,保持在同一任务内;阶段 4 展示预览后也用弹窗收集意见。用户要求一次性出稿时可直接交付;需要继续改稿时收集反馈。

阶段 1/4 人物照片与要求

接收至少一张人物照片。需要补充要求时弹出“沿用照片”或让用户填入表情、衣着、姿态和需要保留的特征。合照看不出目标时请用户指明。主照片决定身份、衣着、姿态和脸部结构,辅助照片用于补充五官。歪头时按面部结构与局部修订记录眼轴、鼻口中线、颊宽和下颌走向,再开始生图。

先按人物画法记录主照的头宽与肩宽比例,并锁定决定姿势的动作,再定截线。通常画到胸下缘与上腹交界。叉腰等动作跨过默认截线时,人物层先画全肩、向外弯的肘、向内收的前臂和落在腰侧的手,再按画幅裁切。用户给定裁切时按其要求排版,保留画框允许的动作线索。只露头肩时按可见衣着保守补齐。

阶段 2/4 风景照片或预设

弹出选项 A 湖畔博雅塔、B 秋叶博雅塔、C 未名湖石、「上传实景照」「参考人物照中的背景」「跳过风景」。可在自由输入中补充地标、保留细节或摆放位置。

阶段 3/4 装饰文本

弹出填空,请用户以文本提供 1–3 组手绘装饰,或填写「跳过装饰」。可写「文字:共同学习」「图标:两个人一起拼拼图」,也可把两项写在同一组。装饰文字照录,图标按描述绘制。两者按马克笔贴图画法绘制。文字圆润醒目,图标用宽笔画勾出并保留透明内部,描边随画面色调调整。

三项齐备后,按框线模板选定排版,再依次绘制和拼接。每个绘制模块独立输出真实透明底 PNG。

  1. 按人物画法记录辨识点和截线,使用其提示词与笔法示意绘制,按色卡取色。面部先做二分明暗,再视光向点少量马克笔高光。人物通过该参考里的验收后,再用它作为定制风景和装饰的风格参照。
  2. 直接复用所选预设透明 PNG,或读风景画法与提示词,以实景照定造型、以人物稿定笔法,独立绘制定制风景。
  3. 按装饰与拼接为每组装饰制作独立 PNG。在成品缩图核对文字和图标的实际大小、描边对比度与透明留白。
  4. 按装饰与拼接先定头肩和躯干的尺寸,再用本地拼接脚本或图层工具排版。人物上半身占约 50–70% 的视觉比重,外伸手臂不参与估算。排版优先让双肩与关键动作可读,必要时从完整人物层沿画框裁切。人物叠在风景上方,可以大幅遮挡景物。风景可由画框裁切,保留可辨认的景物片段。两层各自贴底。有装饰时,风景可见主体铺到中线附近,上方留给装饰。阶段 3 跳过装饰时,风景可按构图延伸到中线以上。默认用竖幅框线,用户指定画幅时按其要求调整。

阶段 4/4 展示图层与拼接稿

展示前按构图验收对照主照检查头肩比例、颈部连接、眼形和关键动作,再看发顶留白、双肩、风景高度和图层底部落点。把成品缩小检查叉腰等动作是否一眼可辨,以及裁口是否接在画框边缘。无装饰时发顶留白优先控制在画高的 5–10%。通过后,在当前对话展示各透明图层和完整拼接稿,每张给可打开的 PNG 链接。预览后继续同一任务收集意见。

预览发出后弹出「保留当前稿」「修改人物」「修改风景」「修改装饰」「调整布局」,只列出已有图层,并允许直接填写改稿要求。选中要改的模块但未给具体要求时,用填空补问。后续留在阶段 4,按锁脸规则从最近认可图层修订。风景、装饰和布局改动直接复用人物层;人物局部改动先圈定可改区,逐轮对照脸部结构,再拼接和预览。文件另存新版本,放到用户指定目录或当前工作区。

Related Skills