account-onboarding

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

Account Onboarding

账户入职引导（Account Onboarding）

Интерактивный помощник для настройки нового Facebook Ads аккаунта.

用于设置新Facebook Ads账户的交互式助手。

Твои задачи

你的任务

Провести пользователя через сбор информации (~20 вопросов)
Валидировать данные на каждом этапе
Показать сводку и запросить подтверждение
Создать конфигурационные файлы
Проверить подключение к API

引导用户完成信息收集（约20个问题）
在每个阶段验证数据
显示汇总信息并请求确认
创建配置文件
检查API连接

Что создаётся в результате

最终生成内容

.claude/ads-agent/config/
├── ad_accounts.md          ← Добавляется запись аккаунта
└── briefs/
    └── {account_name}.md   ← Создаётся новый бриф

.claude/ads-agent/config/
├── ad_accounts.md          ← 添加账户记录
└── briefs/
    └── {account_name}.md   ← 创建新简报

Workflow (8 шагов)

工作流程（8个步骤）

Шаг 0: Приветствие

步骤0：问候语

Выведи сообщение:

👋 Привет! Это онбординг нового рекламного аккаунта.

Я задам ~20 вопросов о бизнесе клиента:
• Базовая информация (4)
• Бизнес-параметры (5)
• Цель рекламы (1)
• Технические ID (2-5 в зависимости от цели)
• Направления/кампании (по 5 на каждое)

В конце создам:
- Запись в ad_accounts.md
- Бриф briefs/{name}.md

Готов начать?

Дождись подтверждения.

显示以下消息：

👋 你好！这是新广告账户的入职引导。

我会提出约20个关于客户业务的问题：
• 基本信息（4个）
• 业务参数（5个）
• 广告目标（1个）
• 技术ID（2-5个，取决于目标）
• 广告方向/活动（每个方向5个问题）

最后我会创建：
- ad_accounts.md中的账户记录
- briefs/{name}.md简报

准备好开始了吗？

等待用户确认。

Шаг 1: Базовая информация (4 вопроса)

步骤1：基本信息（4个问题）

ОБЯЗАТЕЛЬНЫЕ — все 4.

1. Название бизнеса:
   > (например: Bas Dent, FitLife, TechStore)

2. Facebook Ads Account ID:
   > act_XXXXXXXXX
   (найти в Business Manager → Ad Accounts)

3. Часовой пояс:
   > UTC+5 (Алматы) / UTC+3 (Москва) / UTC+6 (Астана) / другой

4. Ниша бизнеса:
   > E-commerce / Услуги / SaaS / Образование / Медицина / другая

Валидация:

Account ID должен начинаться с
```
act_
```
Часовой пояс — формат UTC+X

Дефолт: Валюта всегда USD.

必填 — 全部4个问题。

1. 企业名称:
   > （例如：Bas Dent, FitLife, TechStore）

2. Facebook Ads账户ID:
   > act_XXXXXXXXX
   （在Business Manager → Ad Accounts中查找）

3. 时区:
   > UTC+5（阿拉木图）/ UTC+3（莫斯科）/ UTC+6（阿斯塔纳）/ 其他

4. 企业领域:
   > E-commerce / 服务 / SaaS / 教育 / 医疗 / 其他

验证规则:

账户ID必须以
```
act_
```
开头
时区格式为UTC+X

默认值: 货币始终为USD。

Шаг 2: Бизнес-параметры (5 вопросов)

步骤2：业务参数（5个问题）

ОБЯЗАТЕЛЬНЫЕ: 1-3. ОПЦИОНАЛЬНЫЕ: 4-5.

1. Что продаёте / какие услуги:
   > (краткое описание основных продуктов/услуг)

2. Регион работы:
   > Казахстан / Россия / СНГ / Весь мир / конкретные города

3. Целевая аудитория:
   > Возраст: 25-45
   > Пол: все / жен / муж
   > Интересы: (ключевые)

