⏳ This skill is pending AI review.

Scores will appear once the review pipeline completes.

version unknown

blender-character-workflow

icesixgod@icesixgod⭐ 128 stars· last commit 2mo ago· 0 open issues

根据人物设定图在 Blender 制作或修复可编辑角色,组织参考配准、脸部与头发塑形、多视图验收,以及按需扩展全身和绑定。适用于二次元人物还原、完整脸部制作和角色工程交付;不用于单纯生成二维人像或无关的 Blender 场景。

Choose how to use this skill

You do not need every option. Choose the path your AI client supports. The stable page stays the same; versioned files are immutable.

1. Native installer

This listing has no registered native installer command. Use the complete package or source fallback below, depending on what your client supports.

Do not guess an installer command or replace an existing version without reviewing the diff.

2. Complete package recommended

Download the ZIP when available. It includes SKILL.md plus the references, security notes and version metadata.

No complete ProSkills package is published for this listing yet.

3. Prompt-only

Copy the prompt above when the agent can read the stable page or when you want to adopt the workflow without installing a skill.

Need only the instruction file?

Download SKILL.md only if your client requires a single file. The complete ZIP is safer for a full installation because it preserves the references and release context.

No path installs or executes anything by itself. Your agent still needs access to the project files. Before updating, compare the installed version and review the diff.

—/10

// RATINGS

⭐GitHub Stars
⭐⭐⭐ 128 on GitHubGitHub ↗

Popular

🟢ProSkills Score
—
📍

Not yet listed on ClawHub or SkillsMP

// README

awesome-astra-blender-characters

从人物参考图到可编辑 Blender 角色的 AI Agent 工作流。

中文 · English

本仓库提供可安装的 blender-character-workflow 技能,组织九视图参考、脸部与头发制作、局部修模、多视图验收和工程交付,重点是二次元人物与静态插画风格。技能不固定模型版本。

发布内容是技能指令和制作参考文档。仓库暂未提供人物模型、示例渲染、训练权重或一键三维重建程序;安装与检查脚本只服务于技能分发。

能力与流程

阶段内容
输入检查查看原图和已有工程,确认范围、用途与必须保留的特征,标明范围假定
九视图参考新角色默认生成水平八方向与正上方共九张独立参考,检查方向、尺度与特征
配准与脸部统一相机与关键点,先用正、侧、斜侧灰模检查脸型、下巴收口与深度,再完善五官
头发与材质主发束与原生细丝、发根覆盖、冠部长发衔接、局部 UV、透明边缘与高光
局部修复保留用户修改,分层定位肤色灰白、虹膜取样、镜片影响、缺口、穿插与 UV 拉伸
验收交付固定相机对照,分别报告外形、工程和用途检查,注明 UV 与穿插检查范围,打包并重开最终 .blend

局部修模直接进入相关阶段;仅整理文档不生成图片或修改工程。范围假定须说明,用户未答复不能视为同意删减原图可见部件。每轮修改先比较问题视角及相邻视角的实际渲染,未改善时重新定位原因;稳定后再从明确保存的同一版本输出交付多视图。

静态插画质感与遮挡诊断 包含图片纹理 UV 验收、保留腮红的肤色调整、眼面/虹膜/镜片分层检查,以及支撑面、内层与细丝的隔离诊断。执行可靠性 补充原生曲线与着色模式输入检查、局部修改的状态保留和实时视口异常恢复。

全身、服装、绑定、动画和打印有按需扩展指导,当前公开包尚未提供这些用途的端到端验证案例。

环境与依赖

组件何时需要
支持技能、图片查看及本地工具调用的 Agent 环境执行工作流;提供 Codex 界面元数据
本地 Blender 与内置 Python/CLI建模、渲染和工程检查;先检测实际版本,仓库没有已验证的跨版本兼容矩阵
图像生成工具及 imagegen 技能生成九视图或补纹理时;由宿主提供,本仓库不包含
UI 自动化或 Blender MCP可选;CLI 可用时不要求 MCP
外部 Python 3.10+使用安装与维护脚本时;手动复制技能不需要
PyYAML仅维护检查需要,见 requirements-dev.txt

没有图像生成能力时,可提供已经检查合格的九视图,或明确调整本次视图范围。安装技能不会自动安装 Blender、图像模型或第三方创作软件。

安装

