Правила, воркфлоу и хуки

Настройка поведения AI через правила проекта, воркфлоу и хуки

Правила (Rules)

Правила — это инструкции для AI, которые действуют на весь проект. Они задают стиль кода, архитектурные решения, ограничения.

Где хранятся

Создайте файл .skycoderules (или директорию .skycoderules/ с несколькими файлами правил) в корне проекта.

Глобальные правила (для всех проектов) хранятся в ~/Documents/Skycode/Rules/.

Пример

- Используй TypeScript
- Компоненты в src/components/
- Стиль: Tailwind CSS
- Не добавляй console.log в продакшн-код
- Тесты рядом с файлами (*.test.ts)

Управление

Правила можно включать/выключать через панель управления: нажмите иконку правил в чате → вкладка «Правила».

Skycode автоматически подхватывает изменения в файлах правил при каждом новом сообщении.

Воркфлоу (Workflows)

Воркфлоу — это заранее написанные последовательности инструкций, которые можно вызвать командой /workflow-name в чате.

Где хранятся

.skycoderules/workflows/ — каждый файл = один воркфлоу.

Глобальные воркфлоу: ~/Documents/Skycode/Workflows/.

Пример

Файл .skycoderules/workflows/new-component:

1. Создай компонент React в src/components/
2. Добавь типы Props
3. Напиши тест рядом (*.test.tsx)
4. Экспортируй из index.ts

Вызов

Напишите в чате: /new-component ButtonGroup — AI выполнит все шаги.

Управление

Воркфлоу можно включать/выключать через панель: иконка правил → вкладка «Воркфлоу».

Хуки (Hooks)

Хуки — это скрипты, которые автоматически запускаются при определённых событиях AI.

Где хранятся

.skycoderules/hooks/ — каждый файл = один хук. Имя файла = имя события.

Глобальные хуки: ~/Documents/Skycode/Hooks/.

Доступные события

Событие	Когда срабатывает
PreToolUse	Перед выполнением инструмента AI
PostToolUse	После выполнения инструмента AI
UserPromptSubmit	При отправке пользователем сообщения
TaskStart	При начале новой задачи
TaskResume	При возобновлении задачи
TaskCancel	При отмене задачи
TaskComplete	При завершении задачи
PreCompact	Перед сжатием контекста

Пример

Файл .skycoderules/hooks/PostToolUse:

#!/bin/bash
# Запустить линтер после каждого действия AI
cd "$WORKSPACE_ROOT"
npm run lint --fix 2>/dev/null
echo '{"cancel": false}'

Хук получает JSON на stdin и должен вернуть JSON на stdout:

{
  "cancel": false,
  "contextModification": "Опциональный контекст для AI",
  "errorMessage": ""
}

cancel: true — отменяет текущее действие
contextModification — добавляет текст в контекст AI (макс. 50 КБ)
Таймаут выполнения: 30 секунд

Управление

Хуки можно включать/выключать через панель: иконка правил → вкладка «Хуки».

Windows: на Windows хуки работают через shell. Файл хука должен быть без расширения (как в git hooks).