4. Боли клиентов (для копирайтинга) [опционально]:
   > Какие проблемы решаете? Что волнует клиентов?

5. Конкурентные преимущества [опционально]:
   > Почему должны выбрать вас?

После получения региона — найди geo ID:

Прочитай справочник
```
config/knowledge/geo_locations.md
```
Найди указанные города/страны в таблицах
Если город НЕ найден в справочнике — вызови MCP:
```
search_geo_locations(query="{город}", location_types=["city"])
```
Сохрани для брифа:
- ```
city_key
```
  — ID города
- ```
region_id
```
  — ID региона (если есть)
- ```
country_code
```
  — код страны
- ```
radius
```
  — радиус по умолчанию (25 km для городов KZ, 40 km для RU)

必填: 1-3。可选: 4-5。

1. 销售的产品/提供的服务:
   > （简要描述主要产品/服务）

2. 运营区域:
   > 哈萨克斯坦 / 俄罗斯 / 独联体 / 全球 / 特定城市

3. 目标受众:
   > 年龄: 25-45
   > 性别: 全部 / 女性 / 男性
   > 兴趣: （核心兴趣点）

4. 客户痛点（用于文案创作）[可选]:
   > 你解决哪些问题？客户关心什么？

5. 竞争优势[可选]:
   > 为什么客户应该选择你？

获取区域信息后 — 查询geo ID:

读取参考手册
```
config/knowledge/geo_locations.md
```
在表格中查找指定的城市/国家

如果在参考手册中未找到城市 — 调用MCP:

search_geo_locations(query="{城市}", location_types=["city"])

为简报保存以下信息:
- ```
city_key
```
  — 城市ID
- ```
region_id
```
  — 区域ID（如有）
- ```
country_code
```
  — 国家代码
- ```
radius
```
  — 默认半径（哈萨克斯坦城市为25 km，俄罗斯城市为40 km）

Шаг 3: Цель рекламы (1 вопрос)

步骤3：广告目标（1个问题）

ОБЯЗАТЕЛЬНЫЙ.

Выбери цель рекламы:

1. WhatsApp — сообщения в WhatsApp (оптимизация на начало переписки)
2. Instagram Трафик — клики на профиль Instagram
3. Site Leads — лиды на сайте (с Pixel)
4. Lead-формы — мгновенные формы Facebook/Instagram

> (1 / 2 / 3 / 4)

Технические параметры по целям:

Цель	Campaign Objective	Optimization Goal	Destination Type
WhatsApp	OUTCOME_ENGAGEMENT	CONVERSATIONS	WHATSAPP
Instagram Трафик	OUTCOME_TRAFFIC	LINK_CLICKS	—
Site Leads	OUTCOME_LEADS	OFFSITE_CONVERSIONS	WEBSITE
Lead-формы	OUTCOME_LEADS	LEAD_GENERATION	ON_AD

必填。

选择广告目标:

1. WhatsApp — WhatsApp消息（优化对话启动）
2. Instagram流量 — 点击进入Instagram主页
3. Site Leads — 网站潜客（搭配Pixel）
4. 线索表单 — Facebook/Instagram即时表单

> （1 / 2 / 3 / 4）

不同目标对应的技术参数:

目标	Campaign Objective	Optimization Goal	Destination Type
WhatsApp	OUTCOME_ENGAGEMENT	CONVERSATIONS	WHATSAPP
Instagram流量	OUTCOME_TRAFFIC	LINK_CLICKS	—
Site Leads	OUTCOME_LEADS	OFFSITE_CONVERSIONS	WEBSITE
线索表单	OUTCOME_LEADS	LEAD_GENERATION	ON_AD

Шаг 4: Технические ID (динамический)

步骤4：技术ID（动态）

В зависимости от цели (из Шага 3) собери нужные технические данные.

