41 lines
3.1 KiB
Markdown
41 lines
3.1 KiB
Markdown
---
|
||
description: Запустить SEO-аудит сайта и показать executive summary
|
||
argument-hint: <url или project_id>
|
||
---
|
||
|
||
Пользователь хочет провести полный SEO-аудит. Аргумент: `$ARGUMENTS`
|
||
|
||
## Шаги
|
||
|
||
1. **Определить project_id:**
|
||
- Если аргумент похож на URL — вызови `list_projects` и найди проект, у которого `url` или `domain` совпадает с аргументом.
|
||
- Если нашёл — используй его `project_id`.
|
||
- Если не нашёл — спроси пользователя подтверждение и вызови `create_project` с этим URL.
|
||
- Если аргумент — число/uuid — используй как `project_id` напрямую.
|
||
- Если аргумент пустой — вызови `list_projects` и попроси пользователя выбрать проект.
|
||
|
||
2. **Запустить аудит:**
|
||
- Вызови `start_audit` с найденным `project_id`.
|
||
- Сохрани `audit_run_id` из ответа — он понадобится для следующих шагов и должен оставаться видимым пользователю.
|
||
|
||
3. **Polling статуса:**
|
||
- Вызывай `get_audit_status` с возрастающим интервалом: 10s → 30s → 60s → 60s...
|
||
- Не делай tight loop. На каждой итерации показывай пользователю короткий статус (прогресс/этап).
|
||
- Останавливайся когда `status` = `completed` (успех) или `failed`/`cancelled` (показать причину).
|
||
|
||
4. **Executive summary:**
|
||
- При успехе вызови `get_executive_summary` для этого `audit_run_id`.
|
||
- Покажи пользователю результат: краткое резюме, топ-проблемы, ключевые метрики.
|
||
|
||
5. **Сохранить артефакт:**
|
||
- Если есть `mcp.write` (если scope позволяет) — вызови `save_audit_artifact` с типом `executive_summary`, `source="claude-code"`, телом полученного summary.
|
||
- Если `mcp.write` нет — пропусти этот шаг молча.
|
||
|
||
6. **Финальный вывод:**
|
||
- Покажи `audit_run_id` и подскажи следующие команды: `/222a-issue <code>` для разбора проблемы, `/222a-report` для client report, `/222a-progress` для сравнения с предыдущим аудитом.
|
||
|
||
## Замечания
|
||
|
||
- При ошибках `mcp.write` (scope error) — сообщи пользователю «токен без `mcp.write` — артефакт не сохранён», но не прерывай вывод executive summary.
|
||
- Если `start_audit` падает с «project not in current team» — попроси пользователя проверить, что токен от того же аккаунта, в котором создан проект.
|