diff --git a/apps/ai-game-creator-shell/src-tauri/resources/agc-skills/manifest.json b/apps/ai-game-creator-shell/src-tauri/resources/agc-skills/manifest.json
index 057c29d50..3bb654b3f 100644
--- a/apps/ai-game-creator-shell/src-tauri/resources/agc-skills/manifest.json
+++ b/apps/ai-game-creator-shell/src-tauri/resources/agc-skills/manifest.json
@@ -1,6 +1,6 @@
 {
   "schemaVersion": "agc-skill-pack.v1",
-  "version": "2026-08-26.44",
+  "version": "2026-08-26.46",
   "skills": [
     {
       "name": "agc-unity-editor",
@@ -204,7 +204,7 @@
         "scripts/validate.mjs",
         "scripts/vite.config.xhs-minitool.mjs"
       ],
-      "sha256": "f7d1f7e05863b45e307fe9ef6b281513774b130af2631cc2001b55f40b752fc9"
+      "sha256": "e80b5c6a3f9a1619af1f789a74ea6e7577e58a4efa208d1d7b29e869f40b3725"
     }
   ]
 }
diff --git a/apps/ai-game-creator-shell/src-tauri/resources/agc-skills/vite-export-xhs-minitool/SKILL.md b/apps/ai-game-creator-shell/src-tauri/resources/agc-skills/vite-export-xhs-minitool/SKILL.md
index 18bc23a25..5382393c3 100644
--- a/apps/ai-game-creator-shell/src-tauri/resources/agc-skills/vite-export-xhs-minitool/SKILL.md
+++ b/apps/ai-game-creator-shell/src-tauri/resources/agc-skills/vite-export-xhs-minitool/SKILL.md
@@ -17,7 +17,18 @@ metadata:
 * 不干扰正常的web构建
 
 # 假设和默认项:
-* vite项目目录: games/ ,各个工具(包括示例vite配置)的默认参数参照这个条件给出, 对于非标准的目录结构需要给出显式的参数来适应
+* vite项目目录: game/ ,各个工具(包括示例vite配置)的默认参数参照这个条件给出, 对于非标准的目录结构需要给出显式的参数来适应
+  - 默认参数都按"cwd 就是 vite 项目根"给的: 示例配置的 `build.outDir` 是 `dist-xhs-minitool`, `pack.mjs --vite-built-dir` 的默认值也是 `dist-xhs-minitool`.
+  - 所以先 `cd` 到 vite 项目根再跑; 或者把路径写全 (`--vite-built-dir <项目根>/dist-xhs-minitool`).
+
+# 脚本参数:
+每个脚本 `--help` 都能看参数, 这里只把三份摆在一起:
+
+| 脚本 | 参数 |
+|---|---|
+| `scripts/vite.config.xhs-minitool.mjs` | `build.outDir`（与打包时的 `--vite-built-dir` 必须是同一个目录）; `defineMinitoolConfig(overrides)`（项目已有 vite.config 时用它合并） |
+| `scripts/validate.mjs` | `[project]`、`--json`、`--strict` |
+| `scripts/pack.mjs` | `--vite-built-dir <dir>`、`--zip-out <path>`、`--zip <name>`、`--skip-validate`、`--no-strict` |
 
 # 一些情况:
 * 打包大小限制, 需要精简游戏内容/删减资源/压缩素材 请和用户讨论
diff --git a/apps/ai-game-creator-shell/src-tauri/resources/agc-skills/vite-export-xhs-minitool/scripts/pack.mjs b/apps/ai-game-creator-shell/src-tauri/resources/agc-skills/vite-export-xhs-minitool/scripts/pack.mjs
index 80d3f0e51..42c566927 100644
--- a/apps/ai-game-creator-shell/src-tauri/resources/agc-skills/vite-export-xhs-minitool/scripts/pack.mjs
+++ b/apps/ai-game-creator-shell/src-tauri/resources/agc-skills/vite-export-xhs-minitool/scripts/pack.mjs
@@ -39,7 +39,9 @@ const USAGE = `用法：node pack.mjs [--vite-built-dir <dir>] [--zip <name>] [-
                        该目录出现白名单之外的文件类型时直接报错退出并列出文件，不会删除任何文件。
 --zip <name>     只给文件名时用：写到当前工作目录下。
 --zip-out <path> 需要指定落点（例如 AGC 导出面板要求的 .export/xhs-minitool.zip）时用：
-                 相对路径按当前工作目录解析，父目录不存在会自动建。`;
+                 相对路径按当前工作目录解析，父目录不存在会自动建。
+--skip-validate  写完 zip 后不再跑一遍静态校验。
+--no-strict      校验时不把 WARNING 当失败。`;
 
 /**
  * 打包前预检：产物目录里出现小红书白名单之外的文件类型时整体失败，列出路径但**不改磁盘**。