diff --git a/skills_library/pipelines/platform_general/common/model-auto-config/SKILL.md b/skills_library/pipelines/platform_general/common/model-auto-config/SKILL.md
index 9739445..3d7540f 100644
--- a/skills_library/pipelines/platform_general/common/model-auto-config/SKILL.md
+++ b/skills_library/pipelines/platform_general/common/model-auto-config/SKILL.md
@@ -193,6 +193,12 @@ llm_model 的 price_input/price_output/cost_input/cost_output 四字段已删除
 - **下行（response_template）**：上游生成物 URL 用
   `{{ downloadfile2url(request, output.video_url) }}` 落地为本地持久 URL
   再给调用者——**上游 URL 有效期极短（DashScope 视频仅 24 小时），不落地即丢**。
+  ⚠️ **usage 值禁止加包裹引号**（2026-09-06 E2E 实测坑）：写成
+  `"usage": "{{ json.dumps(usage) }}"` 时，usage 非空（如 `{"video_duration":5}`）
+  内层双引号会破坏外层 JSON 字符串值 → `json.loads` 断在 char 161，整个 response
+  渲染回退、**生成物静默不落地**（media=None，调用却不报错）。正确形态是嵌套对象
+  `"usage": {{ json.dumps(usage) }}`（值不带引号）。生成器 `_media_response_template`
+  已修；存量模板若发现此形态需直接 UPDATE 修库。
 
 同类能力对外契约统一：i2v/r2v 一律 `image_files` 进 → `video` 出；t2i 出 `image`。
 旧单值别名 `xxx_file`/`xxx_url` 与 DashScope 形态 `media` 数组由运行时