blender-skill-harmonizer
Harmonize multiple Blender skills into a coherent pipeline with clear activation precedence, handoff artifacts, dependency gates, and conflict-resolution rules. Use when a Blender task spans several skills, when reference-locked work conflicts with generic production workflow, after adding/updating skills, or when repeated failures indicate skill interference or missing inter/intra-play.
CheshireJCat · 已有 AI 审核记录
安装与使用
运行命令前先阅读来源与依赖说明。复制命令不会自动安装或执行。
npx skills add CheshireJCat/blender --skill blender-skill-harmonizer技能说明
name: blender-skill-harmonizer description: Harmonize multiple Blender skills into a coherent pipeline with clear activation precedence, handoff artifacts, dependency gates, and conflict-resolution rules. Use when a Blender task spans several skills, when reference-locked work conflicts with generic production workflow, after adding/updating skills, or when repeated failures indicate skill interference or missing inter/intra-play. when_to_use: Multi-skill Blender orchestration, skill graph audits, resolving overlaps between create-3d-model/pro-workflow/reference-to-3d/wireframe/UV/fit/repair skills, defining source-of-truth precedence, artifact contracts, and sequential-vs-parallel execution plans. allowed-tools: Read Bash Glob Grep blender_python blender_scene_info blender_scene_info
Blender Skill Harmonizer
This is the meta-layer for the Blender skill stack. It prevents independently useful skills from producing incoherent work when combined.
Use a Merge → Consistency → Optimize → Store cycle:
- Merge: list all triggered skills and their intended outputs.
- Consistency: detect conflicts in assumptions, coordinate systems, source hierarchy, object naming, or validation gates.
- Optimize: choose one orchestrator, one source-of-truth policy, and a staged/parallel execution plan.
- Store: write the chosen plan and durable lessons into project docs/memory.
Skill category map
- Top-level orchestrators:
create-3d-model,quality-refinement-autoloop,mascot-logo-reconstruction. - General production:
blender-pro-workflow,blender-modeling,blender-materials,blender-lighting,blender-cameras,blender-rendering,blender-animation,blender-export. - Reference reconstruction:
reference-to-3d,wireframe-to-3d,reference-analysis-validator,source-part-segmentation,orthographic-registration,multiview-constraint-solver,contour-to-mesh,texture-driven-mesh-fitting,landmark-fit-repair,multiview-fit-loop,fit-repair-optimizer. - Texture/UV:
blender-uv-texturing,atlas-uv-fitting,closed-surface-uv-coverage. - Look calibration:
reference-look-calibration. - Animation/motion design:
texture-state-animation,orbital-hud-motion,animation-quality-gate, coordinated byblender-animation. - Task-specific/full workflow:
mascot-logo-reconstruction.
Activation precedence
For a task involving references/templates/textures:
blender-skill-harmonizer— choose the pipeline and conflict policy. 1a.quality-refinement-autoloop— if output is rejected/subpar, freeze product work, diagnose, sanitize/patch generic skill knowledge, validate, then retry.reference-analysis-validator— source manifest and source-of-truth classification.orthographic-registration— view consistency and coordinate contract.multiview-constraint-solver— rigid feasibility and canonical view policy.fit-repair-optimizer— dependency repair queue if validation fails.source-part-segmentation— split overlapping structural/decorative masks.contour-to-mesh/wireframe-to-3d/blender-modeling— geometry, selected by source type.texture-driven-mesh-fitting+landmark-fit-repair— fit mesh boundaries and named landmarks to source/texture.atlas-uv-fitting/blender-uv-texturing/closed-surface-uv-coverage— UV, texture fit, and full front/back/side surface coverage.multiview-fit-loop— render/compare/adjust loop.reference-look-calibration+blender-materials/blender-lighting/blender-rendering— look only after geometry/UV gates.blender-export— only after validation gates.blender-animation— only after static fit acceptance.texture-state-animation/orbital-hud-motion— design texture/HUD motion as layered, source-derived animation.animation-quality-gate— render contact sheet and reject bad motion before final export.
Generic blender-pro-workflow is subordinate to the reference-locked order whenever the source is a template/brand asset.
Shared artifact contract
Every non-trivial multi-skill pipeline should keep these files in the output folder:
reference_manifest.jsonregistration_report.jsonatlas_regions.jsonvalidation/multiview_fit_report.jsonvalidation/*_overlay.pngALIGNMENT_REPAIR_QUEUE.jsonor equivalent when gates failBUILD_NOTES.md
Conflict rules
- Source conflict beats implementation. If templates disagree, stop claiming final fit and write a conflict report.
- Front-view brand read beats side/back/top unless canonical policy says otherwise.
- Reference-locked geometry beats generic modeling. Do not primitive-first rebuild after a contour/source mask exists.
- UV/texture fit waits for geometry lock. Texture audit may run in parallel, but final UV assignment waits.
- Lighting/look waits for material and camera lock. Do not tune lights to compensate for wrong geometry.
- Export waits for validation. No final GLB without pass/fail reports.
Sequential vs parallel orchestration
Sequential gates:
- source conflict / multiview rigidity
- structural part count
- front geometry
- multiview geometry
- UV/material texture fit
- lighting/look
- export/animation
Parallel lanes allowed after their blockers clear:
- atlas region classification can run while geometry is being repaired;
- lighting reference statistics can run while UVs are being prepared;
- export target checks can run while visual validation is pending;
- validation tooling improvements can run anytime, but must not mutate product geometry.
Read when needed
references/handoff-contracts.mdfor exact input/output contracts between skills.
Script
scripts/skill_graph_audit.pyaudits the local manifest, roles, missing paths, and overlap warnings.
Animation handoff rule
For reference-locked mascots/logos, animation is not a generic spin/
阅读完整来源 ↗