AWRSHIFT
awrshift/skill-awrshiftФреймворк для AI-агентов, который заставляет агента исследовать задачу, определять метрики успеха и проверять факты до начала реализации. Контрольные точки на каждом этапе, изолированная песочница для экспериментов.
Установка
git clone https://github.com/awrshift/skill-awrshift.gitREADME
AWRSHIFT v2
Адаптивный фреймворк решений для AI-агентов. Контрольные точки пользователя на каждом этапе.
Работает с любым AI-ассистентом для написания кода, поддерживающим Agent Skills
Зачем это нужно
AI-агенты сразу бросаются к реализации. Большинство ошибок возникает из-за того, что строится не то, что нужно. AWRSHIFT заставляет агента исследовать задачу, определять метрики, проверять факты и тестировать в песочнице — всё это до того, как будет затронут основной проект. Единый динамический поток адаптируется к любой сложности задачи.
Что нового в v2
| v1.0 | v2.0 |
|---|---|
| 3 режима (Quick/Standard/Scientific) | 1 динамический поток — глубина адаптируется на каждом этапе |
| Вопросы в текстовом виде | AskUserQuestion — структурированный выбор A/B/C/D на каждой контрольной точке |
| Нет этапа метрик | EVALUATE-DESIGN — обязательные критерии успеха до планирования |
| Проверка фактов только в Scientific | FACTCHECK — обязателен для всех режимов |
| Нет правил для песочницы | 10 правил безопасности — песочница для экспериментов изолирована от основного проекта |
| Нет шлюза перед реализацией | Двойной шлюз — DECIDE(GO) + предпросмотр файл за файлом до изменения основного проекта |
Как это работает
Один поток. Пользователь управляет глубиной.
IDENTIFY → RESEARCH → EVALUATE-DESIGN → HYPOTHESIZE → PLAN → FACTCHECK → TEST → DECIDE → [IMPLEMENT]
При каждом переходе между этапами агент:
- Сообщает, что было сделано
- Объясняет, что произойдёт дальше
- Предлагает выбор (A/B/C/D или собственное направление)
Вы всегда контролируете процесс. Агент никогда не действует молча.
Быстрая установка
Claude Code:
mkdir -p .claude/skills/awrshift
curl -sL https://raw.githubusercontent.com/awrshift/skill-awrshift/main/SKILL.md \
-o .claude/skills/awrshift/SKILL.mdИспользование
| Вы говорите | AWRSHIFT делает |
|---|---|
| «Давай разберём это» | Запускает IDENTIFY — задаёт структурированные вопросы по одному |
| «Сначала исследуй» | Этап RESEARCH — генерирует вопросы, просит подтвердить, запускает агентов |
| «Сравни подходы» | HYPOTHESIZE — называет варианты, представляет сравнительную таблицу |
| «Какие метрики использовать?» | EVALUATE-DESIGN — предлагает измеримые критерии успеха |
| «Проверь этот план» | FACTCHECK — верифицирует план по исходному контексту + опционально Gemini |
| «Эксперимент по [теме]» | Создаёт папку эксперимента, запускает полный поток |
Структура эксперимента
Каждый эксперимент создаёт постоянную документацию в вашем проекте:
experiments/{NNN}-{short-name}/
├── PLAN.md ← Статус, этапы, метрики, решения
├── research/
│ └── 01-{topic}.md ← Результаты агента
├── factcheck.md ← Результаты верификации
└── [artifacts] ← Код, конфиги, выходные данные
Безопасность песочницы
Во время экспериментов агент НИКОГДА не изменяет файлы основного проекта:
- Вся работа происходит в папке
experiments/ - Файлы основного проекта доступны только для чтения (для контекста)
- Только после DECIDE(GO) + явного подтверждения → изменения предлагаются в основной проект
- Вы видите точный список файлов до любой модификации
Интеграция
| Скилл | Когда | Назначение |
|---|---|---|
| brainstorm | Этап HYPOTHESIZE | Мультимодельный брейнсторминг (Claude × Gemini) |
| gemini | Этап FACTCHECK | Кросс-модельная верификация |
Оба опциональны. Фреймворк работает самостоятельно.
Ключевые принципы
- Пользователь в контуре — AskUserQuestion при каждом переходе между этапами
- Метрики до планирования — определяй критерии успеха до начала разработки
- Проверка фактов до тестирования — верифицируй план по доказательствам
- Сначала песочница — тестируй в
experiments/, реализуй позже - Решения на основе данных — GO/NO-GO с измеренными метриками
Совместимость
| Платформа | Установка |
|---|---|
| Claude Code | Скопируй SKILL.md в .claude/skills/awrshift/ |
| Codex CLI | Скопируй SKILL.md в .openai/skills/awrshift/ |
| Gemini CLI | Скопируй SKILL.md в .gemini/skills/awrshift/ |
| Cursor | Скопируй SKILL.md в .cursor/skills/awrshift/ |
Часть экосистемы AWRSHIFT
- claude-starter-kit — готовая структура проекта с памятью, хуками и скиллами
- skill-brainstorm — трёхраундовый состязательный диалог Claude × Gemini
- skill-gemini — инструментарий Gemini для второго мнения, изображений и диаграмм
Лицензия
MIT — подробности в LICENSE.