# Free Sample Pack Spec - 2026-05-02

## 任务判断

### 任务性质

本文件是免费 Sample Pack 的规格说明。它服务公开发放，不服务内部版本发布，也不替代 `research/source_registry.md`。当前版本已经从文字方案稿修正为包含真实图片证据的样例包。

2026-05-02 追加要求：Sample Pack 不再只满足“1 个真实案例 + before / after”，还必须包含 5-8 组典型游戏案例的对照实验，用 direct baseline 与 Skill-controlled 输出证明流程价值。如果 direct baseline 触发 title-like IP 风险，应登记失败但不公开展示图片。

### 目标用户

- 首次接触本项目的独立游戏开发者。
- 想判断本项目是否不同于普通 prompt pack 的潜在买家。
- 需要给团队解释“AI 游戏 UI 参考图为什么要验收和返修”的制作负责人。

### 成功标准

- 用户不购买也能看懂完整流程价值。
- 用户能看到真实图片、审查分数、返修前后对照，以及从 brief 到 implementation notes 的案例。
- 用户能理解免费包边界：公开方法论和一个案例，不公开全部商业案例库。
- 用户能把本包当作评估入口，而不是误以为它是最终交付包。

### 风险

- 研究样本来自相邻产品，不能机械套用到游戏 UI 生成。
- 免费样例不能使用空泛营销词替代流程证据。
- 默认必须全新生成图片；复用已有图片只允许在用户明确授权、任务本身是审查/打包既有资产，或生图能力阻塞且用户接受降级时使用。
- 任一图像如果一眼像知名商业游戏，应判为 `IP_SIMILARITY_GATE: fail`，不得进入公开 Sample Pack 或商品页。
- 免费包不应承诺生成图商业版权或引擎实现自动化。

## 高价值资料判断方法论

### 采用标准

优先采用满足以下条件的来源：

1. 一手来源：官方文档、官方产品页、官方 repo 或真实工具 marketplace。
2. 可复制结构：能看出文件清单、入口顺序、预览、示例、安装或使用步骤。
3. 降低理解门槛：不是只展示最终结果，而是展示如何开始、如何复制、如何运行或如何改。
4. 面向实际用户：服务开发者、设计工具用户、协作工具用户或 AI 建站用户，而不是泛内容营销。
5. 可转化为本项目规则：能沉淀成 sample pack 文件结构、入口顺序、CTA、边界提示或验收标准。

### 排除标准

排除或降权以下样本：

- 只有截图墙、没有使用路径的素材合集。
- 只写“高级、好看、专业”的营销页。
- 来自聚合站且无法追溯到原作者或官方页面的下载页。
- 没有许可、版本、运行方式或使用边界的 zip。
- 与游戏 UI、开发者 onboarding、设计工具模板或 AI 生成工具理解门槛无关的博客。

## 研究来源

