AI Agent Team
peterfei/ai-agent-teamВиртуальная команда AI-разработчиков: продакт-менеджер, фронтенд, бэкенд, QA, DevOps и техлид. Thread Manager с семантическим поиском, персистентной памятью и автоматическим Git-контролем версий.
Установка
claude mcp add thread-manager node "/YOURSELFPROJECTPATH/.claude/skills/thread-manager/dist/index.js"README
AI Agent Team
🚀 Профессиональная AI-команда разработки 24/7: продакт-менеджер, фронтенд-разработчик, бэкенд-разработчик, инженер по тестированию, DevOps-инженер, технический руководитель
💾 Thread Manager даёт AI память! Семантический поиск | Управление задачами-тредами | Полное восстановление контекста | Автоматический Git-контроль версий
⚡ Установка в 3 шага → Начните прямо сейчас!
🌟 Ключевые возможности и архитектура v2.0.1
🚀 Ключевые возможности
🌟 Основная ценность: обновление когнитивных способностей
Thread Manager v2.0.1 реализует многоуровневую архитектуру памяти, превращая простое управление диалогами в AI-систему памяти с когнитивными способностями:
- Повышение точности контекста на 30–50% — семантический поиск вместо хронологического
- Повторное использование знаний между тредами — AI обучается и накапливает опыт
- Скорость поиска в 10 раз выше — векторный индекс против полного сканирования таблицы
- Более естественное взаимодействие — AI «помнит» привычки и предпочтения пользователя
1. 🧠 Семантический поиск Thread Manager
- Запросы на естественном языке: забудьте о ключевых словах — AI понимает намерение и точно находит нужный диалог.
- Память через время: легко возвращайтесь к обсуждениям недельной давности без риска что-то забыть.
- Локальная векторная база данных: все сообщения векторизуются и хранятся локально — конфиденциальность данных и эффективный поиск гарантированы.
2. 📦 Встроенная модель и приоритет офлайн-режима
- Встроенная модель эмбеддингов: модель
Xenova/all-MiniLM-L6-v2поставляется в комплекте — загрузка из сети не требуется. - Готово к работе без настройки: установил — используй, 100% успешная установка без доступа к внешним сетям.
3. 🛠️ Оптимизация инициализации и миграции
- Автоматическая сборка: команда
initавтоматически компилирует TypeScript. - Миграция в один клик: скрипт
npm run migrateавтоматически векторизует старые данные.
🏗️ Обзор архитектуры
Thread Manager v2.0.1 вводит новый слой векторного поиска:
graph TD
User[Пользователь] -->|Запрос на естественном языке| Agent[Claude AI Ассистент]
Agent -->|Вызов инструмента| MCP[Thread Manager MCP Server]
subgraph "Thread Manager Core"
MCP -->|Разбор запроса| TM[Thread Manager]
TM -->|Семантический поиск| Search[Vector Search Engine]
TM -->|Добавление сообщения| MsgDAO[Messages DAO]
MsgDAO -->|Генерация вектора| Embed[Embedding Service]
Embed -->|Загрузка модели| LocalModel[📦 Локальная встроенная модель]
LocalModel -.->|Xenova/all-MiniLM-L6-v2| Embed
Search -->|Запрос| DB[(SQLite Database)]
MsgDAO -->|Сохранение| DB
end
DB -->|Возврат результатов| Search
Search -->|Список релевантных сообщений| TM
TM -->|Форматирование контекста| MCP
MCP -->|Точный ответ| Agent📦 Руководство по установке
Быстрая установка (3 шага)
⚠️ Важно: в v2.0.0 введена система памяти Thread Manager — для полноценной работы необходимо выполнить все 3 шага!
┌─────────────────────────────────────────────────┐
│ Шаг 1: npm install -g ai-agent-team │
│ ↓ Установка команды AI-агентов │
└─────────────────────────────────────────────────┘
↓
┌─────────────────────────────────────────────────┐
│ Шаг 2: ai-agent-team init │
│ ↓ Инициализация конфигурации (глобальная │
│ или для проекта) │
└─────────────────────────────────────────────────┘
↓
┌─────────────────────────────────────────────────┐
│ Шаг 3: claude mcp add thread-manager │
│ ↓ Включение MCP-сервера Thread Manager │
└─────────────────────────────────────────────────┘
↓
✅ Установка завершена!
Шаг 1: Установка AI Agent Team
npm install -g ai-agent-team
Шаг 2: Инициализация конфигурации ⭐ Обязательный шаг
Вариант A: Глобальная инициализация (рекомендуется — общая для всех проектов)
ai-agent-team init
Создаёт глобальную конфигурацию в ~/.claude/ — команда AI-агентов будет доступна во всех проектах.
Вариант B: Локальная инициализация проекта (изолированная конфигурация)
cd your-project
ai-agent-team initСоздаёт локальную конфигурацию в .claude/ проекта — доступна только в текущем проекте.
Шаг 3: Включение MCP-сервера Thread Manager ⭐ Ключевой шаг
claude mcp add thread-manager node "/YOURSELFPROJECTPATH/.claude/skills/thread-manager/dist/index.js"