下载或克隆本仓库后,在仓库根目录运行:

python3 scripts/install.py

默认复制到用户的 ~/.agents/skills/blender-character-workflow/。同名目录已存在时,安装器停止并保留原内容;更新前自行备份和移走旧目录。安装器不会启动 Blender、联网或修改 Agent 配置。

安装器只复制 scripts/install.py 中 PACKAGE_FILES 明确列出的技能文件,排除缓存、本地配置和额外素材,并拒绝包含符号链接的源目录。全部文件先复制到临时目录,成功后再移至目标位置;失败会清理临时产物,允许修复后重试。

也可指定技能父目录,例如目标项目内的 .agents/skills,或宿主实际使用的其他技能目录:

python3 scripts/install.py --destination /path/to/your-project/.agents/skills

手动安装时,将整个 skills/blender-character-workflow/ 文件夹复制到技能目录,保留其中的 LICENSE 和原文件夹名称。

Codex 的用户与项目技能路径及发现方式见 OpenAI 官方技能文档。安装后若未显示,重新启动 Codex,并检查其他目录是否已有同名技能。

使用示例

在支持 $ 技能引用的 Codex 界面中输入以下内容,并附上原图或实际工程路径:

使用 $blender-character-workflow,按照这张参考图制作头部和头发,
不要脖子和身体,用于静态多角度展示。先完成九视图参考,再继续建模。
使用 $blender-character-workflow,修复现有工程的刘海缺口和头顶 UV 拉伸。
保留当前脸型、眼睛和后发,在新版本中修改,并提供修改前后的固定视角对比。
使用 $blender-character-workflow,检查这个 blend 的贴图依赖和多视图表现。
只做只读检查,分别说明外形、工程和用途方面实际检查了什么。

准备输入时说明主参考、制作范围、用途、必须保留的特征和输出格式。目标交付包括 .blend、来自同一版本的真实渲染、必要资源和简短检查说明。

使用边界

  • 生成的侧后方和顶部属于设计补全;原图是主基准,生成图不是严格一致的三维投影。
  • 灰模、工程重开和少量关键点误差分别提供有限证据,不能代表整体相似度获得认可。
  • 原画局部 UV 可保留绘画光影;换光、动画和实时导出需独立检查。
  • 图片全部使用 UV 不等于每根发丝都有独立绘制图集;零越界、零退化或有限穿插采样不代表无拉伸、笔刷可用或整个装配无穿模。报告须注明检查对象、方法及未覆盖部分。
  • 静态展示通过不等于动画或打印可用,只承诺实际验证过的用途。

仓库结构

skills/blender-character-workflow/
  SKILL.md                         技能入口
  LICENSE                          随技能分发的许可证
  agents/openai.yaml               Codex 界面元数据
  references/production-workflow.md
  references/blender-reliability.md
  references/static-illustration-finish.md
scripts/                           安装与仓库检查
tests/                             分发行为检查
docs/releasing.md                  GitHub 发布准备

详细流程从 SKILL.md 进入。技能正文目前以中文维护,英文 README 提供安装、范围与使用说明。

参与维护

欢迎提交可复现的问题、流程改进和有明确授权的案例,见 贡献指南。维护检查:

python3 -m venv .venv
source .venv/bin/activate
python3 -m pip install -r requirements-dev.txt
python3 scripts/validate.py
python3 -m unittest discover -s tests

上面的激活命令适用于 POSIX Shell;Windows 可使用 .venv\Scripts\Activate.ps1。GitHub Actions 运行相同检查,并用 scripts/check_whitespace.py 检查 PR 或 push 的实际提交范围;首次推送和手动运行检查整个提交树。检查范围是分发结构和安装行为,不执行人物建模。

许可证与素材

指令、文档和辅助脚本采用 MIT License,许可证随技能一并分发。人物参考图、角色设计、贴图和外部模板的权利需单独确认;仓库许可证不替第三方素材授予使用权。

这是社区项目,与 OpenAI 或 Blender Foundation 无官方隶属关系。

// HOW IT'S BUILT

// FILES