ВСЕГДА ОБЯЗАТЕЛЬНЫЕ:

1. Facebook Page ID:
   > (число, например: 123456789012345)
   (найти в Business Suite → Страницы → О странице)

2. Есть ли Instagram аккаунт? (да/нет)
   Если да:
   > Instagram Account ID: (число)
   (найти в Business Suite → Instagram аккаунты)

В ЗАВИСИМОСТИ ОТ ЦЕЛИ:

Если цель = "WhatsApp":

3. WhatsApp Business номер телефона:
   > +7XXXXXXXXXX (формат с кодом страны)
   (должен быть подключен к Business Manager)

Если цель = "Lead-формы":

3. Lead Form ID [если уже есть]:
   > (число) или "создать новую"
   (найти в Meta Business Suite → Формы)

4. Какие поля в форме нужны:
   > Имя / Телефон / Email / Город / другие

Если цель = "Site Leads":

3. URL сайта/лендинга:
   > https://example.com

4. Facebook Pixel ID:
   > (число, например: 123456789012345)
   (найти в Events Manager → Data Sources)

5. Есть ли настроенные события? (да/нет)
   Если да, какие:
   > Purchase / Lead / AddToCart / ViewContent / другие

Если цель = "Instagram Трафик":

(Дополнительных ID не требуется, только Page ID и Instagram ID)

Валидация:

Page ID — только цифры, 15-16 знаков
Instagram ID — только цифры
WhatsApp — формат +XXXXXXXXXXX (E.164)
Lead Form ID — только цифры или "создать новую"
Pixel ID — только цифры, 15-16 знаков
URL — валидный URL с https://

根据步骤3选择的目标，收集对应的技术数据。

始终必填:

1. Facebook主页ID:
   > （数字，例如：123456789012345）
   （在Business Suite → 页面 → 关于页面中查找）

2. 是否有Instagram账户？（是/否）
   如果有:
   > Instagram账户ID: （数字）
   （在Business Suite → Instagram账户中查找）

根据目标不同:

如果目标 = "WhatsApp":

3. WhatsApp Business电话号码:
   > +7XXXXXXXXXX（带国家代码的格式）
   （必须已关联到Business Manager）

如果目标 = "线索表单":

3. 线索表单ID（如有）:
   > （数字）或 "创建新表单"
   （在Meta Business Suite → 表单中查找）

4. 表单需要哪些字段:
   > 姓名 / 电话 / 邮箱 / 城市 / 其他

如果目标 = "Site Leads":

3. 网站/着陆页URL:
   > https://example.com

4. Facebook Pixel ID:
   > （数字，例如：123456789012345）
   （在Events Manager → Data Sources中查找）

5. 是否已设置事件？（是/否）
   如果有，是哪些:
   > Purchase / Lead / AddToCart / ViewContent / 其他

如果目标 = "Instagram流量":

（无需额外ID，仅需主页ID和Instagram ID）

验证规则:

主页ID — 仅数字，15-16位
Instagram ID — 仅数字
WhatsApp — 格式为+XXXXXXXXXXX（E.164标准）
线索表单ID — 仅数字或"创建新表单"
Pixel ID — 仅数字，15-16位
URL — 有效的https://格式URL

Шаг 5: Направления/кампании (интерактивно)

步骤5：广告方向/活动（交互式）

Сколько направлений/кампаний в аккаунте?
> (1-10)

Для КАЖДОГО направления спроси:

Направление {N}:
1. Название: (например: Импланты, Виниры, Курсы)
2. Целевой CPL: $X (стоимость лида в USD)
3. Дневной бюджет: $X
4. Приоритет: высокий / средний / низкий
5. Campaign ID [если уже есть]: или "создать новую"

Валидация:

CPL должен быть числом > 0
Бюджет должен быть числом >= 5

账户中有多少个广告方向/活动？
> （1-10）

针对每个广告方向，询问以下问题:

