前言¶
做 3D 资产时，常见做法是拆成多段工具链：生成或手建网格、展 UV、做 PBR、渲染出图，再减面、转格式给引擎或打印。每换一步就要换软件或脚本，提示词也很难覆盖「从描述到可导出文件」的完整约束。若你希望在同一次对话里，用自然语言驱动建模、材质、渲染和导出相关步骤，可以把 SkillHub 上的 3D建模师（@user_df5e9a0b/3d-model）装进当前 Agent，由技能文档约束流程与术语。
这是什么¶
3D建模师 是 SkillHub 分类 design-media 下的社区技能（来源：community），坐标 @user_df5e9a0b/3d-model，当前版本 1.0.0，发布者为 user_df5e9a0b。
官方简介将其定位为「完整 3D 建模全流程」技能：在需要从文字描述或参考图得到三维模型、做多边形/曲面/雕刻/参数化建模、制作 PBR 材质与 UV 展开、配置实时或离线渲染与光影后期、或做拓扑优化/减面/LOD/格式转换导出时使用。场景覆盖游戏资产、3D 打印、电商展示、影视预演等，并写明支持 AI 生成 与 Blender 脚本 两条技术路线。页面标签 requires_api_key=false，表示未标注必须配置 API Key（具体仍取决于你本地环境与 Agent 所调用的外部服务）。
- SkillHub 页面：https://www.skillhub.cn/skills/user_df5e9a0b/3d-model
- API 元数据：https://api.skillhub.cn/user_df5e9a0b/3d-model
（SkillHub 抓取元数据：评分 100000，下载 6104。）
核心功能¶
下列能力均来自官方简介，未在公开页单独拆步骤的环节不展开臆测。
- 输入与生成：从文字描述或参考图生成/推进三维模型。
- 建模方式：多边形、曲面、雕刻、参数化建模。
- 材质与 UV：PBR 材质制作、UV 展开。
- 渲染与后期：实时或离线渲染、光影与后期相关设置。
- 资产优化与交付：拓扑优化、减面、LOD、格式转换与导出。
- 实现路径：AI 生成路线与 Blender 脚本路线并行说明，便于在对话里选型。
安装与启用¶
SkillHub 页面给出的安装提示是：按 SkillHub 安装文档 安装坐标 @user_df5e9a0b/3d-model。下面介绍与文档一致的 CLI 方式；若你更习惯对话安装，可把页面上的提示词发给 Agent，效果等价于引用同一坐标与安装说明。
1. 检查或安装 skillhub CLI¶
先确认本机是否已有 CLI：
command -v skillhub && skillhub --version
未安装时，可用官方脚本（完整安装含默认 Skill；仅需 CLI 时加 --cli-only）：
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash
2. 安装到当前 Agent 的 skills 目录¶
安装技能时必须用 --dir 指向当前 Agent 实际读取的 skills 目录，否则默认落在 ./skills/ 可能不会被识别。官方文档列出的常见路径包括：
- Cursor：
~/.cursor/skills/ - Claude Code：
~/.claude/skills/ - Codex：
~/.codex/skills/或项目下的.agents/skills/
在 Cursor 中示例（将目录换成你的环境）：
skillhub install @user_df5e9a0b/3d-model --dir ~/.cursor/skills/
也可先搜索再安装：
skillhub search 3d-model
skillhub install @user_df5e9a0b/3d-model --dir ~/.cursor/skills/
经过上面的步骤后，按你所用 Client 的要求重启或刷新 Agent，使新技能被加载。公开资料未提供该 Skill 包内 SKILL.md 的逐条触发词；启用后一般以「任务描述是否落在简介所列场景」为准。
典型用法¶
公开页未附带可复制的建模命令或 Blender 脚本片段，典型用法是：安装技能 → 在对话中说明目标与约束 → 由 Agent 按技能文档组织流程。可按简介中的触发条件组织需求，例如：
- 文生/图生模型：说明主体、比例、面数或用途（游戏/打印/电商），并是否提供参考图。
- 材质与 UV：说明贴图通道需求（PBR）、分辨率与是否需展开 UV。
- 渲染：说明实时预览还是离线出图，以及光照/后期倾向。
- 交付：说明目标格式、LOD 层级或减面比例。
若你选择 Blender 脚本路线，在对话中明确要求生成或调整 bpy 相关步骤即可与技能自述一致；AI 生成路线则依赖 Agent 与本地已配置的可调用能力，SkillHub 页面未列出具体模型或接口名，文中不虚构。
适用场景与注意¶
适合谁：需要在同一 Agent 会话里串联 3D 工作流的产品、技术美术、独立开发者，或希望用自然语言驱动 Blender/生成类任务、又不想每次手写完整流程说明的人。
场景：游戏资产、3D 打印、电商展示、影视预演等，与官方简介一致。
注意：
- 全流程能力依赖 Agent 对技能内容的遵循程度，以及你本机是否安装 Blender、是否具备可用的生成类工具；SkillHub 元数据未承诺一键出成品网格文件。
requires_api_key=false仅表示技能标签未强制 API Key；若对话中接入第三方生成服务，仍需你自行配置密钥与合规审查。- 评分与下载量来自 SkillHub 页面元数据，会随时间变化，引用时以官网为准。
结尾¶
3D建模师 把从描述/参考图到建模、PBR 与 UV、渲染后期、减面与导出的需求收拢到一条 Skill 坐标上，并标明 AI 与 Blender 脚本双路线，适合作为 design-media 类 Agent 的常驻能力。安装与坐标以 SkillHub 为准：
- https://www.skillhub.cn/skills/user_df5e9a0b/3d-model
- 安装说明：https://skillhub.cn/install/skillhub.md
