Skip to content

About

A set of skills, MCP, and agency settings for high-quality agency development

Resources

Stars

3 stars

Watchers

0 watching

Forks

Latest commit

 

History

13 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 

Repository files navigation

agents-flow — Human + Agents: Plan, Build, Review, Commit

agents-flow

GitHub stars GitHub forks Last commit Руководство для агента

Скиллы для AI-агентов, которые пишут, исправляют и проверяют код, а также готовят инструкции для работы с репозиторием. Они задают единые правила стиля и помогают сохранять поведение программы при изменениях. Языковые скиллы основаны на Google Style Guides с оговорками для реальных проектов. Docker-скилл содержит отдельные рекомендации по сборке образов.

Установите только то, что нужно для вашего стека. Каждый скилл работает отдельно.

Установка через агента

Скопируйте этот промпт в своего coding-агента:

Прочитай руководство по установке и использованию agents-flow:
https://raw.githubusercontent.com/EgorYolkin/agents-flow/main/docs/GUIDE.md

Посмотри, какие скиллы есть в репозитории. Кратко объясни их назначение
и спроси, какие мне нужны. Можешь предложить набор под мой проект,
но дождись моего выбора перед установкой.

Определи, каким агентом или harness я пользуюсь. Если это непонятно,
уточни. Согласуй установку для одного проекта или для всех проектов.

Проверь эффективный лимит контекста текущего harness. Если он больше
250 000 токенов, по актуальной официальной документации установи лимит
250 000 и автоматическую компактизацию на 80% (200 000 токенов).
Следуй GUIDE.md: проверь применение, а неподдерживаемые настройки
или необходимость перезапуска укажи явно.

Установи только выбранные скиллы по GUIDE.md, сохрани существующие
настройки и локальные изменения. Проверь, что агент видит установленные
скиллы, и объясни, как ими пользоваться. Не устанавливай дополнительные
инструменты и не запускай форматирование проекта в рамках установки.

Агент предложит подходящие скиллы, уточнит место установки и проверит результат. Если репозиторий уже скачан, вместо URL можно указать локальный docs/GUIDE.md.

Доступные скиллы

Скилл Для чего
Git Ветки задач, worktrees, изучение истории и осмысленные коммиты без захвата чужих изменений
Init Подготовка проекта для агента: архитектура, команды, проверки, AGENTS.md, Git и проектный GIT_WORKFLOW.md
Dockerfile Dockerfile и .dockerignore: сборка, кэширование, размер образа и безопасность
Python Google PyGuide: импорты, типы, docstrings и ответственность функций с сохранением API
HTML/CSS Разметка, стили и шаблоны с сохранением доступности и используемых селекторов
Shell Bash и sh: quoting, аргументы, обработка ошибок и совместимость
TypeScript TypeScript и TSX: типы, импорты, именование и читаемость
Swift Swift: оформление, API, обработка optional и документация
Vim script Vimscript: читаемость, mappings и совместимость с версиями редактора
Markdown README, документация и инструкции: структура, ссылки и примеры

Как пользоваться

Сформулируйте задачу и при необходимости назовите скилл явно:

Используй git-guide при работе над задачей. Изучи релевантную историю,
выбери ветку и изоляцию, сохраняй законченные шаги осмысленными коммитами.
Не включай чужие изменения. Push и merge пока не выполняй.
Используй init. Подготовь проект к работе агента: изучи архитектуру,
команды, проверки и Git-соглашения. Создай или аккуратно обнови AGENTS.md
с заголовком Repository Guidelines и проектный GIT_WORKFLOW.md.
Если Git отсутствует, инициализируй локальный репозиторий. Сохрани
существующие правила и пользовательские изменения; не публикуй код.

По умолчанию init изучает и сохраняет Git-процесс проекта, а при первом запуске объясняет пользователю работу с Git. В пакете есть только пример оформления workflow; рабочий GIT_WORKFLOW.md создаётся в целевом проекте и доступен для изменения. Запрос «инициализируй с моими Git-правилами» требует загрузить актуальный скилл git-guide. Если harness его не находит, агент сообщает об этом, а не придумывает пользовательские правила.

Используй shell-styleguide. Проверь scripts/deploy.sh и объясни замечания.
Пока ничего не меняй.
Используй python-styleguide. Исправь стиль в изменённых Python-файлах,
сохрани публичные API и совместимость с поддерживаемыми версиями Python.
Проверь ответственность функций и запусти доступные проверки проекта.
Используй typescript-styleguide. Исправь стиль в изменённых файлах,
сохрани публичные API и поведение. Запусти доступные проверки проекта.
Используй dockerfile-styleguide. Проверь Dockerfile и .dockerignore,
затем исправь найденные проблемы в рамках текущего приложения.

Автоматическое подключение зависит от вашего агента. Если он не выбрал скилл, попросите применить его явно. Для смешанной задачи можно использовать несколько скиллов: например, Docker и Shell для образа с entrypoint-скриптом.

Python-скилл также задаёт оформление функций и классов: """ на отдельных строках, пустая строка после docstring и между смысловыми блоками. Связанные операции и дополняющие их if остаются рядом, без лишних пустых строк.

Что ожидать

Скиллы учитывают договорённости проекта и ограничения совместимости. Запрос «проверь» предполагает замечания; запрос «исправь» — изменения в указанной области. Они не должны запускать массовое переформатирование ради небольшого исправления.

Скилл даёт агенту процедуру работы. Проверка поведения по-прежнему требует тестов, а обязательные ограничения — подходящих проверок проекта и CI.

Источники, версии руководств и атрибуция приведены в references/ соответствующих скиллов. Порядок установки, обновления и применения описан в руководстве для агента.

About

A set of skills, MCP, and agency settings for high-quality agency development

Resources

Stars

3 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors