---
name: meow-style-guide
description: 通用视觉参考与风格生成规范。引导任意 AI Agent 通过 meow-styles MCP 服务检索视觉参考、拉取受保护的提示词与原图路径，并严格按真实业务输入与视觉规则完成设计稿或前端页面生成。
---

# 喵一眼（Meow）｜视觉参考与风格生成规范

本 Skill 适用于所有支持 MCP（Model Context Protocol）或自定义指令/Skill 的 AI Agent 工具（如 **Antigravity、Claude Code、Cursor、Windsurf、Codex、Gemini CLI、Cline / Roo Code、Trae** 等）。

---

## 一、如何导入本 Skill（给用户）

### 方式 1：最简单——直接发给你的 Agent
直接把本 `SKILL.md` 文件（或下载的 `meow-style-guide-skill.zip` 压缩包）**拖进或发送给你正在使用的 AI Agent 对话框**，并说：
> 「请学习并安装这个 Skill，后续配合 `meow-styles` MCP 服务帮我做视觉参考与页面生成。」

### 方式 2：按工具放到对应目录
- **Antigravity**：全局 `~/.gemini/antigravity/skills/meow-style-guide/SKILL.md`，或项目内 `.agent/skills/meow-style-guide/SKILL.md`
- **Claude Code**：全局 `~/.claude/skills/meow-style-guide/SKILL.md`，或项目内 `.claude/skills/meow-style-guide/SKILL.md`
- **Cursor**：将本文件内容放入项目 `.cursor/rules/meow-style-guide.mdc`（或在 Cursor Settings → Rules 中粘贴）
- **Windsurf**：放入项目 `.windsurfrules` 或 `.windsurf/rules/meow-style-guide.md`
- **Codex / Gemini CLI**：放入全局 `~/.codex/skills/meow-style-guide/SKILL.md` / `~/.gemini/skills/meow-style-guide/SKILL.md`，或在 `AGENTS.md` / `GEMINI.md` 中引用
- **其他对话式 Agent**：直接作为系统提示词（System Prompt）或附件发送给大模型即可

### 配套 MCP 接入配置（通用 JSON）
在对应工具的 MCP 配置文件（如 `mcp_config.json` / `.mcp.json` / `claude_desktop_config.json`）中添加：
```json
{
  "mcpServers": {
    "meow-styles": {
      "url": "https://meow.gt3rdapps.cn/mcp",
      "headers": {
        "Authorization": "Bearer <登录后自动填入你的_API_KEY>"
      }
    }
  }
}
```

---

## 二、大模型执行规范（给 AI Agent）

当用户需要生成 UI 设计稿、运营活动页、数据大屏、后台管理端、品牌页或响应式前端页面时，必须严格按以下 4 步执行：

### 第 1 步：确定唯一主参考（支持主动指定 & 被动参考匹配，严禁混图）
1. **主动指定模式**：若用户已提供 `ref_code`（例如 `ref-001`）或从网页端复制了「MCP 任务指令」，直接使用该 `ref_code`。
2. **被动参考模式（用户未指定风格/编号时）**：
   - 当用户只描述了业务场景或产品需求（例如「帮我做一个极简浅色的 SaaS 控制台」或「做一个双十一领券弹窗」），而没有指定风格或 `ref_code` 时，**主动调用 `match_style_references(user_input=<用户原始需求>, kind=<解析出的分类>, top_k=3)`** 进行被动参考匹配；
   - 也可配合 `list_libraries` / `search_styles` 进一步检索。
   - 若最高分候选非常明确，向用户说明推荐的 **唯一主参考**（附 `ref_code`、所属库、匹配理由与 `thumb_url`）并确认，或当场景存在歧义时列出 Top 1~3 个候选让用户选定其中 **1 个**。
3. **禁止**把同一风格家族的多张参考图混拼在一起作为多个主参考。

### 第 2 步：收集真实业务变量（严禁编造）
在调用 `get_reference_prompt` 前，向用户确认或从上下文提取以下变量；**用户未提供的项保留为空，绝对不要编造品牌名、金额、指标或业务功能**：
- `project_name`：项目名称
- `page_type`：页面类型
- `dimensions`：终端与画板尺寸（如 `Web 1440px`、`手机端 375px`）
- `user_task`：用户当前核心任务
- `primary_cta`：唯一主行动按钮文案
- `business_input`：真实业务模块、文案、金额、数据与规则
- `output_type`：交付类型（`成品设计稿 PNG` / `可编辑 Figma 设计稿` / `响应式前端页面`）

### 第 3 步：通过 MCP 拉取受保护的提示词与原图路径
1. 调用 `get_reference_prompt(ref_code=..., variables={...})`。
2. 从返回 JSON 中读取：
   - `prompt`：已自动套入业务变量的完整视觉提示词
   - `asset_url` / `asset_path`：原图路径（如环境支持看图、下载或浏览器打开，务必结合原图对照排版、色彩占比、容器语言与留白节奏）
   - `family.rule`、`family.avoid`、`visual_dna`：风格约束与避坑要求

### 第 4 步：生成与一致性自检
- 严格遵守 `prompt` 中的「替换与禁止」以及 `family.avoid` 条目，不额外堆砌无语义发光、渐变、装饰网格或多余卡片。
- 完稿后对照 `visual_dna` 与原图逐项自检：
  1. 唯一主行动（CTA）是否突出且不冲突；
  2. 色彩占比、留白节奏、字体层级是否与主参考一致；
  3. 所有业务文案与数据是否 100% 来自用户输入，未出现虚构内容。


---

## 三、当前账号专属接入凭证（已自动集成）

- **所属账号**：`未登录访客`
- **MCP 服务地址**：`https://meow.gt3rdapps.cn/mcp`
- **专属 API Key**：`<登录后自动填入你的_API_KEY>`

### 免配置直连调用示例（如当前 Agent 尚未启用 MCP 客户端，可直接用 HTTP 调用）
```bash
# 1. 被动参考匹配（用户未指定风格时，直接传自然语言需求）
curl -sS -X POST "https://meow.gt3rdapps.cn/mcp" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer <登录后自动填入你的_API_KEY>" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"match_style_references","arguments":{"user_input":"帮我做一个极简浅色 SaaS 后台控制台","top_k":3}}}'

# 2. 获取指定 ref_code 的完整提示词与原图路径
curl -sS -X POST "https://meow.gt3rdapps.cn/mcp" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer <登录后自动填入你的_API_KEY>" \
  -d '{"jsonrpc":"2.0","id":2,"method":"tools/call","params":{"name":"get_reference_prompt","arguments":{"ref_code":"ref-001"}}}'
```
