GSD Agent Intelligence & Skills Repository

Централизованное хранилище эталонных правил, навыков и конфигураций для Antigravity и других Agent-First IDE (Cursor, Windsurf и др.). Эти настройки обучают ИИ-агента следовать методологии GSD (Get Shit Done), соблюдать стандарты безопасности и эффективно использовать токены.

🏗 Структура репозитория

skills/
├── templates/
│   ├── global/         # Общесистемные настройки IDE
│   │   └── GEMINI.md   # Глобальный GSD-протокол (Identity, Token Economy)
│   ├── rules/          # Директивы поведения и стандарты кода
│   │   ├── core-standards.md   # Основные стандарты Python/Bitrix/TS
│   │   ├── gsd-efficiency.md   # Оптимизация контекста и Spec-Driven Dev
│   │   └── git-standards.md    # Правила VC и Conventional Commits
│   ├── skills/         # Дополнительные навыки агента (@команды)
│   │   ├── gsd-minimize.md     # Навык @minimize для сброса контекста
│   │   ├── devops-orchestrator.md # Навык @devops для Docker/CI-CD
│   │   ├── tg-bot-helper.md    # Навык @tg-bot для разработки ботов
│   │   └── openai-docs/        # Skill для работы с официальной документацией OpenAI
│   │       ├── SKILL.md
│   │       ├── agents/
│   │       ├── assets/
│   │       ├── references/
│   │       └── scripts/
│   ├── guardrails.md   # Правила безопасности и защиты данных
│   └── memory.md       # Карта проекта и технический стек
├── install.sh          # Скрипт установки для Linux / macOS
└── install.ps1         # Скрипт установки для Windows (PowerShell)

🚀 Быстрое развертывание

Скрипт установки выполняет две важные задачи:

1. Глобально: Настраивает саму IDE Antigravity, скачивая GEMINI.md в системную директорию настроек (напр. %APPDATA%\Antigravity).
2. Локально: Инициализирует окружение агента в текущем проекте, создавая папку .agent/ с актуальными правилами.
3. Безопасное обновление: Если файл уже существует и содержимое совпадает, он пропускается. Если содержимое отличается, существующий файл не затирается: новая версия сохраняется рядом как *.incoming для ручного diff/merge.
4. Codex/GSD tooling: Проверяет версию GSD для Codex и при необходимости обновляет через npx get-shit-done-cc@latest --codex --global.
5. uv tooling: Если uvx отсутствует, ставит uv через официальный standalone installer Astral, чтобы code-review-graph мог использовать рекомендуемый uvx.
6. Code Review Graph: При наличии uvx, уже установленного code-review-graph или Python 3.10+ устанавливает и настраивает code-review-graph для --platform codex. Если MCP-секция уже есть в Codex config, повторная настройка пропускается. Опционально может сразу построить граф текущего проекта и запустить daemon/watch для автообновления.

Windows (PowerShell)

Выполните в корне вашего проекта:

Invoke-Expression (Invoke-WebRequest -Uri "https://raw.githubusercontent.com/ex-ru/skills/main/install.ps1" -UseBasicParsing).Content

Опциональные параметры:

.\install.ps1 -SkipGsdUpdate
.\install.ps1 -SkipUvInstall
.\install.ps1 -SkipCodeReviewGraph
.\install.ps1 -BuildCodeReviewGraph
.\install.ps1 -StartCodeReviewGraphDaemon
.\install.ps1 -StartCodeReviewGraphDaemon -CodeReviewGraphAlias my-project

Linux / macOS / WSL

Выполните в корне вашего проекта:

curl -s https://raw.githubusercontent.com/ex-ru/skills/main/install.sh | bash

Опциональные параметры:

./install.sh --skip-gsd-update
./install.sh --skip-uv-install
./install.sh --skip-code-review-graph
./install.sh --build-code-review-graph
./install.sh --start-code-review-graph-daemon
./install.sh --start-code-review-graph-daemon --code-review-graph-alias my-project

🔌 Интеграции для Antigravity + Codex Plugin

OpenAI Docs

В templates/skills/openai-docs/ добавлен skill-пакет из официального репозитория OpenAI Skills: https://github.com/openai/skills/tree/main/skills/.curated/openai-docs

В пакете оставлены:

• SKILL.md с правилами поиска по официальной документации OpenAI.
• agents/openai.yaml с декларацией MCP-зависимости openaiDeveloperDocs.
• references/ с fallback-материалами для выбора модели, апгрейдов и prompting.
• scripts/resolve-latest-model-info.js для определения актуальных guide-ссылок.