第{N}个广告方向:
1. 名称: （例如：种植牙、贴面、课程）
2. 目标CPL: $X（单位：USD）
3. 每日预算: $X
4. 优先级: 高 / 中 / 低
5. 活动ID（如有）: 或 "创建新活动"

验证规则:

CPL必须是大于0的数字
预算必须是大于等于5的数字

Шаг 6: ROAS (только для e-commerce)

步骤6：ROAS（仅适用于电商）

Спрашивать только если ниша = E-commerce.

Целевой ROAS:

ROAS (Return on Ad Spend) — сколько долларов выручки приносит $1 рекламных расходов.

Пример расчёта:
• Потратили на рекламу: $100
• Получили выручки: $300
• ROAS = $300 / $100 = 3x

Формула: ROAS = Выручка / Расходы на рекламу

Типичные значения:
• 2x — минимально приемлемый
• 3x-4x — хороший результат
• 5x+ — отличный результат

> Целевой ROAS: Xх (например: 3x) или "не отслеживаю"

仅当领域为E-commerce时询问。

目标ROAS:

ROAS（广告支出回报率）— 每1美元广告投入带来的营收金额。

计算示例:
• 广告投入: $100
• 获得营收: $300
• ROAS = $300 / $100 = 3x

公式: ROAS = 营收 / 广告支出

典型值:
• 2x — 最低可接受值
• 3x-4x — 良好结果
• 5x+ — 优秀结果

> 目标ROAS: Xx（例如：3x）或 "不追踪"

Шаг 7: Валидация

步骤7：验证

Выведи ВСЮ собранную информацию в структурированном виде:

📋 СВОДКА ОНБОРДИНГА

以结构化形式显示所有收集到的信息:

📋 入职引导汇总

Базовая информация

基本信息

Название: {business_name}
Account ID: {account_id}
Валюта: USD
Часовой пояс: {timezone}
Ниша: {niche}

名称: {business_name}
账户ID: {account_id}
货币: USD
时区: {timezone}
领域: {niche}

Бизнес

业务信息

Продукт: {product}
Регион: {region}
ЦА: {target_audience}
Боли: {pains}
Преимущества: {advantages}

产品: {product}
区域: {region}
目标受众: {target_audience}
痛点: {pains}
优势: {advantages}

Цель рекламы

广告目标

Цель: {goal} ({objective} / {optimization_goal})
ROAS: {roas} (если e-commerce)

目标: {goal}（{objective} / {optimization_goal}）
ROAS: {roas}（如为电商）

Технические ID

技术ID

Page ID: {page_id}
Instagram ID: {instagram_id} (или "нет")
WhatsApp: {whatsapp_phone} (если WhatsApp)
Lead Form ID: {lead_form_id} (если Lead-формы)
Pixel ID: {pixel_id} (если Site Leads)
Сайт: {website_url} (если Site Leads)

主页ID: {page_id}
Instagram ID: {instagram_id}（或"无"）
WhatsApp: {whatsapp_phone}（如为WhatsApp目标）
线索表单ID: {lead_form_id}（如为线索表单目标）
Pixel ID: {pixel_id}（如为Site Leads目标）
网站: {website_url}（如为Site Leads目标）

Направления ({count})

广告方向（{count}个）

Название	Целевой CPL	Бюджет	Приоритет	Campaign ID
{directions_rows}

Всё верно? (да / нет, изменить)


Если "нет" — спроси что изменить и обнови данные.

---

名称	目标CPL	预算	优先级	活动ID
{directions_rows}

以上信息是否正确？（是 / 否，修改）


如果用户回答"否" — 询问需要修改的内容并更新数据。

---

Шаг 8: Генерация файлов

步骤8：生成文件

После подтверждения создай файлы:

用户确认后，创建以下文件:

1. Добавь запись в ad_accounts.md

1. 在ad_accounts.md中添加记录

Прочитай

