Claude Info
AI и агенты

AI Agent Team

peterfei/ai-agent-team

Виртуальная команда AI-разработчиков: продакт-менеджер, фронтенд, бэкенд, QA, DevOps и техлид. Thread Manager с семантическим поиском, персистентной памятью и автоматическим Git-контролем версий.

Установка

terminal
bash
claude mcp add thread-manager node "/YOURSELFPROJECTPATH/.claude/skills/thread-manager/dist/index.js"

README

AI Agent Team

AI Agent Team License Version npm GitHub stars

🚀 Профессиональная 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 вводит новый слой векторного поиска:

mermaid
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: Локальная инициализация проекта (изолированная конфигурация)

bash
cd your-project
ai-agent-team init

Создаёт локальную конфигурацию в .claude/ проекта — доступна только в текущем проекте.

Шаг 3: Включение MCP-сервера Thread Manager ⭐ Ключевой шаг

bash
claude mcp add thread-manager node "/YOURSELFPROJECTPATH/.claude/skills/thread-manager/dist/index.js"

image-20251205145139573

ScreenShot_2025-12-12_110715_649

Зачем это нужно?

  • Thread Manager работает как MCP-сервер и обеспечивает персистентную память
  • Настраивается один раз и работает постоянно
  • Без этого шага команды /threads, /pm-start и другие команды управления тредами будут недоступны

✅ Проверка установки

После перезапуска Claude Code выполните:

bash
# 1. Просмотр всех тредов
/threads

# 2. Создание первого треда задачи
/pm-start "Моя первая задача"

# 3. Просмотр информации о текущем треде
/thread info

Если отображается список тредов — установка прошла успешно! 🎉


🎯 Сравнение двух способов инициализации

ХарактеристикаГлобальная инициализацияЛокальная инициализация проекта
Расположение конфигурации~/.claude/./.claude/
Область примененияВсе проектыТолько текущий проект
Командная работаЛичное использованиеМожно добавить в Git
Изоляция данныхОбщие данные тредовНезависимые треды проекта
Рекомендуется дляИндивидуальных разработчиковКомандных проектов

💡 Совет: в большинстве случаев рекомендуется глобальная инициализация — если только не требуется полная изоляция данных тредов между проектами.


image-20251205144719898

❓ Часто задаваемые вопросы

Причина: MCP-сервер Thread Manager не включён.

Решение:

bash
# 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/
Данные тредовОбщие для всех проектовИзолированные для проекта
Сценарий использованияЛичная разработкаКомандная работа

Рекомендация: для личного использования — глобальная, для командных проектов — локальная.

bash
# Способ 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% успешная установка.

Подробные примечания к выпуску v2.0.1 и архитектурная схема

🚀 Ключевые возможности

💾 Персистентная память

  • ✅ Семантический поиск по истории сообщений
  • ✅ Постоянное сохранение диалогов
  • ✅ Восстановление контекста в любой момент
  • ✅ Параллельное управление несколькими задачами

🌿 Автоматическая интеграция с Git

  • ✅ Автоматическое создание веток задач
  • ✅ Отслеживание изменений файлов
  • ✅ Статистический анализ кода
  • ✅ Полный контроль версий

🎯 Быстрый запуск агентов

  • /pm-start — проектирование продукта
  • /fe-start — фронтенд-разработка
  • /be-start — бэкенд-разработка
  • /qa-start — обеспечение качества

📊 Thread Manager vs нативный Claude

ФункцияНативный ClaudeThread ManagerУлучшение
Память контекста❌ Теряется при перезапуске✅ Сохраняется постоянно
Многозадачность❌ Один поток✅ Неограниченный параллелизм10x+
Восстановление задач❌ Невозможно✅ Полное восстановлениеНовое
Контроль версий⚠️ Ручной✅ Автоматический3x
Производительность100%200%+2x

🎮 Базовое использование

Создание треда задачи (автоматическая инициализация роли)

bash
/pm-start "Проектирование функции корзины для интернет-магазина"
  ↓ Автоматически создаётся продуктовый тред
  ↓ AI сразу анализирует требования в роли продакт-менеджера
  ↓ История диалога сохраняется постоянно

Параллельное управление несколькими задачами

bash
/threads          # Просмотр всех активных тредов
/thread switch 2  # Переключение на тред #2
/thread info      # Просмотр информации о текущем треде

Семантический поиск истории

bash
# Поиск на естественном языке
"Найди наше обсуждение логики авторизации"
"Какие решения по архитектуре базы данных мы принимали?"
"Покажи все баги, связанные с производительностью"

👥 Команда AI-агентов

Роли и команды запуска

РольКоманда запускаОсновные обязанности
🎯 Продакт-менеджер/pm-startАнализ требований, планирование итераций, управление продуктом
🎨 Фронтенд-разработчик/fe-startUI/UX, компоненты, оптимизация производительности
⚙️ Бэкенд-разработчик/be-startAPI, база данных, архитектура системы
🔍 QA-инженер/qa-startТест-кейсы, автоматизация тестирования, контроль качества
🚀 DevOps-инженер/devops-startCI/CD, деплой, мониторинг
👑 Технический руководитель/lead-startАрхитектурные решения, ревью кода, техническое руководство

Поддержка команд на русском и английском языках

Все агенты поддерживают команды как на русском, так и на английском языке:

bash
# Английский
/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/ # Навыки технического руководителя

Обновление до последней версии

bash
# Обновление пакета
npm update -g ai-agent-team

# Повторная инициализация (сохраняет существующие данные)
ai-agent-team init

📄 Лицензия

Распространяется по лицензии MIT. Подробности см. в файле LICENSE.


Если этот проект оказался полезным, поставьте ⭐ на GitHub!

Сообщить об ошибке · Запросить функцию · Внести вклад

Похожие скиллы