quality-check

Files (1)

• SKILL.md

SKILL.md (first lines)

# Quality Check - Отдел контроля качества (ОТК)

## Назначение

Обязательная проверка ЛЮБОГО материала перед сдачей {{OWNER_NAME}}. Это последний рубеж перед публикацией. Если ОТК не пройден - материал возвращается на доработку.

## Главный принцип: НЕ НАВРЕДИ

Любой продукт который мы выпускаем - скилл, инструкция, агент, PDF - должен быть "стерильным":
- Работает на ЛЮБОЙ ОС (macOS, Linux, Windows/WSL)
- Работает с ЛЮБОЙ моделью (Claude, GPT, Gemini, локальные)
- НЕ ломает то что уже стоит у человека (скиллы, кроны, конфиг, память)
- НЕ перезаписывает чужие файлы без явного предупреждения
- AGENT.md всегда начинает с "просканируй что уже есть" перед изменениями
- Легко устанавливается и легко удаляется (инструкция по откату)
- Зависимости: ноль или минимум, все проверяются перед использованием

Если продукт не проходит этот принцип - он не готов. Точка.

**Кто проходит ОТК:**
- Валера (Тимлид) - ОБЯЗАТЕЛЬНО перед сдачей каждого продукта
- {{AGENT_NICKNAME}} - при самостоятельном создании материалов
- Продюсер - финальная проверка собранного пакета

**Принцип: никто не проверяет сам себя.** Если Валера создал - ОТК прогоняет Продюсер или {{AGENT_NICKNAME}}. Если {{AGENT_NICKNAME}} создал - прогоняет сам, но по жёсткому чеклисту без исключений.

---

## Как запускать

Определи режим по типу материала:

| Материал | Режим |
|----------|-------|
| MD + PDF + AGENT.md для платной группы | **A: Контент** |
| Репозиторий для GitHub | **B: GitHub** |
| Пост для Telegram канала | **C: Пост** |
| Скилл или агент | **D: Скилл/Агент** |
| Любая комбинация | Прогнать ВСЕ применимые режимы |

---

## Режим A: Контент для {{PAID_GROUP_NAME}}

### A1. Комплектность файлов
```
- [ ] MD-файл (инструкция для человека, 350-500 строк)
- [ ] PDF-файл (красиво свёрстанный, Arial шрифты, кириллица)
- [ ] AGENT.md (инструкция для агента, идемпотентные шаги)
- [ ] Пост-анонс для Telegram (отдельный файл или в пакете)
```

### A2. Стиль текста
Сверить с `skills/copywriter/references/voice-dictionary.md`:
```bash
# Автоматическая проверка запрещённых паттернов
FILE="путь_к_файлу"

# Длинные тире (должны быть дефисы с пробелами)
grep -n "—" "$FILE" && echo "❌ НАЙДЕНЫ длинные тире (—)! Заменить на дефис (-)" || echo "✅ Тире ок"

# AI-мусор
grep -niE "отличный вопрос|давайте рассмотрим|рад помочь|безусловно|является|данный подход|в рамках|на сегодняшний день|в целом|таким образом" "$FILE" && echo "❌ НАЙДЕН AI-мусор!" || echo "✅ AI-мусор не найден"

# Канцелярит
grep -niE "осуществлять|посредством|в связи с тем|на основании|в соответствии|надлежащим образом|вышеуказанн" "$FILE" && echo "❌ НАЙДЕН канцелярит!" || echo "✅ Канцелярит не найден"
```

Ручная проверка:
```
- [ ] Язык разговорный, как в мессенджере, не как в журнале
- [ ] Нет пустых фраз и воды
- [ ] Конкретика: числа, команды, примеры
- [ ] Дефис (-) вместо длинного тире (—) ВЕЗДЕ
- [ ] Нет "Отличный вопрос!", "Давайте рассмотрим", "является"
```

### A3. Формат PDF
Сверить с `skills/methodologist/references/pdf-design-standard.md`:
```
- [ ] A4, портрет, белый фон
- [ ] Поля: 25-30 мм бока, 20 мм верх, 25 мм низ
- [ ] Титульная: тёмный баннер (#3D4553), синяя линия (#4A90D9)
- [ ] Шрифт: Arial (НЕ DejaVu, НЕ Helvetica) - кириллица без квадратов
- [ ] Нумерация страниц
- [ ] Колонтитул с названием серии
- [ ] Текст не вылезает за границы
- [ ] Код в блоках читаемый (моноширинный шрифт, фон #F5F5F5)
```

### A4. Контент (стандарт методолога)
Сверить с `skills/methodologist/references/pdf-content-standard.md`:
```
- [ ] Структура: Зачем → Что делаем → Пошагово → Проверка → Troubleshooting
- [ ] Время выполнения указано (20-60 минут)
- [ ] Команды в блоках кода (copy-paste ready)
- [ ] Все команды проверены через --help на реальной системе
- [ ] Чеклист "всё работает" в конце
- [ ] Troubleshooting: минимум 3 типичные проблемы
```

### A5. AGENT.md (для агента подписчика)
```
- [ ] ШАГ 0 ОБЯЗАТЕЛЕН: "Просканируй текущую систему" (ОС, модель, существующие скиллы, структура папок)
- [ ] Шаги идемпотентные (можно запустить повторно без поломок)
- [ ] Перед каждым шагом: "Проверь, не настроено ли уже"
- [ ] НЕ перезаписывает существующие файлы без предупреждения
- [ ] НЕ удаляет и НЕ меняет чужие скиллы, кроны, конфиги
- [ ] Работает с ЛЮБОЙ моделью (Claude, GPT, Gemini, локальные)
- [ ] Работает на ЛЮБОЙ ОС (macOS, Linux, Windows/WSL)
- [ ] Нет объяснений "зачем" - только "что делать"
- [ ] Все пути относительные или с переменными ($HOME, $OPENCLAW_HOME)
- [ ] Нет hardcoded значений (порты, ID, пути, имена агентов)
- [ ] Если нужны зависимости - проверить наличие, предложить установку, НЕ ставить молча
- [ ] После установки: проверка что система работает как раньше + новый функционал
```

### A5b. Совместимость и безопасность установки
```

From AlekseiUL/heisenberg-team, MIT.

More from AlekseiUL/heisenberg-team