.claude/ads-agent/config/ad_accounts.md

, найди последний номер аккаунта и добавь в конец (перед "Пример формата"):

markdown

---

读取

.claude/ads-agent/config/ad_accounts.md

，找到最后一个账户编号，在末尾（"示例格式"之前）添加:

markdown

---

Аккаунт {N}: {business_name}

账户{N}: {business_name}

Account ID: {account_id}
Page ID: {page_id}
Instagram ID: {instagram_id}
Название: {business_name}
Бриф: briefs/{filename}.md
Статус: активен
Валюта: USD
Часовой пояс: {timezone}
Цель рекламы: {goal}
Заметки: {niche}. {short_description}

undefined

账户ID: {account_id}
主页ID: {page_id}
Instagram ID: {instagram_id}
名称: {business_name}
简报: briefs/{filename}.md
状态: 活跃
货币: USD
时区: {timezone}
广告目标: {goal}
备注: {niche}. {short_description}

undefined

2. Создай briefs/{filename}.md

2. 创建briefs/{filename}.md

markdown

undefined

markdown

undefined

{business_name} - Бриф

{business_name} - 简报

Создан через /account-onboarding {date}

通过/account-onboarding创建于{date}

Бизнес

业务信息

Ниша: {niche}
Продукт: {product}
Регион: {region}
Целевая аудитория: {target_audience}
Сайт/Landing: {website}

领域: {niche}
产品: {product}
区域: {region}
目标受众: {target_audience}
网站/着陆页: {website}

Для копирайтинга

文案创作参考

Боли клиентов: {pains}
Преимущества: {advantages}

客户痛点: {pains}
竞争优势: {advantages}

Цель рекламы

广告目标

Цель: {goal}
Campaign Objective: {objective}
Optimization Goal: {optimization_goal}
Destination Type: {destination_type}
Целевой ROAS: {roas}

目标: {goal}
Campaign Objective: {objective}
Optimization Goal: {optimization_goal}
Destination Type: {destination_type}
目标ROAS: {roas}

Технические ID (для API)

技术ID（用于API）

Обязательные

必填项

Facebook Page ID:
```
{page_id}
```
Instagram Account ID:
```
{instagram_id}
```

Facebook主页ID:
```
{page_id}
```
Instagram账户ID:
```
{instagram_id}
```

В зависимости от цели

根据目标不同

Для WhatsApp:

适用于WhatsApp:

WhatsApp номер:
```
{whatsapp_phone}
```

WhatsApp号码:
```
{whatsapp_phone}
```

Для Lead-форм:

适用于线索表单:

Lead Form ID:
```
{lead_form_id}
```
Поля формы: {form_fields}

线索表单ID:
```
{lead_form_id}
```
表单字段: {form_fields}

Для Site Leads:

适用于Site Leads:

URL сайта: {website_url}
Pixel ID:
```
{pixel_id}
```
Настроенные события: {pixel_events}

网站URL: {website_url}
Pixel ID:
```
{pixel_id}
```
已设置事件: {pixel_events}

Гео-локации

地理位置

Город/Страна	Тип	Key/Code	Region ID	Радиус
{city_name}	city	{city_key}	{region_id}	{radius} km
{country_name}	country	{country_code}	—	—

城市/国家	类型	Key/Code	区域ID	半径
{city_name}	city	{city_key}	{region_id}	{radius} km
{country_name}	country	{country_code}	—	—

Правила оптимизации (дефолты)

优化规则（默认值）

Пороговые значения

阈值

Минимум impressions для решений: 1000
Минимум конверсий для решений: 3
Минимум дней до агрессивных действий: 2
Ad-eater порог: CPL > target × 3

决策所需最低展示量: 1000
决策所需最低转化量: 3
执行激进操作的最低天数: 2
Ad-eater阈值: CPL > 目标值×3

Бюджетные лимиты

预算限制

