code-ai-installer 1.5.6 → 2.0.1

package/domains/content/.agents/skills/content-review-checklist/SKILL.md

@@ -0,0 +1,320 @@
+---
+name: content-review-checklist
+description: Системный чеклист ревью контента — качество текста, визуала, SEO, ссылки, юридика, accessibility — с severity-маппингом и suggested fixes
+---
+# Content Review Checklist — Чеклист ревью контента
+
+## Когда использовать
+- На этапе **Reviewer** — основная проверка качества контента перед `$content-release-gate`.
+- При **повторном ревью** — после доработки по предыдущим замечаниям.
+- При **самопроверке** копирайтером — до передачи на ревью (сокращает итерации).
+
+## Зона ответственности
+
+Этот скил проверяет **качество контента** — текст, визуал, ссылки, SEO, юридику, accessibility.
+
+> **Разграничение с `$brand-compliance`:** Brand compliance проверяет соответствие бренд-гайдлайнам (ToV, палитра, лого, позиционирование). Этот чеклист проверяет качество исполнения (грамматика, факты, читаемость, ссылки, SEO). Пункты пересекаются минимально — при совпадении ссылаться на результат `$brand-compliance`.
+
+## Вход
+
+| Поле | Обязательно | Описание |
+|------|:-----------:|----------|
+| Контент для проверки | ✅ | Финальный текст + визуал от Copywriter / Visual Concept |
+| Контент-бриф | ✅ | Из `$content-brief` — для сверки цели, тезисов, CTA, персоны, объёма |
+| Бренд-гайдлайны | ✅ | Из `$brand-guidelines` — для проверки ToV и стоп-листа |
+| Результат `$brand-compliance` | ⬚ | Если уже пройден — ссылаться на него, не дублировать |
+| Результат `$fact-checking` | ⬚ | Если уже пройден — ссылаться, не перепроверять |
+| Платформенные спеки | ⬚ | Из `$platform-strategy` / `$platform-compliance` — размеры, лимиты |
+
+> Если контент-бриф не предоставлен — **запросить у пользователя**. Ревью без эталона = субъективное мнение.
+
+## Severity — маппинг по умолчанию
+
+Каждый пункт чеклиста имеет **severity по умолчанию**. Ревьюер может повысить или понизить severity с обоснованием.
+
+| Severity | Определение | Влияние |
+|----------|-------------|---------|
+| 🔴 **Blocker** | Публикация невозможна. Фактическая ошибка, юридический риск, полное несоответствие брифу. | REQUIRES CHANGES |
+| 🟡 **Major** | Публикация нежелательна. Заметная проблема качества. | REQUIRES CHANGES (при ≥ 3) |
+| 🔵 **Minor** | Публикация возможна. Косметическое улучшение. | Не блокирует |
+
+### Порог решения
+
+| Решение | Условие |
+|---------|---------|
+| **APPROVED** | 0 Blocker + ≤ 2 Major + любое количество Minor |
+| **REQUIRES CHANGES** | ≥ 1 Blocker ИЛИ ≥ 3 Major |
+
+## Протокол
+
+### Шаг 1 — Подготовка
+1. Получить все обязательные входные данные.
+2. Если `$brand-compliance` и/или `$fact-checking` уже пройдены — загрузить результаты, не дублировать проверку.
+3. Открыть контент-бриф — зафиксировать: цель, персону, тезисы, CTA, объём, формат.
+
+### Шаг 2 — Прохождение чеклиста
+1. Пройти **все пункты** последовательно по категориям (текст → визуал → SEO → ссылки → юридика → accessibility).
+2. Для каждого пункта отметить: ✅ / ❌ / N/A.
+3. Для каждого ❌ — **обязательно**:
+   - Указать severity (по умолчанию из маппинга, можно скорректировать с обоснованием).
+   - Привести конкретную цитату / пример проблемы.
+   - Предложить **suggested fix** — конкретное исправление, а не «переделать».
+
+### Шаг 3 — Формирование решения
+1. Подсчитать 🔴 / 🟡 / 🔵.
+2. Применить порог решения.
+3. Сформировать список действий (если REQUIRES CHANGES).
+
+## Полный чеклист с severity-маппингом
+
+### Категория: Текст — соответствие брифу
+
+| # | Критерий | Default severity |
+|---|----------|-----------------|
+| 1 | Тема соответствует брифу | 🔴 Blocker |
+| 2 | Цель контента достигается (читатель понимает, что делать) | 🔴 Blocker |
+| 3 | Персона ЦА — текст говорит на её языке | 🟡 Major |
+| 4 | Все ключевые тезисы из брифа раскрыты | 🟡 Major |
+| 5 | Запрещённые темы не затронуты | 🔴 Blocker |
+| 6 | Обязательные элементы присутствуют (факты, цитаты, данные) | 🟡 Major |
+
+### Категория: Текст — качество
+
+| # | Критерий | Default severity |
+|---|----------|-----------------|
+| 7 | Нет орфографических ошибок | 🟡 Major |
+| 8 | Нет грамматических ошибок | 🟡 Major |
+| 9 | Читаемость — предложения не перегружены, абзацы ≤ 3-4 предложения | 🔵 Minor |
+| 10 | Заголовок / hook захватывает внимание | 🟡 Major |
+| 11 | Объём соответствует брифу и платформе | 🟡 Major |
+| 12 | Нет запрещённых слов / клише (из стоп-листа) | 🟡 Major |
+| 13 | Нет повторов, воды, бессмысленных фраз | 🔵 Minor |
+| 14 | Логичная структура — от hook к CTA | 🔵 Minor |
+
+### Категория: Текст — CTA
+
+| # | Критерий | Default severity |
+|---|----------|-----------------|
+| 15 | CTA присутствует | 🔴 Blocker |
+| 16 | CTA конкретен (одно действие, не «подпишись и купи и поделись») | 🟡 Major |
+| 17 | CTA соответствует этапу воронки из брифа | 🟡 Major |
+
+### Категория: Факты
+
+| # | Критерий | Default severity |
+|---|----------|-----------------|
+| 18 | Все факты и цифры верифицированы (или ссылка на `$fact-checking`) | 🔴 Blocker |
+| 19 | Источники указаны где требуется | 🟡 Major |
+
+### Категория: Визуал
+
+| # | Критерий | Default severity |
+|---|----------|-----------------|
+| 20 | Визуал соответствует тексту и теме | 🟡 Major |
+| 21 | Размеры соответствуют платформе | 🔴 Blocker |
+| 22 | Текст на изображении читаем (контраст, размер шрифта) | 🟡 Major |
+| 23 | Визуальный стиль соответствует бренду (или ссылка на `$brand-compliance`) | 🟡 Major |
+| 24 | Лого размещено корректно (если требуется) | 🔵 Minor |
+| 25 | Нет артефактов AI-генерации (лишние пальцы, текст-мусор, искажения) | 🔴 Blocker |
+
+### Категория: SEO (для текстовых форматов)
+
+| # | Критерий | Default severity |
+|---|----------|-----------------|
+| 26 | Основное ключевое слово присутствует в заголовке | 🟡 Major |
+| 27 | Ключевые слова распределены естественно по тексту | 🔵 Minor |
+| 28 | Мета-заголовок ≤ 60 символов | 🔵 Minor |
+| 29 | Мета-описание ≤ 160 символов, содержит CTA | 🔵 Minor |
+> N/A для форматов без SEO (сторис, reels, email).
+
+### Категория: Ссылки и мета
+
+| # | Критерий | Default severity |
+|---|----------|-----------------|
+| 30 | Все ссылки рабочие (нет 404) | 🔴 Blocker |
+| 31 | UTM-метки добавлены (если есть ссылки) | 🔵 Minor |
+| 32 | Хэштеги бренда использованы | 🔵 Minor |
+
+### Категория: Юридика
+
+| # | Критерий | Default severity |
+|---|----------|-----------------|
+| 33 | Disclaimer присутствует (если контент рекламный / финансовый / медицинский) | 🔴 Blocker |
+| 34 | Копирайт © указан (если требуется) | 🟡 Major |
+| 35 | Нет нарушения авторских прав (чужие фото, текст, музыка) | 🔴 Blocker |
+
+### Категория: Accessibility
+
+| # | Критерий | Default severity |
+|---|----------|-----------------|
+| 36 | Alt-текст добавлен к изображениям | 🔵 Minor |
+| 37 | Контраст текста достаточен для чтения | 🔵 Minor |
+| 38 | Субтитры / текстовая версия для видео (если применимо) | 🟡 Major |
+
+## Валидация (Quality Gate)
+
+Ревью считается завершённым если:
+
+- [ ] Все пункты чеклиста пройдены (✅ / ❌ / N/A — ни одного пустого)
+- [ ] Для каждого ❌ указаны: severity, цитата/пример, suggested fix
+- [ ] Решение соответствует порогу (не субъективное, а по правилам)
+- [ ] Если REQUIRES CHANGES — список действий сформирован с приоритетами
+- [ ] Если есть результат `$brand-compliance` / `$fact-checking` — сослались, не дублировали
+
+## Handoff
+
+| Решение | Маршрут |
+|---------|---------|
+| **APPROVED** | → `$content-release-gate` с приложением чеклиста |
+| **REQUIRES CHANGES** | → обратно исполнителю с конкретным списком правок |
+
+Маршрут возврата по типу замечания:
+
+| Категория замечаний | Куда возврат |
+|--------------------|-------------|
+| Текст (тема, тезисы, CTA, качество) | → Copywriter |
+| Факты | → Researcher → `$fact-checking` |
+| Визуал | → Visual Concept |
+| SEO | → Copywriter (или SEO-специалист) |
+| Юридика | → Эскалация пользователю |
+
+При передаче — использовать `$handoff` с приложением чеклиста и списка правок.
+
+## Интеграция с другими скилами
+
+| Скил | Взаимодействие |
+|------|----------------|
+| `$content-brief` | **Эталон:** сверка цели, тезисов, CTA, персоны, объёма |
+| `$brand-guidelines` | **Эталон:** ToV, стоп-лист |
+| `$brand-compliance` | **Комплемент:** бренд-проверка — если пройдена, не дублировать |
+| `$fact-checking` | **Комплемент:** верификация фактов — если пройдена, не дублировать |
+| `$readability-scoring` | **Комплемент:** детальная оценка читаемости |
+| `$platform-compliance` | **Комплемент:** проверка правил платформы |
+| `$content-release-gate` | **Потребитель:** результат чеклиста — вход для Release Gate |
+| `$board` | Обновить статус гейта Reviewer |
+
+## Anti-patterns
+
+| Ошибка | Почему плохо | Как правильно |
+|--------|-------------|---------------|
+| Ревью без брифа | Субъективное «мне не нравится» вместо проверки по критериям | Всегда сверять с `$content-brief` |
+| ❌ без suggested fix | Автор не знает, что исправлять | Каждое замечание = конкретное предложение |
+| Всё — blocker | Автор демотивирован, не понимает приоритеты | Severity по маппингу, корректировка с обоснованием |
+| Дублирование `$brand-compliance` | Двойная работа, возможные противоречия | Ссылаться на результат, не перепроверять |
+| Пропуск категорий | «Текст ок» — а ссылки битые, disclaimer нет | Пройти все категории, отметить N/A если не применимо |
+| Ревью только текста | Визуал с артефактами AI проходит незамеченным | Визуал — обязательная категория |
+| Субъективные замечания | «Заголовок слабый» — а почему? | Конкретика: «Заголовок не содержит выгоду для ЦА, предлагаю: [вариант]» |
+
+## Шаблон вывода
+
+```
+### Content Review Checklist — [Название контента]
+
+**ID:** [из $content-brief]
+**Ревьюер:** [агент / роль]
+**Итерация:** [1 / 2 / N]
+**Дата ревью:** [YYYY-MM-DD]
+
+**Эталоны:**
+- Бриф: [ссылка / ID]
+- Brand compliance: [пройден ✅ / не пройден / не проводился]
+- Fact checking: [пройден ✅ / не пройден / не проводился]
+
+---
+
+#### Текст — соответствие брифу
+| # | Критерий | Sev | Статус | Комментарий / Suggested Fix |
+|---|----------|-----|--------|----------------------------|
+| 1 | Тема соответствует брифу | 🔴 | ✅/❌ | |
+| 2 | Цель контента достигается | 🔴 | ✅/❌ | |
+| 3 | Персона ЦА — язык, боли | 🟡 | ✅/❌ | |
+| 4 | Ключевые тезисы раскрыты | 🟡 | ✅/❌ | |
+| 5 | Запрещённые темы не затронуты | 🔴 | ✅/❌ | |
+| 6 | Обязательные элементы присутствуют | 🟡 | ✅/❌ | |
+
+#### Текст — качество
+| # | Критерий | Sev | Статус | Комментарий / Suggested Fix |
+|---|----------|-----|--------|----------------------------|
+| 7 | Орфография | 🟡 | ✅/❌ | |
+| 8 | Грамматика | 🟡 | ✅/❌ | |
+| 9 | Читаемость | 🔵 | ✅/❌ | |
+| 10 | Hook / заголовок | 🟡 | ✅/❌ | |
+| 11 | Объём | 🟡 | ✅/❌ | |
+| 12 | Стоп-слова / клише | 🟡 | ✅/❌ | |
+| 13 | Нет воды / повторов | 🔵 | ✅/❌ | |
+| 14 | Логичная структура | 🔵 | ✅/❌ | |
+
+#### Текст — CTA
+| # | Критерий | Sev | Статус | Комментарий / Suggested Fix |
+|---|----------|-----|--------|----------------------------|
+| 15 | CTA присутствует | 🔴 | ✅/❌ | |
+| 16 | CTA конкретен (одно действие) | 🟡 | ✅/❌ | |
+| 17 | CTA соответствует воронке | 🟡 | ✅/❌ | |
+
+#### Факты
+| # | Критерий | Sev | Статус | Комментарий / Suggested Fix |
+|---|----------|-----|--------|----------------------------|
+| 18 | Факты верифицированы | 🔴 | ✅/❌/ref:$fact-checking | |
+| 19 | Источники указаны | 🟡 | ✅/❌/N/A | |
+
+#### Визуал
+| # | Критерий | Sev | Статус | Комментарий / Suggested Fix |
+|---|----------|-----|--------|----------------------------|
+| 20 | Соответствует тексту и теме | 🟡 | ✅/❌ | |
+| 21 | Размеры для платформы | 🔴 | ✅/❌ | |
+| 22 | Текст на изображении читаем | 🟡 | ✅/❌ | |
+| 23 | Стиль бренда | 🟡 | ✅/❌/ref:$brand-compliance | |
+| 24 | Лого корректно | 🔵 | ✅/❌/N/A | |
+| 25 | Нет AI-артефактов | 🔴 | ✅/❌/N/A | |
+
+#### SEO (N/A для сторис, reels, email)
+| # | Критерий | Sev | Статус | Комментарий / Suggested Fix |
+|---|----------|-----|--------|----------------------------|
+| 26 | Ключ в заголовке | 🟡 | ✅/❌/N/A | |
+| 27 | Ключи распределены | 🔵 | ✅/❌/N/A | |
+| 28 | Мета-title ≤ 60 | 🔵 | ✅/❌/N/A | |
+| 29 | Мета-description ≤ 160 | 🔵 | ✅/❌/N/A | |
+
+#### Ссылки и мета
+| # | Критерий | Sev | Статус | Комментарий / Suggested Fix |
+|---|----------|-----|--------|----------------------------|
+| 30 | Ссылки рабочие | 🔴 | ✅/❌/N/A | |
+| 31 | UTM-метки | 🔵 | ✅/❌/N/A | |
+| 32 | Хэштеги бренда | 🔵 | ✅/❌/N/A | |
+
+#### Юридика
+| # | Критерий | Sev | Статус | Комментарий / Suggested Fix |
+|---|----------|-----|--------|----------------------------|
+| 33 | Disclaimer (если рекламный/фин/мед) | 🔴 | ✅/❌/N/A | |
+| 34 | Копирайт © | 🟡 | ✅/❌/N/A | |
+| 35 | Нет нарушения авторских прав | 🔴 | ✅/❌ | |
+
+#### Accessibility
+| # | Критерий | Sev | Статус | Комментарий / Suggested Fix |
+|---|----------|-----|--------|----------------------------|
+| 36 | Alt-текст | 🔵 | ✅/❌/N/A | |
+| 37 | Контраст текста | 🔵 | ✅/❌/N/A | |
+| 38 | Субтитры для видео | 🟡 | ✅/❌/N/A | |
+
+---
+
+#### Сводка
+
+| Severity | Количество | Пункты |
+|----------|-----------|--------|
+| 🔴 Blocker | [N] | #[список] |
+| 🟡 Major | [N] | #[список] |
+| 🔵 Minor | [N] | #[список] |
+
+### Решение: [ APPROVED / REQUIRES CHANGES ]
+
+**Обоснование:** [по правилам порога: 0 blocker + ≤ 2 major = APPROVED]
+
+**Список действий (если REQUIRES CHANGES):**
+| Приоритет | Пункт | Исполнитель | Suggested Fix |
+|-----------|-------|-------------|---------------|
+| 🔴 | #[N] | [Copywriter / Visual Concept / Researcher] | [конкретное исправление] |
+| 🟡 | #[N] | [исполнитель] | [конкретное исправление] |
+
+**→ Следующий шаг:** [→ $content-release-gate / → обратно [исполнитель] с правками]
+```

