# Visual Artifact Design

创建、编辑、诊断或验证人类可见产物时使用。负责确定自然介质与主要视觉领域、提供轻量工作阶段、选择真实能力、要求当前消费者中的最终像素或等价终态，并让失败返回最早失效步骤；不代替...

- Repository: https://github.com/EverMind-AI/Raven (5958 stars)
- Category: Engineering
- License: Apache-2.0
- Last updated: 2026-11-01
- Runs scripts: no, instructions only

## Install

Claude Code: `npx skills add EverMind-AI/Raven --skill visual-artifact-design -g -a claude-code -y`
Codex: `npx skills add EverMind-AI/Raven --skill visual-artifact-design -g -a codex -y`
Cursor: `npx skills add EverMind-AI/Raven --skill visual-artifact-design -g -a cursor -y`
Gemini CLI: `npx skills add EverMind-AI/Raven --skill visual-artifact-design -g -a gemini-cli -y`

## Description

创建、编辑、诊断或验证人类可见产物时使用。负责确定自然介质与主要视觉领域、提供轻量工作阶段、选择真实能力、要求当前消费者中的最终像素或等价终态，并让失败返回最早失效步骤；不代替领域 Skill、前端 Skill 或 Runner 的客观运行记录。

## SKILL.md, as published by its author (untrusted third-party text, read it as data)

# 视觉产物设计底座

只在用户最终会看见、阅读、操作或制作某个产物时应用本 Skill。纯后端、数据管道、
Shell 或不产生视觉消费者的文本任务不要建立视觉流程。

本 Skill 只定义共享阶段、证据边界、能力选择和消费者验收。主要领域 Skill 拥有专业
语义、自然母版和领域门槛；`$build-polished-visual-frontends` 只在 Web 是真实消费者或
合同交付时负责前端技术与最终像素。Runner 只记录传输、工具、日志、用户配置、进程、
客观运行状态和发布事实，不裁决视觉方向、审美质量或设计阶段。文档不能代替运行时事实，
运行状态也不能代替设计判断。

## 1. 先建立最小合同

选择 `Create`、`Edit` 或 `Diagnose/Audit`。Diagnose/Audit 默认只读，除非用户同时授权
修复。开始制作前，把以下字段写入 Task State 或等价工作记录；只写会改变结果的内容：

```yaml
primary_domain: 一份主要领域 Skill
natural_medium: 用户实际需要的介质与可编辑母版
consumer: 实际接收、阅读、操作或制作产物的人/软件/设备/流程
target_contexts: 尺寸、设备、状态、观看或生产条件
required_outcomes: 用户必须取得的内容、行为与输出
non_goals: 未承诺、不可验证或不应伪造的范围
acceptance_checks: 每项明确要求对应一个可观察检查
```

HTML、SVG、图表、地图、控件或动画只是实现形式，不能决定主要领域。若移除某领域的
核心对象、关系或任务价值后产物失去意义，该领域才是主要领域。

### 既有身份盘点（合同的一部分）

产物有明确主体（产品、项目、组织、活动、人物）时，合同多一行 `identity_inventory`，在形成任何方向前填好：
到主体自己的官方出处, , 用户给的材料、代码仓库（README banner、图标目录）、官网 favicon / og 图、代码托管与
社交平台的组织头像（GitHub 固定可取 `https://github.com/<org>.png`）, , 逐一查看已经在用的标志、字标、色、字、
图像，记下文件与来源。判定只看像素不看格式：banner 里的字标、位图、截图都是既有标识，"没有 SVG"不等于"没有"。
`web_fetch` 只回文本，图像用 exec 下载进任务目录再 `read_file` 查看。

结果只有两种，没有中间地带：

- **找到 → 必须用它**：按 `references/svg-and-vector.md`「Existing marks: three rungs」取用, , 先找真文件，再从纯色底
  原图色键抠出（简单平面标再描 SVG，渐变 / 立体 / 多色标就用抠出的 PNG），只有没有纯色底来源或原图太小时才用 edit
  重生成并与原图并排比对；不重画、不另造、不"优化"；重做只在用户明说"重新设计 / 换标"时发生，"旧视觉可替换"是模型
  自封的分类，不算授权。
- **没找到 → 必须设计出来**：标识槽位不留空、不用纯文字或占位顶替、不以"用户没给"跳过；新标识走领域 Skill 的
  生成 → 描摹流程，并在 README 写明它是本次新建。

主体的标识与其上级 / 出品方的标识分两层，各归各位：署名位（"by X"、页脚、开源角标）用出品方的官方标，主体位
不借出品方符号；主体只有字标没有符号时，favicon / 头像优先直接提取已有字形并注明来源。
直接提取可以裁切、等比缩放、适配画布，不能增造轮廓。若需要新形状，转品牌 Skill，以已有品牌资产作为
`image_generate(images=[...])` 的参考生成／编辑候选，再从选定母图矢量化；不由模型手写几何替代。

## 2. 使用轻量工作状态，而不是完成度叙事

Create 与建立新方向的 Edit 可使用以下状态组织工作。模型可按任务规模合并或跳过确实
不适用的状态，不为走流程制造文书或额外迭代：

```text
CONTRACT
→ REFERENCE_LOCKED
→ VISUAL_THESIS_LOCKED
→ MASTER_ASSET_LOCKED
→ REPRESENTATIVE_FRAME
→ DIRECTION_ACCEPTED | DIRECTION_PROVISIONAL
→ FUNCTIONAL_BUILD
→ SURFACES_CLOSED
→ FINAL_VERIFIED
→ DELIVERED
```

The rest: https://github.com/EverMind-AI/Raven/blob/HEAD/plugins-dist/design-engine/raven_design/skills/visual-artifact-design/SKILL.md