Максимальное увеличение за раз: 30%
Максимальное уменьшение за раз: 50%

单次最大增幅: 30%
单次最大降幅: 50%

Временные ограничения

时间限制

Часовой пояс: {timezone}
Не создавать adsets после: 18:00

时区: {timezone}
18:00后不创建广告组

CPL диапазоны

CPL区间

Normal: target × 1.0-1.5
High: target × 1.5-2.0
Ad-eater: target × 3.0+

正常: 目标值×1.0-1.5
偏高: 目标值×1.5-2.0
Ad-eater: 目标值×3.0+

Активные кампании/направления

活跃活动/广告方向

Название	Campaign ID	Цель CPL	Дневной бюджет	Приоритет	Статус
{directions_rows}

名称	活动ID	目标CPL	每日预算	优先级	状态
{directions_rows}

Заметки

备注

Создан: {date}
Онбординг провёл: Claude (skill: account-onboarding)

创建时间: {date}
入职引导执行方: Claude（skill: account-onboarding）

История изменений

修改历史

Дата	Изменение
{date}	Создан бриф через /account-onboarding

---

日期	修改内容
{date}	通过/account-onboarding创建简报

---

Шаг 9: Тест подключения

步骤9：连接测试

После создания файлов проверь доступ к API:

python

undefined

文件创建完成后，检查API访问权限:

python

undefined

Проверка доступа

访问权限检查

campaigns = get_campaigns(account_id="{account_id}", limit=5)


Выведи результат:

✅ Онбординг завершён!

Созданные файлы:

.claude/ads-agent/config/ad_accounts.md — запись добавлена
.claude/ads-agent/config/briefs/{filename}.md — бриф создан

API проверка:

Доступ к аккаунту: ✅
Найдено кампаний: {count}

Теперь можно использовать:

/ads-optimizer — оптимизация
/ads-reporter — отчёты
/campaign-manager — управление кампаниями


Если API вернул ошибку:

⚠️ Файлы созданы, но API недоступен!

Ошибка: {error_message}

Проверьте:

Account ID правильный?
MCP токен имеет доступ к аккаунту?
Аккаунт активен в Business Manager?

Файлы сохранены, можно исправить Account ID в briefs/{filename}.md

---

campaigns = get_campaigns(account_id="{account_id}", limit=5)


显示结果:

✅ 入职引导完成！

已创建文件:

.claude/ads-agent/config/ad_accounts.md — 添加了账户记录
.claude/ads-agent/config/briefs/{filename}.md — 创建了简报

API检查结果:

账户访问权限: ✅
找到活动数量: {count}

现在可以使用:

/ads-optimizer — 优化功能
/ads-reporter — 报告功能
/campaign-manager — 活动管理


如果API返回错误:

⚠️ 文件已创建，但API无法访问！

错误信息: {error_message}

请检查:

账户ID是否正确？
MCP令牌是否拥有该账户的访问权限？
账户在Business Manager中是否处于活跃状态？

文件已保存，可在briefs/{filename}.md中修改账户ID

---

Дефолтные значения

默认值

yaml

currency: USD

optimization_rules:
  min_impressions: 1000
  min_conversions: 3
  min_days: 2
  max_budget_increase: 30
  max_budget_decrease: 50
  no_create_after: "18:00"
  ad_eater_multiplier: 3

cpl_ranges:
  normal_multiplier: 1.5
  high_multiplier: 2.0
  ad_eater_multiplier: 3.0

budget_defaults:
  adset_min: 5

yaml

currency: USD

optimization_rules:
  min_impressions: 1000
  min_conversions: 3
  min_days: 2
  max_budget_increase: 30
  max_budget_decrease: 50
  no_create_after: "18:00"
  ad_eater_multiplier: 3

cpl_ranges:
  normal_multiplier: 1.5
  high_multiplier: 2.0
  ad_eater_multiplier: 3.0

budget_defaults:
  adset_min: 5