package/domains/content/.agents/skills/content-review-checklist/agents/claude.json

@@ -0,0 +1,10 @@
+{
+  "name": "content-review-checklist",
+  "display_name": "Чеклист ревью контента",
+  "description": "Системный чеклист проверки качества текста и визуала перед публикацией",
+  "default_prompt": "Используй $content-review-checklist, когда задача относится к навыку \"Чеклист ревью контента\".",
+  "triggers": ["content-review-checklist", "Чеклист ревью контента", "Системный чеклист проверки качества текста и визуала перед публикацией"],
+  "capabilities": ["content-review-checklist"],
+  "tools": [],
+  "implicit_invocation": true
+}

package/domains/content/.agents/skills/content-review-checklist/agents/copilot.json

@@ -0,0 +1,10 @@
+{
+  "name": "content-review-checklist",
+  "display_name": "Чеклист ревью контента",
+  "description": "Системный чеклист проверки качества текста и визуала перед публикацией",
+  "default_prompt": "Используй $content-review-checklist, когда задача относится к навыку \"Чеклист ревью контента\".",
+  "triggers": ["content-review-checklist", "Чеклист ревью контента", "Системный чеклист проверки качества текста и визуала перед публикацией"],
+  "capabilities": ["content-review-checklist"],
+  "tools": [],
+  "implicit_invocation": true
+}

