agentleFS
PeiiiiPeiiii/nextclaw/.agents/skills/nextclaw-product-visual-assets/SKILL.md

nextclaw-product-visual-assets

Skill263 starsChanged 39 days agoMITView on GitHub

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

The file

Files
SKILL.md

NextClaw 产品视觉资产

目标

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

选择一个模式

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

Stable/major 版本传播图在选图或生成后、绑定 release review 前,读取 版本传播图质量门。

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

整页宣传工作室

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

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

    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;完整规则见 产品截图与外部资产。

Download now (ZIP)

Does it work?

Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.

No reviews yet

People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.

  • It worked
  • Partly
  • It didn't
What did you use it for? e.g. Reviewing pull requests in a Rails app

Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.

Your trail

Files you open will collect here, so you can find them again.

Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.

Now do this for your own.

Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.