.agents
Weaverse/.agentsНабор workflow-команд, специализированных скиллов и правил кодирования для AI-инструментов. Подходит для Claude Code и других ассистентов с поддержкой markdown-конфигурации. Ускоряет ежедневную разработку.
Установка
git clone https://github.com/Weaverse/.agents.gitREADME
.agents
Скиллы, команды и правила для AI-инструментов разработки — используются ежедневно для повышения продуктивности.
Репозиторий содержит workflow-команды, специализированные скиллы, правила кодирования и системные хуки, совместимые с любым AI-ассистентом, поддерживающим конфигурацию на основе markdown.
📦 Содержимое
.agents/
├── commands/ # 11 команд автоматизации workflow
├── skills/ # 4 предметно-ориентированных скилла
├── rules/ # 5 правил соглашений по коду
├── claude-code-hooks.json # Конфигурация хуков (специфично для Claude Code)
├── claude-code-notifier.sh # Кроссплатформенный скрипт уведомлений
└── statusline.sh # Кастомная строка статуса для терминального UI Claude Code
🚀 Быстрый старт
Вариант 1: Клонировать весь репозиторий
cd ~
git clone git@github.com:Weaverse/.agents.git
# Создать символические ссылки в директорию конфигурации AI-инструмента
# Для Claude Code:
ln -s ~/.agents/commands ~/.claude/commands
ln -s ~/.agents/skills ~/.claude/skills
ln -s ~/.agents/rules ~/.claude/rulesВариант 2: Скопировать отдельные файлы
- Откройте папки
commands/,skills/илиrules/ - Скопируйте нужные файлы в директорию конфигурации вашего AI-инструмента
⚡ Workflow-команды
Команды автоматизации для типовых задач разработки:
| Команда | Описание |
|---|---|
| work | Взять задачу из GitHub issue — получить контекст, создать ветку, сформировать план спецификации и при необходимости открыть черновик PR |
| create-task | Создать GitHub issue с полными метаданными и опциональной интеграцией с project board |
| create-pr | Создать pull request с AI-сгенерированным описанием |
| fix-pr | Исправить замечания из ревью PR |
| review-changes | Проверить незакоммиченные изменения перед отправкой |
| review-code | Углублённый анализ качества кода |
| format | Автоформатирование кода и исправление ошибок TypeScript |
| handoff | Сформировать сводку контекста для передачи задачи команде |
| explain | Объяснить последние изменения в коде простыми словами для junior-разработчиков |
| ship | Создать release PR, обновить версию и подготовить черновик GitHub release |
| ultrathink | Режим глубокого рассуждения для сложных задач |
🎯 Специализированные скиллы
Предметно-ориентированные процедуры для сложных задач:
| Скилл | Описание |
|---|---|
| commit | Коммит изменений с качественными сообщениями, группировка связанных файлов в отдельные коммиты |
| code-review | Комплексный аудит кода — мёртвый код, дублирования, паттерны, баги |
| feature-plan | Детальное планирование реализации перед написанием кода |
| frontend-design | Создание самобытных UI-компонентов production-уровня |
📏 Правила кодирования
Чёткие соглашения, применяемые в команде:
| Правило | Описание |
|---|---|
| coding | Именование, стилизация и общие стандарты кодирования |
| commit | Соглашения по сообщениям коммитов |
| communication | Как AI должен обрабатывать вопросы и утверждения |
| never-auto-commit | Запрет автоматических коммитов от AI-инструментов |
| spec-driven-development | Писать спецификации до кода |
📊 Строка статуса
statusline.sh — кастомный скрипт строки статуса для терминального UI Claude Code. Отображает:
- Статистику сессии — продолжительность, стоимость и использование токенов
- Активную модель — сокращённое название (например,
Sonnet 4.5) - Рабочую директорию — последние два сегмента пути
- Статус Git — текущая ветка + индикатор чистоты (
✓) или наличия изменений (✗)
Настройка (Claude Code):
ln -s ~/.agents/statusline.sh ~/.claude/statusline.sh
Затем добавьте в настройки Claude Code:
{
"statusCommand": "~/.claude/statusline.sh"
}🔔 Системные хуки
Включённые claude-code-hooks.json и claude-code-notifier.sh обеспечивают системные уведомления для:
- Начала/завершения сессии
- Завершения задачи
- Кастомных оповещений
Кроссплатформенная поддержка: macOS, Linux, Windows (PowerShell).
Примечание: Хуки в настоящее время специфичны для Claude Code. Вклад для других инструментов приветствуется.
🛠️ Разработка
См. AGENTS.md для:
- Команд валидации
- Руководства по стилю кода
- Требований к frontmatter
- Чеклиста качества
🤝 Участие в проекте
Вклад приветствуется! При добавлении новых команд/скиллов:
- Следуйте соглашению об именовании:
kebab-case.md - Добавляйте корректный YAML frontmatter
- Включайте 2-3 реалистичных примера использования
- Тестируйте вручную в вашем AI-инструменте
- Обновляйте соответствующие разделы README
📝 Лицензия
MIT
Создано Weaverse — расширяем возможности разработчиков с помощью AI-улучшенных workflow.