2 files shipped with this skill. Inline text is the catalog copy. The upstream link is the source repository.

  • skills/blender-character-workflow/SKILL.md8.6 KBupstream ↗
    ---
    name: blender-character-workflow
    description: 根据人物设定图在 Blender 制作或修复可编辑角色,组织参考配准、脸部与头发塑形、多视图验收,以及按需扩展全身和绑定。适用于二次元人物还原、完整脸部制作和角色工程交付;不用于单纯生成二维人像或无关的 Blender 场景。
    license: MIT
    ---
    
    # Blender 人物制作工作流
    
    以用户选定参考和用途为目标,交付实际可打开的工程及能够说明相似度和可用性的渲染证据。原型、静态角色、动画角色是不同完成范围。不能从脚本运行成功推断造型还原成功。
    
    局部改善、文件重开和几何一致性检查不等于用户认可整体相似度。用户要求精细复刻时,只有主要识别特征的草模仍是中间结果;原图纹理带来的质感改善也不能证明隐藏结构正确。不要保证“完美复原”。
    
    ## 开始工作
    
    - 读取项目说明,检查原图、已批准参考、现有模型、贴图、脚本和实际 Blender 版本。先查看图像内容,不能只凭文件名或对话中的文字描述建模。
    - 对话引用不含图片时,尝试读取原对话和已知项目资源。仍无法取得目标图时,请用户补发;不要自行换一个人物继续。
    - 从请求判断范围。只修脸部时保留无关身体和头发;完整人物才进入全身阶段。用途不明确而影响拓扑、绑定或交付格式时,询问这一项,同时推进不依赖回答的资源检查。合理假定的范围要标明;未答复不等于用户确认删减原图可见部件。
    - 后续反馈持续更新当前范围和待修项。“头部和头发”不自动包含脖子;用户明确不要的部件应移除。保留用户纠正过的脸型等约束,修好一项后继续处理其余已要求的问题。
    - 默认在新版本中工作,保留用户手工修改。新参考若换了角色,建立独立版本链,不沿用旧人物特征。
    - 仅记录操作、复盘或更新技能时,不重新生成、修改或切换 Blender 工程;将项目路径、参数与历史证据留在项目文档,将可复用判断写入技能。
    
    ## 建模第一步:生成九视图参考
    
    根据原图开始新角色建模时,先生成并检查 9 张独立参考图,再进入参考配准和几何制作。已有同一角色、同一版本且检查合格的九视图时直接复用,缺图只补缺项;局部修模不重复生成整套参考。用户明确调整视图范围时遵从用户要求。仅更新技能或文档不触发图像生成。
    
    - 水平每隔 45° 一张:正面 0°、左前 45°、左侧 90°、左后 135°、背面 180°、右后 225°、右侧 270°、右前 315°;另加正上方顶视图,共 9 张。默认不生成正下方图片。
    - 左右以角色自身为准:左侧鼻尖朝画面右,右侧鼻尖朝画面左。顶视相机从正上方向下看,角色前方朝画面下;不能用低头正面图代替顶视。
    - 先读取 imagegen 技能并查看原图,使用内置图像生成工具,每个视角单独调用。所有视角共同引用同一原图和人物特征约束,保持脸型、五官、发型、颜色、表情及当前制作范围;只做头部和头发时不添加脖子或身体。
    - 统一白底、方形画幅、完整轮廓和留白;水平视图要求相同尺度、相机高度和正交投影。逐张检查实际方向、裁切与人物特征,再横向比较轮廓、关键点和发束结构;明显错误的视图先修正,不能只按文件名验收。
    - 原图保留为主基准,侧后方和顶部的隐藏结构标明为设计补全。生成图未经几何标定,存在冲突时以原图为准并记录需要建模统一的部分,不能当成严格一致的三维投影。
    - 将 9 张独立图片、原图、视角名称、提示词及来源保存到项目内独立版本目录,提供可逐张查看的索引。完成参考检查后继续建模,不因生成参考图完成而结束建模任务。
    
    ## 制作和验收
    
    开始制作时读取 [制作与验收流程](references/production-workflow.md),按当前阶段使用对应内容,不必执行所有阶段。
    使用生成脚本、批量变形、自动取景或修改现有工程时,再读取 [Blender 执行与版本可靠性](references/blender-reliability.md),其中也包括参数中线与周期接缝检查。
    用户强调原图质感、丝滑发质、UV 对齐、光照、肤色灰白或腮红,或处理局部 UV、发片透明边缘时,读取 [静态插画质感与遮挡诊断](references/static-illustration-finish.md),按需使用肤色灰白诊断、图片纹理 UV 验收、细丝发质与冠部长发衔接的方法。
    精修眼神时使用该文的“眼面、虹膜与镜片”分层诊断;发根和后脑接口先隔离支撑面、内层与细丝。原生曲线检查、着色模式输入及实时视口异常的处理见执行可靠性文档。
    连续修发质时,按该文的“发质修正闭环”先定位责任曲面与纹理,再决定修改;保留可用基线,并区分已采用、已否定和待验证的试验。
    刘海出现规则缺口、鬓发混入肤色,或顶视出现中心破洞和放射拉伸时,重点检查该文中的边界采样、面内 UV 插值和极点结构。
    
    1. 先完成上方九视图生成与检查,再记录参考来源、可见信息、补绘内容和未知区域;检查多视图是否互相矛盾。
    2. 配准参考和相机,保存单位、坐标轴、画幅、裁切、投影方式和关键点;不明视角按近似参考处理。
    3. 优先复用适合角色风格、来源允许使用且实际可编辑的头部模板。先做低细节脸型与五官体积,观察正面、侧面和斜侧面,再增加密度。
    4. 做完整脸部时覆盖眼球/眼面、眼睑与眼角、眉睫、鼻部、唇缝与口周、下巴和耳部;颈部衔接仅在包含脖子时制作,口腔、牙齿、视线、闭眼和表情随用途决定。
    5. 在投入完整发型与材质前,先用隐藏头发的正、侧、斜侧灰模检查脸部粗形,特别检查下巴底部收口与侧面深度。原图投射和烘焙阴影不能代替几何检查。
    6. 按用户范围扩展身体、服装、配饰和绑定。脸部未达标时,不用增加全身细节掩盖核心问题;若用户明确优先全身,遵从其顺序并说明脸部状态。
    7. 局部关键视图复核后,再从明确保存的同一版本工程输出交付多视图,分别报告视觉相似度、网格/资源有效性和用途可用性。注明 UV 和穿插检查的对象、方法及未覆盖部分,只报告实际执行的检查。
    
    如果一轮修形没有改善主要问题,定位是参考冲突、相机、模板结构还是修改方式的问题;更换必要的方法后再迭代。不要不断增加细分或微调参数却不比较实际渲染。没有可靠输入或工具能力不足时,说明具体缺口,保留可复用成果,不伪造完成状态。
    
    ## 工具选择
    
    - 批量构建、参数修改、渲染、打包与检查可使用 Blender Python/CLI;交互观察、雕刻和最终打开检查可使用可用的 UI 工具或结构化接口。
    - 先检查连接能力。MCP 未连接不代表 Blender 不可用;若本地 CLI 可用,可直接继续。不要把某台机器的安装路径或某次版本写成通用依赖。
    - 需要补绘设定图或生成纹理时,使用当前可用的图像生成能力,并读取相应技能。保留来源和提示词,标明新增设计;补图不能当作隐藏几何的测量证据。
    - 本技能不附带图像生成服务或 `imagegen` 技能。新角色缺少九视图且环境没有相应能力时,说明具体缺口并请求补齐参考或调整视图范围;可继续资源检查,不伪造已完成的参考。已有合格参考或仅局部修模时,继续不依赖图像生成的工作。
    - UI 粘贴超时后先查看输入是否已经出现,再决定重试,避免重复执行。将界面状态、CLI 退出码、输出存在与实际内容分别确认。
    
    ## 交付与清理
    
    制作交付包含当前 `.blend`、实际渲染对比、必要检查结果及简短说明。打包后重新打开最终文件,确认贴图、相机、可编辑对象和修改器状态。只对已验证用途作承诺;没有测试动画就不称为可动画角色。
    
    用户要求清理时停止相关写入任务,枚举当前授权项目的工程和备份,优先移入废纸篓并保留恢复清单,验证残留及当前打开场景。明确清理原生 `.blend`/数字备份还是整个生成目录;范围明确的请求直接执行,不重复确认。不要将清理一个项目扩大为删除其他项目、原始参考、软件或资源包。同步文档中已经失效的工程路径。
    
  • README.mdupstream ↗

    Contents are not inlined in the catalog. Open the upstream file.

Plain-text copy, no login: /skill-bundles/icesixgod-awesome-astra-blender-characters-skills-blender-character-workflow.md

// REPO STATS

128 stars
0 open issues
Last commit: 2mo ago