Для Antigravity/Codex Plugin инструкция адаптирована: skill больше не пытается сам запускать codex mcp add изнутри IDE runtime. Если MCP-инструменты не доступны, агент использует официальные URL OpenAI и локальные fallback references, а MCP-зависимость остается декларативной в agents/openai.yaml.

code-review-graph

code-review-graph полезен для работы с Codex Plugin в Antigravity, особенно на средних и больших репозиториях: он строит Tree-sitter/SQLite граф кода, отдает контекст через MCP, умеет анализировать blast radius изменений и поддерживает Codex/Antigravity по README проекта: https://github.com/tirth8205/code-review-graph/blob/main/README.md

Практический вывод:

• Полезно: снижает лишнее чтение кода агентом, дает MCP tools для review/debug/onboarding и slash-команды /code-review-graph:*.
• Ограничения: для маленьких single-file изменений контекст графа может быть больше исходного файла; ranking/search и flow detection в README обозначены как неидеальные.
• Требования: Python 3.10+; лучше uvx, поэтому скрипты сначала ставят uv через официальный installer Astral, а затем умеют fallback на установленный CLI или python -m pip install --user.

Скрипты запускают:

code-review-graph install --platform codex

Если нужно сразу построить граф текущего проекта, добавьте -BuildCodeReviewGraph или --build-code-review-graph.

Если нужно держать граф актуальным автоматически, включите daemon/watch-режим:

PowerShell:

.\install.ps1 -StartCodeReviewGraphDaemon

Bash:

./install.sh --start-code-review-graph-daemon

Этот режим:

• строит граф текущего проекта, если он еще не создан;
• регистрирует текущую папку в daemon/watch-конфиге с alias по имени директории;
• запускает code-review-graph daemon start;
• показывает code-review-graph daemon status.

Повторный запуск безопасен: если code-review-graph уже прописан в ~/.codex/config.toml, скрипт не вызывает повторную настройку Codex; если текущий проект уже есть в ~/.code-review-graph/watch.toml, он не добавляется в daemon/watch повторно.

Для ручного управления после установки:

code-review-graph daemon status
code-review-graph daemon stop
code-review-graph daemon start

GSD

GSD обновлен в текущем Codex-окружении с 1.30.0 до 1.38.5 через:

npx -y get-shit-done-cc@latest --codex --global

Во время обновления GSD сохранил локальные патчи в ~/.codex/gsd-local-patches/. Если они нужны, их нужно сливать отдельно через $gsd-reapply-patches или вручную. Установочные скрипты теперь проверяют ~/.codex/get-shit-done/VERSION против npm view get-shit-done-cc version и запускают обновление только при расхождении версий.

Режим сопровождения репозитория skills

Для публикации изменений в самом репозитории ex-ru/skills можно включить отдельный шаг коммита и пуша. Этот режим намеренно выключен по умолчанию и сработает только если origin указывает на ex-ru/skills.

PowerShell:

.\install.ps1 -CommitAndPush -CommitMessage "feat(skills): add new Antigravity skills"

Bash:

./install.sh --commit-and-push --commit-message "feat(skills): add new Antigravity skills"

🛠 Стандарты разработки

При работе с этим репозиторием придерживайтесь следующих правил:

1. Commit Messages: Используйте Conventional Commits (напр. feat(ui): add dark mode).
2. Branching: Не коммитьте напрямую в main. Создавайте ветки feat/... или fix/....
3. Atomic Focus: Один коммит — одна атомарная задача. Используйте навык @minimize перед фиксацией изменений.

🛠 Разработка и внесение изменений

Если вы хотите добавить новое правило или навык в этот репозиторий:

1. Источник истины: Все мастер-шаблоны хранятся в папке templates/. Редактируйте файлы именно там.
2. Локальное тестирование: Директория .agent/ добавлена в .gitignore. Она может появиться, если вы запустите install.ps1 внутри этого репозитория, но её не нужно коммитить.
3. Обновление скриптов: При добавлении новых файлов в templates/ не забудьте обновить install.ps1 и install.sh, чтобы они включали новые файлы в процесс установки.

🔒 Безопасность

Этот репозиторий содержит guardrails.md, который запрещает агенту логировать чувствительные данные (API ключи, PII) и вносить изменения в защищенные системные директории (напр. /bitrix/ core).

---

Maintained by ex-ru