Зачем это нужно?
- Thread Manager работает как MCP-сервер и обеспечивает персистентную память
- Настраивается один раз и работает постоянно
- Без этого шага команды
/threads,/pm-startи другие команды управления тредами будут недоступны
✅ Проверка установки
После перезапуска Claude Code выполните:
# 1. Просмотр всех тредов
/threads
# 2. Создание первого треда задачи
/pm-start "Моя первая задача"
# 3. Просмотр информации о текущем треде
/thread infoЕсли отображается список тредов — установка прошла успешно! 🎉
🎯 Сравнение двух способов инициализации
| Характеристика | Глобальная инициализация | Локальная инициализация проекта |
|---|---|---|
| Расположение конфигурации | ~/.claude/ | ./.claude/ |
| Область применения | Все проекты | Только текущий проект |
| Командная работа | Личное использование | Можно добавить в Git |
| Изоляция данных | Общие данные тредов | Независимые треды проекта |
| Рекомендуется для | Индивидуальных разработчиков | Командных проектов |
💡 Совет: в большинстве случаев рекомендуется глобальная инициализация — если только не требуется полная изоляция данных тредов между проектами.

❓ Часто задаваемые вопросы
Причина: MCP-сервер Thread Manager не включён.
Решение:
# 1. Настройте MCP-сервер
claude mcp add thread-manager node "/YOURSELFPROJECTPATH/.claude/skills/thread-manager/dist/index.js"
# 2. Перезапустите Claude Code
exit
claude
# 3. Проверьте
/threads| Характеристика | Глобальная инициализация | Локальная инициализация |
|---|---|---|
| Расположение конфигурации | ~/.claude/ | ./.claude/ |
| Данные тредов | Общие для всех проектов | Изолированные для проекта |
| Сценарий использования | Личная разработка | Командная работа |
Рекомендация: для личного использования — глобальная, для командных проектов — локальная.
# Способ 1: просмотр списка тредов
/threads
# Способ 2: просмотр текущего треда
/thread info
# Способ 3: создание тестового треда
/pm-start "Тестовый тред"Если все команды работают — Thread Manager функционирует нормально.
Да! Claude Code отдаёт приоритет локальной конфигурации проекта (./.claude/); если она отсутствует — используется глобальная (~/.claude/).
Это означает, что вы можете:
- Использовать глобальную конфигурацию как конфигурацию по умолчанию
- Для отдельных проектов задавать независимую конфигурацию
🧠 Thread Manager — система памяти AI-команды ⭐ Новое в v2.0.0
🎉 Обновление v2.0.1: семантический поиск и офлайн-модель
Теперь Thread Manager не только запоминает диалоги, но и понимает их!
- Семантический поиск: ищите историю на естественном языке («найди обсуждение логики авторизации»).
- Приоритет офлайн-режима: встроенная векторная модель, загрузка из сети не требуется, 100% успешная установка.
🚀 Ключевые возможности
💾 Персистентная память
- ✅ Семантический поиск по истории сообщений
- ✅ Постоянное сохранение диалогов
- ✅ Восстановление контекста в любой момент
- ✅ Параллельное управление несколькими задачами
🌿 Автоматическая интеграция с Git
- ✅ Автоматическое создание веток задач
- ✅ Отслеживание изменений файлов
- ✅ Статистический анализ кода
- ✅ Полный контроль версий
🎯 Быстрый запуск агентов
- ✅
/pm-start— проектирование продукта - ✅
/fe-start— фронтенд-разработка - ✅
/be-start— бэкенд-разработка - ✅
/qa-start— обеспечение качества
📊 Thread Manager vs нативный Claude
| Функция | Нативный Claude | Thread Manager | Улучшение |
|---|---|---|---|
| Память контекста | ❌ Теряется при перезапуске | ✅ Сохраняется постоянно | ∞ |
| Многозадачность | ❌ Один поток | ✅ Неограниченный параллелизм | 10x+ |
| Восстановление задач | ❌ Невозможно | ✅ Полное восстановление | Новое |
| Контроль версий | ⚠️ Ручной | ✅ Автоматический | 3x |
| Производительность | 100% | 200%+ | 2x |
🎮 Базовое использование
Создание треда задачи (автоматическая инициализация роли)
/pm-start "Проектирование функции корзины для интернет-магазина"
↓ Автоматически создаётся продуктовый тред
↓ AI сразу анализирует требования в роли продакт-менеджера
↓ История диалога сохраняется постоянноПараллельное управление несколькими задачами
/threads # Просмотр всех активных тредов
/thread switch 2 # Переключение на тред #2
/thread info # Просмотр информации о текущем тредеСемантический поиск истории
# Поиск на естественном языке
"Найди наше обсуждение логики авторизации"
"Какие решения по архитектуре базы данных мы принимали?"
"Покажи все баги, связанные с производительностью"👥 Команда AI-агентов
Роли и команды запуска
| Роль | Команда запуска | Основные обязанности |
|---|---|---|
| 🎯 Продакт-менеджер | /pm-start | Анализ требований, планирование итераций, управление продуктом |
| 🎨 Фронтенд-разработчик | /fe-start | UI/UX, компоненты, оптимизация производительности |
| ⚙️ Бэкенд-разработчик | /be-start | API, база данных, архитектура системы |
| 🔍 QA-инженер | /qa-start | Тест-кейсы, автоматизация тестирования, контроль качества |
| 🚀 DevOps-инженер | /devops-start | CI/CD, деплой, мониторинг |
| 👑 Технический руководитель | /lead-start | Архитектурные решения, ревью кода, техническое руководство |
Поддержка команд на русском и английском языках
Все агенты поддерживают команды как на русском, так и на английском языке:
# Английский
/pm-start "Design user authentication system"
# Русский
/pm-start "Разработать систему аутентификации пользователей"📋 Полный список команд
Команды управления тредами
| Команда | Описание |
|---|---|
/threads | Просмотр всех тредов |
/thread info | Информация о текущем треде |
/thread switch <id> | Переключение на тред |
/thread close | Закрытие текущего треда |
/thread delete <id> | Удаление треда |
Команды запуска агентов
| Команда | Агент | Описание |
|---|---|---|
/pm-start <задача> | Продакт-менеджер | Запуск анализа требований |
/fe-start <задача> | Фронтенд-разработчик | Запуск фронтенд-разработки |
/be-start <задача> | Бэкенд-разработчик | Запуск бэкенд-разработки |
/qa-start <задача> | QA-инженер | Запуск тестирования |
/devops-start <задача> | DevOps-инженер | Запуск DevOps-задач |
/lead-start <задача> | Технический руководитель | Запуск технического руководства |
🔧 Расширенная конфигурация
Структура директорий
~/.claude/ # Глобальная конфигурация
├── CLAUDE.md # Глобальные инструкции
└── skills/
├── thread-manager/ # Thread Manager MCP-сервер
│ ├── dist/ # Скомпилированный код
│ │ └── index.js # Точка входа MCP-сервера
│ ├── src/ # Исходный код TypeScript
│ ├── models/ # Встроенные модели эмбеддингов
│ └── package.json
├── pm/ # Навыки продакт-менеджера
├── frontend/ # Навыки фронтенд-разработчика
├── backend/ # Навыки бэкенд-разработчика
├── qa/ # Навыки QA-инженера
├── devops/ # Навыки DevOps-инженера
└── lead/ # Навыки технического руководителя
Обновление до последней версии
# Обновление пакета
npm update -g ai-agent-team
# Повторная инициализация (сохраняет существующие данные)
ai-agent-team init📄 Лицензия
Распространяется по лицензии MIT. Подробности см. в файле LICENSE.
Если этот проект оказался полезным, поставьте ⭐ на GitHub!