| # | 来源 | URL | 访问日期 | 类型 | 值得学习的点 | 不直接套用的边界 |
|---:|---|---|---|---|---|---|
| 1 | Unreal Engine Lyra Starter Game | https://dev.epicgames.com/documentation/en-us/unreal-engine/lyra-sample-game-in-unreal-engine | 2026-05-02 | 官方游戏 sample | 用完整可运行样例解释框架能力，而不是只列 API。 | Lyra 是完整工程，本 Sample Pack 不能承诺提供可运行游戏项目。 |
| 2 | Unity Dragon Crashers UI Toolkit Sample | https://marketplace.unity.com/packages/essentials/tutorial-projects/dragon-crashers-ui-toolkit-sample-project-231178 | 2026-05-02 | 免费官方 UI sample | 明确标注 FREE、official、sample、game UI、UI Builder，并提供多张截图入口。 | Unity sample 是引擎工程资产，本项目免费包是流程文档和案例雏形。 |
| 3 | Godot Demo Projects repo | https://github.com/godotengine/godot-demo-projects | 2026-05-02 | 官方开源 demo/template repo | README 说明每个 `project.godot` 文件夹都是 demo，可 clone / zip，并说明版本分支和浏览器试玩。 | 本项目不能把每个案例做成引擎项目；但应说明案例用途和版本边界。 |
| 4 | Figma UI Kits onboarding | https://help.figma.com/hc/en-us/articles/24037724065943-Start-designing-with-UI-kits | 2026-05-02 | 官方设计工具 onboarding | 解释 UI kits 是组件、样式、变量和示例屏幕；提供从 Library 或 Community 添加的路径。 | Figma kit 是可插入组件库；本项目 sample 是流程演示，不提供可直接拖拽的 UI 组件。 |
| 5 | Figma Mobile UI Kit template | https://www.figma.com/templates/mobile-ui-kit/ | 2026-05-02 | 官方免费模板页 | 清楚说明 free template、customizable、components、screens、use cases 和相关模板。 | 移动 app UI 模板不等于游戏画面；本项目必须加入玩法状态和反模式约束。 |
| 6 | Google Design: Making Material Design's Figma UI Kit | https://design.google/library/euphrates-dahout-material-design-figma | 2026-05-02 | 官方设计系统经验 | 强调 guideline assets、变量系统、prototype、Dev Mode snippets，说明设计 kit 要能维护和实现。 | Material 是通用设计系统，本项目不能复制其视觉规范，只借鉴“示例必须连接实现”的原则。 |
| 7 | Miro Templates Help Center | https://help.miro.com/hc/en-us/articles/360017572134-Templates | 2026-05-02 | 官方协作工具模板 onboarding | 提供 template picker、分类、预览、educational resources、pre-filled / blank 选择和分享链接。 | Miro 模板是协作板，本项目应借鉴入口顺序和预填内容，不应变成白板模板。 |
| 8 | Vercel Templates | https://vercel.com/templates | 2026-05-02 | 官方开发者模板库 | 按 use case、framework、CSS、database 等过滤，降低开发者找模板成本。 | 本项目不需要大而全模板库，免费包只应展示一个高信号案例。 |
| 9 | Vercel Platforms Starter Kit | https://vercel.com/templates/next.js/platforms-starter-kit | 2026-05-02 | 官方 starter kit | 清楚列 Tech Stack、Prerequisites、Installation、env、dev server、deployment。 | 本项目不是代码 starter；但 spec 应列清文件清单、前置条件和发布边界。 |
| 10 | Lovable Templates | https://lovable.dev/templates | 2026-05-02 | AI 建站相邻产品模板库 | 用 production-ready apps、分类和具体模板卡片降低“AI 工具能做什么”的理解成本。 | AI 建站模板多强调成品应用，本项目必须强调流程和验收，而不是成品图。 |
| 11 | Framer Marketplace Templates | https://www.framer.com/marketplace/templates/ | 2026-05-02 | 设计/建站模板 marketplace | 明确免费和付费模板并列、分类入口、缩略图、作者和价格，帮助用户先试后买。 | 本项目免费包不做市场模板墙，避免用户误解为素材商城。 |

## 研究抽取的可执行模式

### 文件组成

免费 Sample Pack 应包含：

1. `README.md`：评估入口，说明这不是 prompt pack、适合谁、不适合谁、先读什么。
2. `sample_pack_spec_20260502.md`：研究依据、文件清单、发布边界、验收标准。
3. `visual_evidence_manifest_20260502.md`：全新生成图片清单、生成方式、原始生成文件、分数、结论和边界。
4. `comparison_generation_plan_20260502.md`：对照实验生成前的 6 组控制合同和锁定 prompt。
5. `comparison_experiments_20260502.md`：对照实验生成后验收、评分、IP 门禁和结论。
6. `case_02_match3_visual_trial_before_after.md`：一条包含真实图片的 before / after 案例。
7. `case_01_buildable_ai_game_ui_reference.md`：一条布局合同雏形，用于展示另一个品类的设计判断。
8. `assets/`：Sample Pack 使用的真实图片文件。

不应包含：

- release zip。
- 全部付费案例。
- 需要登录平台才能理解的资料。
- 无法验证来源的外部素材。

### 入口顺序

从研究看，高质量样例通常不是把所有内容扔给用户，而是给出明确路径：

1. 先说明这个样例解决什么问题。
2. 再说明用户第一步做什么。
3. 再给一个可检查的完整案例。
4. 最后给下一步行动，而不是强制购买。

