---
name: nextclaw-product-visual-assets
description: 当 NextClaw 产品更新后需要生成、替换、挑毛病或检查官网、GitHub README、用户文档或社交传播中的真实截图、AI 宣传视觉、整页 HTML 宣传预览、社区二维码等对外视觉资产时使用；也用于“更新截图”“重新截一批图”“做宣传页”“生成 campaign 页面”“视觉审稿”“五星挑刺法”或发布前检查视觉资产。普通站点布局开发或只写文章不触发。
---

# NextClaw 产品视觉资产

## 目标

让对外视觉既能准确证明真实产品价值，又形成值得传播的完成品。skill 负责选择证据、艺术方向、生成编排和验收；确定性脚本负责截图、同步或渲染。开始前先读取 Wiki 中的[用户内容边界](../../wiki/skills/content/user-facing-content-boundary/SKILL.md)，隔离内部过程、隐私、调试状态和不成熟结论。

## 选择一个模式

- **产品截图与外部资产**：更新稳定界面、精选真实任务、README/landing 镜像、二维码或指标图时，读取 [产品截图与外部资产](references/product-screenshot-and-external-assets.md)。
- **整页宣传工作室**：把新功能、主题、版本或真实场景做成精美的单文件 HTML showcase/campaign 页面时，执行下方流程。
- **AI 辅助单张视觉**：只需一张概念主图或截图包装时，使用 `imagegen`；真实 UI 仍由原始截图承担证据，概念图不得冒充产品界面。

Stable/major 版本传播图在选图或生成后、绑定 release review 前，读取 [版本传播图质量门](references/release-visual-quality.md)。

只选择当前任务需要的模式，不批量读取其它参考。

## 整页宣传工作室

主产物是一件完整 HTML 宣传作品：开场判断、渠道文案预览、传播卡片、真实证据和设计说明共同组成同一套叙事。X、官网、README 或社区帖只是可选渠道模块，不是页面本身的全部目的。

1. **冻结命题与内容骨架**：用一句话写清用户应记住什么，再列 1–3 个可核查 claim。为每个模块声明它在故事中的任务、提供的信息增量、用户看完应带走的结论，以及承载结论的证据或解释；回答不了这四项的模块直接删除或重写，禁止用漂亮背景包装空内容。命题应服务 NextClaw 作为长期个人智能搭档或个人操作层的真实价值，不能只写“更高级、更震撼”。
2. **截图计划**：先决定 claim 需要“完整窗口”“完整功能面板”还是“完整图 + 有来源的细节图”，再选择或重新采集素材。每张事实素材都要在 `capture` 中声明主体、完整性、裁切来源和隐私检查；不能先拿现成图再随意找一个位置塞进去。读取 [宣传页内容与证据合同](references/promo-page-content-evidence.md)。
3. **裁切决策**：完整证据保持原始画面；局部图必须声明来源完整图和归一化 `cropRegion`，只能用于解释细节。没有完整图时不得生成事实卡片。
4. **选择区块原型**：先读取 [宣传页区块布局原型目录](references/promo-page-layout-archetypes.md)，根据内容角色、信息数量、顺序关系和媒体形状筛选最多三个候选，并在 `layoutDecision` 中记录最终选择与理由。再在 card 的 `evidence` 中明确单图、连续多图或“完整图 + 细节图”，固定使用 `contain` 并继承源图比例。读取 [宣传页构图与留白合同](references/promo-page-composition-and-spacing.md)，约束文字、截图、主动留白、安全区和多图关系；截图自身成为圆角卡片，不默认再套窗口壳。
5. **确定艺术方向**：从产品本身提取颜色、材质、留白和字体气质。需要生成/编辑背景、使用参考图或准备提示词时，读取 [宣传页艺术方向与生图提示词](references/promo-page-art-direction-and-image-prompts.md)，并使用 `imagegen`。AI 只生成背景、纹理、装饰或明确标注的概念视觉，不伪造产品 UI。
6. **编排整页**：先按内容推进确定模块数量，再决定构图。默认包含开场判断、可选渠道预览、2–4 张传播卡片、证据映射和简短设计说明；按传播目标增删，不强行保留 X 帖子，也不为凑满卡片保留只有一句泛化口号的模块。背景只提供氛围、分区和视线引导，不算内容。
7. **生成**：复制并修改样例 brief，然后运行：

   ```bash
   node scripts/render-promo-page.mjs --brief <brief.json> --out <preview.html>
   ```

   模板位于 `assets/promo-page-template.html`。渲染器会把本地图片嵌入 HTML，并阻断缺少布局决策、原型与实现不相容、claim 与截图不匹配、事实卡片缺少完整截图或试图用全幅裁切冒充产品证据的页面。
8. **验收**：打开页面检查桌面和窄屏；逐条核对“选图—裁切—比例—拼接—可读性”，确认每个事实 claim 都能在完整截图中找到、截图关键对象足够大、多图顺序有意义，并排除私人信息、失败态、加载态、旧版本误导或 AI 伪造 UI。交付前必须执行构图参考中的“五星挑刺法”，并在最终回复中公开每个模块的五个问题、分数、模块指数、全局排序和未解决项；不能因为结果达到交付线就省略问题。用户说“挑毛病”“按之前的方法审”或“五星挑刺”时，直接召回同一方法。纯审美由用户确认，内容代表性由执行者先证明。

### 自带起点

- `assets/promo-page-island-theme-brief.example.json`：可运行的 Island 样例。
- `assets/promo-page-island-atmosphere-reference.webp`：艺术背景参考，不承担功能证据。
- `assets/promo-page-island-workspace-reference.png`：真实界面参考；复用前仍须检查版本、隐私和内容代表性。

## 共同结果标准

- 真实截图证明事实，AI 视觉提供氛围，两者角色清楚。
- 每张事实型卡片至少完整展示一次证据截图；局部细节只能辅助，必须可追溯到同卡完整图，不能取代完整画面。
- 截图不是填充纹理：先确认主体和边界，再按源图比例决定卡片尺寸，最后才做拼接。
- 图片完整显示文案声称的对象和结果；不出现密钥、私人标识、失败提示、加载态或被裁断的关键内容。
- 概念图、重排卡片和拼接图不能冒充真实产品截图。
- 页面或图片自身像完成品：有节奏、留白、统一材质和明确焦点，不是内部提案套背景。
- 交付时列出产物路径、证据来源、未采用素材及原因；未经用户要求不提交、不发布、不替换线上资产。

正式截图若适合未来版本说明，使用 `release-note-image` 绑定到同一需求 changeset；完整规则见 [产品截图与外部资产](references/product-screenshot-and-external-assets.md)。