---
name: task-clarity
description: Activate this skill whenever the user sends a raw, vague, or ambiguous request — especially short messages like "сделай бота", "разберись с сайтом", "нужно что-то для воронки", "помоги с деплоем", "запусти это". Also activate when the user pastes a wall of text without a clear goal, or mixes multiple tasks in one message. This skill MUST run before any code, tool calls, or multi-step execution. It transforms raw input into a structured task contract, confirms with the user, then proceeds to execution. Never skip this skill when intent is unclear — misunderstanding a task and executing the wrong thing wastes far more time than 30 seconds of clarification.
---

# Task Clarity — Скилл формирования агентского запроса

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

Вэл часто пишет сырыми мыслями: короткими, нечёткими, или сразу несколько задач в одном сообщении.
Этот скилл превращает сырой инпут в структурированный контракт задачи **до** начала выполнения.

---

## Когда применять

Применяй **всегда**, если выполняется хотя бы одно условие:

- Сообщение < 15 слов без явной цели
- Не ясен ожидаемый результат (файл? код? текст? деплой?)
- Смешано 2+ задачи
- Есть слова: "разберись", "сделай что-нибудь", "надо бы", "посмотри", "там что-то", "как-то так"
- Нет контекста: что сломано, где, на каком проекте

**Не применяй** если:

- Запрос конкретный: "добавь кнопку в `bot_v2.py` строка 42"
- Простой фактический вопрос
- Продолжение уже активной задачи в этом же диалоге
- Задача идёт серией (сразу после "давай" — не нужно каждый раз делать контракт)

---

## Алгоритм

### Шаг 1 — Извлечь намерение

Прочитай сообщение и определи:

```
ПРОЕКТ:    [atlanticsail.net / CaptainAtlanticBot / GoClaw / Hermes / другое]
ДЕЙСТВИЕ:  [создать / исправить / улучшить / задеплоить / разобраться / написать]
РЕЗУЛЬТАТ: [что должно существовать/работать после]
КОНТЕКСТ:  [что есть сейчас, что не работает]
```

Если что-то из этого неизвестно — переходи к Шагу 2.
Если всё ясно — сразу к Шагу 3.

---

### Шаг 2 — Задать ОДИН уточняющий вопрос

Не спрашивай всё сразу. Один вопрос — самый блокирующий.

Формат:
```
🎯 Уточни: [один конкретный вопрос]
→ [вариант A]
→ [вариант B]
→ [вариант C — другое, опиши]
```

После ответа — переходи к Шагу 3.

---

### Шаг 3 — Сформировать Task Contract

Собери и покажи структуру:

```
━━━━━━━━━━━━━━━━━━━━━━━━━━
📋 ЗАДАЧА: [название одной строкой]
━━━━━━━━━━━━━━━━━━━━━━━━━━
📁 Проект:    [название]
🎯 Цель:      [что должно работать/существовать]
📥 Вход:      [что есть сейчас / откуда берём]
📤 Результат: [конкретный артефакт — файл/код/деплой/текст]
⛔ Не делаем: [что явно за рамками]
⚡ Первый шаг: [самое маленькое действие с которого начнём]
━━━━━━━━━━━━━━━━━━━━━━━━━━
Давай? → [Да / Скорректируй]
```

---

### Шаг 4 — Ждать подтверждения

- Получил "да" / "давай" / "погнали" → выполняй
- Получил правку → обнови контракт, покажи снова
- Получил "стоп" / "отмена" → завершить, ничего не делать

**Никогда не начинать выполнение без явного "давай".**

---

## Правила

1. **Архитектура перед кодом** — сначала контракт, потом любые инструменты
2. **Один проект за раз** — если в запросе 2+ проекта, спроси какой первый
3. **Не угадывай** — лучше один вопрос, чем неверное выполнение
4. **Контракт — не формальность** — если после написания контракта стало видно что задача неправильная → скажи об этом
5. **Приоритет Вэла**: atlanticsail.net → CaptainAtlanticBot → остальное. Если задача не из топ-2 а сайт ещё не закрыт — мягко спроси: "Сайт ещё в работе — это точно сейчас?"

---

## Примеры

### Сырой инпут → Контракт

**Вход:** `"надо разобраться с ботом"`

**Контракт:**
```
🎯 Уточни: с каким именно и что не работает?
→ @CaptainAtlanticBot — не отвечает / глючит
→ sailingmanager_bot — нужна новая фича
→ другой бот — опиши
```

---

**Вход:** `"хочу добавить страницу на сайт"`

**Контракт:**
```
━━━━━━━━━━━━━━━━━━━━━━━━━━
📋 ЗАДАЧА: Страница Черногория на atlanticsail.net
━━━━━━━━━━━━━━━━━━━━━━━━━━
📁 Проект:    atlanticsail.net (GitHub Pages)
🎯 Цель:      Новая страница 
📥 Вход:      Существующий стиль сайта
📤 Результат: Готовый HTML-файл в стиле сайта + добавлен в sitemap
⛔ Не делаем: Правки других страниц, новые фото (только существующие)
⚡ Первый шаг: Показать структуру секций страницы на согласование
━━━━━━━━━━━━━━━━━━━━━━━━━━
Давай? → [Да / Скорректируй]
```

---

**Вход:** `"деплой"`

**Контракт:**
```
🎯 Уточни: что деплоим?
→ atlanticsail.net → GitHub Pages через ./deploy.sh
→ Telegram-бот → Railway (какой проект?)
→ Hermes Agent → Railway (финализировать railway-config.yaml?)
```

---

## Интеграция с War Room

Если задача пришла от другого агента (A1/A2/A3/A4) — контракт не нужен,
у задачи уже есть структура. Применяй скилл только для сообщений от Вэла напрямую.
