Dcc Mcp Skills Creator

核心用法

dcc-mcp-skills-creator 是 DCC-MCP 生态的基础设施层技能，专用于创建、验证和审查 DCC-MCP 技能包。它通过统一的 SKILL.md 元数据规范、tools.yaml 工具契约和脚本脚手架，实现跨 Maya、Blender、Houdini、Unreal 等宿主的标准化技能开发。

关键工作流

1. 技能创建：生成 SKILL.md 前端配置、tools.yaml 工具声明、scripts/ 脚本目录结构
2. 合规验证：检查命名规范（kebab-case 技能名、snake_case 工具名）、架构版本、依赖声明
3. 契约审查：验证 input_schema/output_schema 显式声明、execution 模式、affinity 线程亲和性、annotations MCP 语义标记

目录规范

my-skill/
├── SKILL.md          # 元数据 + 使用说明
├── tools.yaml        # 工具契约（schemas、execution、affinity、annotations）
├── scripts/          # 实现脚本（惰性导入，支持无宿主运行）
└── references/       # 扩展文档、配方、API 参考

显著优点

• 标准化契约：强制显式 JSON Schema、避免运行时 Python 反射推导，保障 MCP 网关可静态分析
• 渐进加载：支持 metadata.dcc-mcp.depends 声明式依赖，实现按需激活的技能拓扑
• 线程安全：enforce_thread_affinity: true 确保宿主 API 调用在正确线程执行，防止 Maya/Blender 等单线程宿主崩溃
• 工具链整合：内置 validate_skill_dir CLI 与 Python API，CI/CD 友好
• 网关搜索优化：标准化 tags 分类（pipeline、production-tracking、shotgrid、ftrack、docs、read-only、destructive）支持 AND/OR 组合过滤

潜在局限

• Python 3.7 锁定：2026-12-31 前必须保持 py37 兼容，限制现代语法与依赖版本
• 无运行时反射：禁止依赖 Python 动态推导缺失 schema，增加手工维护成本
• 严格目录结构：metadata.dcc-mcp.* 扩展键必须置于前端配置，顶级 version 等字段会被拒绝
• 非全适配器创建：仅创建技能包，完整 DCC 适配器仓库需使用 dcc-mcp-creator

适合人群

• DCC 工具链开发者（Maya/Blender/Houdini/Unreal/3ds Max/ZBrush 插件作者）
• 动画/特效工作室 Pipeline TD，需构建跨宿主自动化工作流
• MCP 网关管理员，需统一技能元数据与搜索发现策略

常规风险

• 版本迁移风险：metadata.dcc-mcp.version 与顶级 version 语义冲突，旧技能需手动迁移
• 依赖漂移：depends 声明为技能名而非仓库名，跨组织共享时需协调命名空间
• 宿主线程违规：affinity: main 工具若在后台线程调用宿主 API，可导致崩溃或数据损坏
• Schema 维护负担：高频迭代工具需手动同步 call_examples 与 schema，易与实际实现脱节