mcpField
B
blender-iterative-refinement

blender-iterative-refinement

github.com/ifbars创意与媒体9790 次安装5 天前更新
代码仓库

关于 blender-iterative-refinement

用于 Blender 场景迭代优化的技能,在已有候选成果上进行独立审查、针对性源文件修复和同条件复检。通过需求台账、证据对比与回滚决策,判断修复是否改善结果且未引入回归。

主要功能

  1. 01冻结并记录候选成果与约束
  2. 02逐项审查可见证据并标注结果
  3. 03按优先级定位关键缺陷
  4. 04修复源文件并重新生成成果
  5. 05同条件复检并决定保留或回滚
  6. 06记录迭代决策与证据路径

适用场景

  1. 01检查 Blender 场景是否满足视觉要求
  2. 02修复模型、变形或导出缺陷并复核
  3. 03比较修复前后的场景与任务指标
  4. 04记录迭代过程并保留原始候选版本

安装

复制下面的命令,在终端中运行。

$npx skills add https://github.com/ifbars/blender-agent-studio --skill blender-iterative-refinement

安装后在 Claude Code 中输入/blender-iterative-refinement确认已加载。

附带文件agents/openai.yamlreferences/astra-workflow.md

详细介绍

Blender 迭代优化

每项任务开始时,阅读一次共享执行指南,以了解自主决策、证据收集频率和长任务连续性。

从相关创建工作流生成的完整候选版本开始。 不要替换其常规构建阶段。此技能会增加一个有界的评审环节、源文件修复、同条件复查和回滚决策。

冻结候选版本

  1. 将用户可见的需求整理为关键要求、其他可见要求、技术门槛和明确排除项。
  2. 记录修复必须保留的不变量:比例、整体世界坐标边界、朝向、名称、层级、动画范围、材质、已批准形态、可编辑系统和导出行为。
  3. 保留候选版本的源文件、创作产物、新导出的导入文件、指标、主视图、固定多视图联系表,以及所需的动画或形变帧。绝不要覆盖候选版本的唯一副本。

执行独立评审

将评审与编辑分开:冻结候选版本,并先评估其证据,再选择修复方案。可以单独进行自我评审;除非用户或基准测试协议要求,否则不必使用第二个 Agent。

使用图像查看工具打开保留的图像。编辑前,为每项关键要求记录 pass、fail 或 unclear,并引用能够证明判断的视图或帧。名称、源代码、层级和指标都不能让缺失、被遮挡或无法辨认的主体通过视觉评审。

将透射外壳和发光主体视为相互关联的可见性问题。检查实际目标渲染引擎和曝光:有效的着色器节点图并不足够,因为玻璃可能变得不透明,发光也可能泛白成一团。被包围的主体必须在每个必需视图和动画采样中都保留可追踪的轮廓及局部色彩对比。

按以下顺序优先处理:

  1. 主要主体、所需操作或关键关系缺失或无法辨认;
  2. 确定性门槛或任务总体限制未通过;
  3. 几何体、形变、接触、材质、光照或导出方面的严重缺陷;
  4. 次要润色。

对于可见机构,在关键帧中追踪完整因果链:驱动器、连接件、固定点、枢轴或导轨、运动部件和最终状态。连接部分过细、被遮挡或对比度过低时,应标记为 unclear,即使数值端点残差通过也不例外。

如果可用,请使用相同的选择和明确约束,保留候选版本与修复版本的 blender_quality_report 输出。然后调用 blender_compare_scenes,并以保留的候选版本为基线。根据冻结的约定声明必需部件和不变量;如果修复部件允许有意移动或改变尺寸,请使用 invariantObjects。即使对象结果分页显示,其错误也涵盖所选的整个装配体。将数值发现和事实差异与视觉评审记录分开:review_required 不代表通过,边界重叠本身也无法证明网格相交。保留修复前先比较实际证据;这并不意味着存在美学评分或自动检查点工具。

修复持久源文件

找出能够解决优先级最高缺陷的最小源文件层面原因。在持久化的 Python 或可编辑 Blender 源文件中进行一次有针对性的修复,或进行一组紧密相关的修复。重新生成创作产物和导出产物;不要手动修补派生产物。

如果主要主体或因果布局有误,仅做小范围外观修改并不足够。应先重建主要部分,再花精力润色。

复核并决策

重复使用完全相同的 Blender 可执行文件、检查器、摄像机、帧、渲染设置、导出/导入路径和任务门槛。并排比较候选结果与修复结果。只有在满足以下条件时,才保留修复结果:

  • 目标缺陷有所改善或已通过;
  • 实际最终证据满足所有关键可见要求;
  • 先前的硬性门槛、任务限制或关键要求均未退化;
  • scene.bounds.dimensions 的整体尺寸(而不仅仅是最大网格的尺寸)满足任何全局尺寸限制;
  • 用户已接受任何有意做出的权衡。

否则,恢复已保留的候选结果,并说明拒绝修复的原因。只有证据表明保留的结果更好时,第二轮修复才有价值。

记录迭代

编写 iteration_review.json,其中包含约定、候选结果的证据路径、需求清单、选定的缺陷、根本原因、修复内容、不变量检查结果、最终证据路径,以及取值为 retain_repair、retain_candidate 或 blocked 的 decision。将创作者的自我审查与基准评判分开:不要向创作者透露隐藏阈值、条件标签、竞争作品或评判反馈。

评论

支持 Markdown