对应本项目：

```text
README -> Spec -> Visual Evidence Manifest -> Comparison Plan -> Comparison Experiments -> Visual Case -> 用户用自己的游戏画面写 SCREEN_BRIEF / LAYOUT_CONTRACT
```

### 示例完整度

免费包的示例必须完整到能判断流程价值，但不能完整到替代付费版：

- 必须有具体 gameplay state。
- 必须有 layout proportions。
- 必须有真实图片文件。
- 必须有 review score。
- 必须有 revise prompt。
- 必须有 implementation notes。
- 必须有 5-8 组典型游戏案例的对照实验。
- 必须记录 direct baseline 是否触发 `IP_SIMILARITY_GATE`。
- 可以省略更多变体矩阵，但不能省略全部真实图片。

### CTA

CTA 不能写成“立刻购买”。更合理的 CTA：

1. 先用自己的一个真实画面需求填 `SCREEN_BRIEF`。
2. 再锁 `LAYOUT_CONTRACT`。
3. 如果团队需要更多案例、失败修复证据和商业交付材料，再进入付费包。

### 边界提示

每个公开样例包必须写清：

- 本包不提供版权保证。
- 本包不承诺一次生成合格图片。
- 本包不替代 UI 设计师。
- 本包不输出可直接进引擎的完整 UI 资源。
- 本包的真实图片是参考图和验收证据，不是可直接商用的游戏素材。

## 发布边界

### 可以公开

- 本目录 Markdown 文件。
- `assets/` 下 3 张本次全新生成的真实图片。
- `assets/comparison_20260502/` 下通过公开门禁的对照实验图片。
- `comparison_generation_plan_20260502.md` 和 `comparison_experiments_20260502.md`。
- 一个包含真实图片和 before / after 的可检查案例。
- 外部研究来源 URL 和访问日期。
- 免费包和付费包的边界说明。

### 不应公开

- 未统一审查的内部平台执行记录。
- 未打包验证的 release zip。
- 未授权的外部图片或游戏截图。
- 完整付费案例库。
- 商业化后台、支付、账户或私有发布证据。

## 验收标准

### 内容验收

- README 开头包含任务性质、目标用户、成功标准和风险。
- Spec 至少记录 8 个高价值来源，含 URL 和访问日期 `2026-05-02`。
- Spec 包含高价值资料判断方法论。
- Spec 明确 sample pack 文件清单、入口顺序、CTA 和边界提示。
- Visual evidence manifest 至少登记 1 张 pass 图片和 1 组 before / after 图片。
- Comparison experiments 至少覆盖 5 组不同游戏案例，并至少包含 5 张 Skill-controlled pass 图片。
- 每个 Skill-controlled 对照必须引用生成前控制记录，而不是事后只贴 prompt。
- Case 至少包含 `SCREEN_BRIEF`、`LAYOUT_CONTRACT`、`VISUAL_STYLE_CONTRACT`、`IMAGE_PROMPT_LOCKED`、真实图片、`IMAGE_REVIEW`、`REVISION_PROMPT`、`IMPLEMENTATION_NOTES`。

### 质量验收

- 不使用“高级、精致、沉浸、好看”作为主要约束。
- 任何视觉判断都转化为玩法状态、布局比例、组件数量、评分或禁止项。
- 不出现商店、VIP、抽卡、红点、活动墙等无关重度手游入口。
- 不公开展示触发 title-like IP 风险的图像，即使它能证明 direct baseline 失败。
- `IMAGE_REVIEW` 分数低于 80 时必须给出返修而不是接受。
- `IMPLEMENTATION_NOTES` 必须能拆出组件、状态绑定、切图建议和风险。
- 公开包不能再写“不包含生成图片”。

### 维护验收

- 修改范围限于 `docs/commercialization/sample_pack/`、`AGENTS.md` 和 `docs/CHANGELOG.md`。
- 必须更新 `docs/CHANGELOG.md`。
- 必须包含全新生成的真实图片文件；若无法生成，必须登记阻塞并停止，不得默认复用旧图。
- 不修改 release zip。
- 修改后运行 `python scripts/validate_skill_structure.py`。