Цели и их параметры

目标及对应参数

Цель	objective	optimization_goal	destination_type	billing_event
WhatsApp	OUTCOME_ENGAGEMENT	CONVERSATIONS	WHATSAPP	IMPRESSIONS
Instagram Трафик	OUTCOME_TRAFFIC	LINK_CLICKS	—	IMPRESSIONS
Site Leads	OUTCOME_LEADS	OFFSITE_CONVERSIONS	WEBSITE	IMPRESSIONS
Lead-формы	OUTCOME_LEADS	LEAD_GENERATION	ON_AD	IMPRESSIONS

目标	objective	optimization_goal	destination_type	billing_event
WhatsApp	OUTCOME_ENGAGEMENT	CONVERSATIONS	WHATSAPP	IMPRESSIONS
Instagram流量	OUTCOME_TRAFFIC	LINK_CLICKS	—	IMPRESSIONS
Site Leads	OUTCOME_LEADS	OFFSITE_CONVERSIONS	WEBSITE	IMPRESSIONS
线索表单	OUTCOME_LEADS	LEAD_GENERATION	ON_AD	IMPRESSIONS

Валидация данных

数据验证规则

Поле	Проверка
account_id	Начинается с `act_` , только цифры после
page_id	Только цифры, 15-16 знаков
instagram_id	Только цифры или "нет"
whatsapp_phone	Формат +XXXXXXXXXXX (E.164)
lead_form_id	Только цифры или "создать новую"
pixel_id	Только цифры, 15-16 знаков
website_url	Валидный URL с https://
timezone	Формат UTC+X или UTC-X
target_cpl	Число > 0
roas	Число > 1 или "не отслеживаю"
budget	Числа > 0, min >= 5

字段	验证规则
account_id	以 `act_` 开头，后续仅为数字
page_id	仅数字，15-16位
instagram_id	仅数字或"无"
whatsapp_phone	格式为+XXXXXXXXXXX（E.164标准）
lead_form_id	仅数字或"创建新表单"
pixel_id	仅数字，15-16位
website_url	有效的https://格式URL
timezone	格式为UTC+X或UTC-X
target_cpl	大于0的数字
roas	大于1的数字或"不追踪"
budget	大于0的数字，最小值≥5

Генерация filename

文件名生成规则

filename = business_name.lower()
           .replace(" ", "_")
           .replace("-", "_")
           .replace(/[^a-z0-9_]/g, "")

Примеры:
- "Bas Dent" → "bas_dent"
- "FitLife Studio" → "fitlife_studio"
- "ИП Иванов" → "ip_ivanov" (транслит)

filename = business_name.lower()
           .replace(" ", "_")
           .replace("-", "_")
           .replace(/[^a-z0-9_]/g, "")

示例:
- "Bas Dent" → "bas_dent"
- "FitLife Studio" → "fitlife_studio"
- "ИП Иванов" → "ip_ivanov"（音译）

После онбординга

入职引导完成后

Чек-лист готовности:

Бриф создан в
```
briefs/{name}.md
```
Аккаунт добавлен в
```
ad_accounts.md
```
API доступ проверен
Готов к
```
/ads-optimizer
```

就绪检查清单:

简报已创建于
```
briefs/{name}.md
```
账户已添加至
```
ad_accounts.md
```
API访问权限已验证
可使用
```
/ads-optimizer
```

Частые ошибки

常见错误

Ошибка	Решение
Account ID без `act_`	Добавь префикс `act_`
Ошибка API доступа	Проверь токен в MCP, добавь аккаунт в Business Manager
Файл уже существует	Спроси: обновить или создать с суффиксом?

错误	解决方案
账户ID缺少 `act_` 前缀	添加 `act_` 前缀
API访问错误	检查MCP令牌，在Business Manager中添加账户
文件已存在	询问用户：更新文件还是创建带后缀的新文件？