BrandCraft Squad

AIOS Squad，用于提取设计系统、创建品牌一致的文档以及改进现有PDF。

版本: 1.0.0 | 前缀: brandcraft | 代理: 8 | 任务: 31 | 工作流: 4

概述

BrandCraft 是一个由8个专业代理组成的Squad，编排完整的流水线来：

1. 从任何URL提取设计系统（颜色、排版、间距、Logo）
2. 保存为可重用模板（带YAML frontmatter的.md文件）
3. 创建品牌一致的文档：PDF、PNG、Instagram轮播图、社交卡片
4. 生成PPTX演示文稿，应用设计令牌
5. 通过AI MCP生成品牌一致的图像（nano-banana-pro、dalle3等）
6. 改进现有PDF，使用选定的设计系统重新渲染

代理

流水线

1. 提取并保存设计系统

URL → Prober（分析 + 令牌 + Logo）→ Vault（保存模板）

命令: *extract-design-system 时长: 15-25分钟

2. 创建文档

Maestro（选择）→ Vault（模板 + CSS）→ Brush（图像）→ Forge（HTML→PDF/PNG）→ Gauge（质检）

命令: *create-document、*create-pdf、*create-carousel、*create-social-card 时长: 30-60分钟

3. 创建演示文稿

Maestro（选择）→ Vault（令牌）→ Canvas（布局 + PPTX）→ Brush（图像）→ Gauge（质检）

命令: *create-pptx、*create-presentation 时长: 30-45分钟

4. 改进现有PDF

Scribe（读取PDF → markdown）→ Maestro（选择）→ Vault（模板）→ Forge（重新渲染）→ Gauge（质检）

命令: *improve-pdf、*redesign-document 时长: 30-45分钟

支持的格式

模板格式

模板是包含设计令牌YAML frontmatter的.md文件：

---
name: "acme-corp"
description: "从acme.com提取的设计系统"
source_url: "https://www.acme.com"
extracted_at: "2026-02-24T14:30:00Z"
version: "1.0.0"
tokens:
  colors:
    primary: "#1a73e8"
    secondary: "#34a853"
    background: "#ffffff"
    text_primary: "#202124"
  typography:
    font_heading: "'Inter', sans-serif"
    font_body: "'Source Sans Pro', sans-serif"
    size_h1: "2.5rem"
    size_body: "1rem"
  spacing:
    sm: "8px"
    md: "16px"
    lg: "24px"
logos:
  primary: "assets/acme-corp/logo.svg"
---
# Acme Corp — 设计系统
...详细文档...

依赖

Node.js

MCP工具

结构

squads/brandcraft/
├── squad.yaml                    # 清单
├── README.md                     # 文档（PT-BR）
├── agents/                       # 8个代理
├── tasks/                        # 31个任务
├── workflows/                    # 4个工作流
├── config/                       # 3个配置
├── checklists/                   # 3个检查清单
├── templates/                    # 2个模板 + assets/
└── scripts/                      # 2个脚本（render.js、create-pptx.js）

前置条件

• Node.js 18+ 已安装
• Claude Code 具有MCP服务器访问权限

安装 Node.js 依赖

Node.js 依赖安装在Squad目录内部：

cd squads/brandcraft
npm install

这将自动安装Squad的 package.json 中列出的所有包：

MCP服务器配置

BrandCraft 需要 nano-banana-pro MCP（Google Gemini）来生成图像。配置因IDE而异。

步骤1：获取GEMINI_API_KEY

1. 访问 Google AI Studio
2. 创建或选择一个Google Cloud项目
3. 生成API密钥
4. 复制密钥（格式：AIzaSy...）
5. 在shell中导出：

export GEMINI_API_KEY="您的密钥"

要使其永久生效，请添加到

~/.zshrc

~/.bashrc

步骤2：配置MCP服务器

Claude Code（推荐）

选项A — 通过CLI（推荐）：

claude mcp add --transport stdio --scope project \
  --env GEMINI_API_KEY=${GEMINI_API_KEY} \
  nano-banana-pro -- npx -y @rafarafarafa/nano-banana-pro-mcp

这会自动在项目根目录创建 .mcp.json 文件，使用 project 范围（通过git与团队共享）。

选项B — 手动编辑 .mcp.json：

在项目根目录创建或编辑 .mcp.json 文件：

{
  "mcpServers": {
    "nano-banana-pro": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "@rafarafarafa/nano-banana-pro-mcp"],
      "env": {
        "GEMINI_API_KEY": "${GEMINI_API_KEY}"
      }
    }
  }
}

${GEMINI_API_KEY} 语法会自动展开环境变量——不要将密钥直接放在文件中，以避免提交secrets。

Antigravity（Google）

Antigravity 内置 MCP Store：

1. 在Antigravity中打开MCP Store面板
2. 搜索 "nano-banana-pro"
3. 点击 Install
4. 在提示时配置 GEMINI_API_KEY 变量

Cursor

在项目中创建或编辑

.cursor/mcp.json

{
  "mcpServers": {
    "nano-banana-pro": {
      "command": "npx",
      "args": ["-y", "@rafarafarafa/nano-banana-pro-mcp"],
      "env": {
        "GEMINI_API_KEY": "${GEMINI_API_KEY}"
      }
    }
  }
}

Windsurf / Codex / 其他IDE

大多数支持MCP的IDE使用项目根目录中的标准 .mcp.json 格式。请查阅您IDE的文档以获取配置文件的确切位置。

可选MCP

配置遵循相同模式——添加到项目的 .mcp.json 或使用 claude mcp add --scope project。

验证

配置后，重启IDE并验证：

# 在Claude Code中——列出已配置的MCP
claude mcp list

# 在Claude Code内部——检查状态
/mcp

mcp__nano-banana-pro__* 工具应该可用。测试方法："使用nano-banana-pro生成一张测试图片"。

质量

bc-inspector（Gauge）使用加权评分验证每个生成的文档：

判定: PASS (>=80) | CONCERNS (60-79) | FAIL (<60)

Synkra AIOS — BrandCraft Squad v1.0.0