用途
Quality Refinement Autoloop 是一个面向 Blender 任务的自我精炼循环技能。当用户认为结果错误、难看、不对齐、未贴图、未动画、不可导出,或整体低于预期时,应使用本技能。它的目标不是持续盲目微调,而是先把失败转化为可复用、通用的技能改进,再重新尝试。
主要能力
该技能围绕 Autoloop 阶段组织流程,包含以下环节:
-
冻结与保留:立即停止对产物做修改;保留最后一次被接受的基线以及失败产物;如实命名失败分支或版本,不覆盖已被接受的输出。
-
证据捕获:收集能证明失败的最小证据集,包括用户反馈引用或总结、使用的源文件或参考文件、当前输出路径或版本、相关渲染、联系表、叠加图或审计报告,以及当失败发生在 Blender 内部时的场景、材质、对象清单。
-
失败维度诊断:对主要缺口进行分类,例如几何/轮廓/地标、多视图或深度一致性、UV/图集/贴图适配、闭合表面覆盖(正/背/侧)、外观/材质/灯光校准、动画/运动/导出真值、技能之间的编排与交接,或缺失验证器、缺失确定性辅助脚本。
-
技能缺口决策:先判断当前技能栈中是否已有针对该失败的通用方法。若有,运行现有技能并修复产物;若无,先添加或精炼通用技能,再修复;若反复失败来自技能之间的交互,应更新协调器或交接规则,而不仅是叶子技能。
-
经验消毒:在写入技能变更前,移除项目、客户、资产名称;移除机密、原始日志、私有路径、个人数据和受版权保护的源内容;只保留可复用的方法、门禁、脚本和失败模式;以通用方式描述输入输出;对脆弱审计优先使用确定性脚本。
-
技能补丁:应用最小的可发布变更,例如一个简洁技能或现有技能中的一个简洁章节、可选辅助脚本(当验证可重复时)、协调器更新(当顺序或交接变化时),以及清单条目或版本更新。
-
技能变更验证:必需检查包括脚本可编译、清单路径存在、带协调器的技能图审计通过、项目特定术语的消毒扫描通过;如适用,对失败产物运行新辅助脚本并保存报告。
-
技能门槛通过后修复产物:仅当技能门槛通过后,再从正确基线使用改进后的技能重建或修复。除非明确标记为源证据,否则不要复用被拒绝的输出。
-
发布准备(当被请求时):仅当用户要求发布、提交或推送时,拉取最新远端并确认本地分支已同步;在暂存前解决或协调冲突;根据范围使用合适的语义化版本递增;在相关时更新 README、插件 README、CHANGELOG、VERSIONING;运行消毒器和编译或审计检查;使用配置的远端执行暂存、提交和推送。
使用方式
在首次调用 Blender 之前,先阅读 ../text-to-blender/references/mcp-backends.md。对于共享能力,优先使用官方 MCP;在整个任务中保持所选后端不变。配方中的工具名属于客户端或旧版示例,需要按该参考及其 agent-host 指南进行映射。
适用场景
适用于以下情形:输出质量不达标、用户拒绝质量、重复出现 Blender 失败、RALPH 循环、技能缺口诊断、自主技能精炼、消毒后的技能贡献、发布准备、文档/版本递增、分阶段提交与推送工作流。
硬性规则
不要把任务特定的示例硬编码进公开技能。除非真实网格表面也通过覆盖门禁,否则不要把叠加曲线或平面称为“贴图覆盖”。不要通过调整灯光或材质来掩盖几何或 UV 失败。如果效果只存在于 Blender Python 或渲染序列中,就不要声称支持导出。没有用户明确请求且远端已检查为最新时,不要推送。
推荐产物
运行循环时,建议在项目输出附近保存以下产物:RALPH_OR_QUALITY_LOOP_REPORT.md、failure_evidence/ 或对现有渲染与报告的引用、skill_gap_decision.json、sanitization_report.json、validation_report.json。
脚本
scripts/ralph_autoloop_plan.py:根据反馈或产物线索生成通用的失败分类与循环计划。
scripts/sanitize_skill_contributions.py:在发布前扫描技能文件中的项目特定或私有术语。
scripts/release_readiness_check.py:在提交或推送前执行轻量级清单、文档、版本和路径检查。