package/domains/content/.agents/skills/content-review-checklist/agents/gemini.json

@@ -0,0 +1,10 @@
+{
+  "name": "content-review-checklist",
+  "display_name": "Чеклист ревью контента",
+  "description": "Системный чеклист проверки качества текста и визуала перед публикацией",
+  "default_prompt": "Используй $content-review-checklist, когда задача относится к навыку \"Чеклист ревью контента\".",
+  "triggers": ["content-review-checklist", "Чеклист ревью контента", "Системный чеклист проверки качества текста и визуала перед публикацией"],
+  "capabilities": ["content-review-checklist"],
+  "tools": [],
+  "implicit_invocation": true
+}

package/domains/content/.agents/skills/content-review-checklist/agents/openai.yaml

@@ -0,0 +1,8 @@
+interface:
+  display_name: "Чеклист ревью контента"
+  short_description: "Системный чеклист проверки качества текста и визуала перед публикацией"
+  default_prompt: "Используй $content-review-checklist, когда задача относится к навыку \"Чеклист ревью контента\"."
+dependencies:
+  tools: []
+policy:
+  allow_implicit_invocation: true

package/domains/content/.agents/skills/content-review-checklist/agents/qwen.json

@@ -0,0 +1,10 @@
+{
+  "name": "content-review-checklist",
+  "display_name": "Чеклист ревью контента",
+  "description": "Системный чеклист проверки качества текста и визуала перед публикацией",
+  "default_prompt": "Используй $content-review-checklist, когда задача относится к навыку \"Чеклист ревью контента\".",
+  "triggers": ["content-review-checklist", "Чеклист ревью контента", "Системный чеклист проверки качества текста и визуала перед публикацией"],
+  "capabilities": ["content-review-checklist"],
+  "tools": [],
+  "implicit_invocation": true
+}

package/domains/content/.agents/skills/content-review-checklist/agents/skill.yaml

@@ -0,0 +1,20 @@
+version: 1
+name: "content-review-checklist"
+display_name: "Чеклист ревью контента"
+description: "Системный чеклист проверки качества текста и визуала перед публикацией"
+default_prompt: "Используй $content-review-checklist, когда задача относится к навыку \"Чеклист ревью контента\"."
+triggers:
+  - "content-review-checklist"
+  - "Чеклист ревью контента"
+  - "Системный чеклист проверки качества текста и визуала перед публикацией"
+capabilities:
+  - "content-review-checklist"
+tools: []
+invocation:
+  explicit: true
+  implicit: true
+localization:
+  default_locale: "ru"
+  available_locales:
+    - "ru"
+    - "en"