97 lines
3.5 KiB
Markdown
97 lines
3.5 KiB
Markdown
|
# AI Documentation
|
|||
|
|
|
|||
|
|
Документация для AI агентов и разработчиков проекта mnemo_cards.
|
|||
|
|
|
|||
|
|
## 🤖 AI Agent 24/7 Automation System
|
|||
|
|
|
|||
|
|
Система автоматизированной разработки с использованием AI агентов для Forgejo.
|
|||
|
|
|
|||
|
|
### Быстрый старт
|
|||
|
|
|
|||
|
|
1. **За 5 минут**: [agent/QUICKSTART.md](./agent/QUICKSTART.md)
|
|||
|
|
2. **За 30 минут**: [agent/FORGEJO_SETUP.md](./agent/FORGEJO_SETUP.md)
|
|||
|
|
3. **Полная документация**: [agent/README.md](./agent/README.md)
|
|||
|
|
|
|||
|
|
### Что это?
|
|||
|
|
|
|||
|
|
AI агенты которые:
|
|||
|
|
- 📋 Анализируют проект и создают задачи (Planning Agent)
|
|||
|
|
- 💻 Пишут код автоматически (Development Agent)
|
|||
|
|
- ✅ Тестируют и деплоят (Test & Deploy)
|
|||
|
|
- 🔄 Работают 24/7 параллельно на разных компонентах
|
|||
|
|
|
|||
|
|
### Документация
|
|||
|
|
|
|||
|
|
- [**QUICKSTART.md**](./agent/QUICKSTART.md) - запуск за 5 минут
|
|||
|
|
- [**FORGEJO_SETUP.md**](./agent/FORGEJO_SETUP.md) - пошаговая настройка
|
|||
|
|
- [**README.md**](./agent/README.md) - полная документация
|
|||
|
|
- [**CONFIGURATION.md**](./agent/CONFIGURATION.md) - детальная конфигурация
|
|||
|
|
- [**AGENT_SYSTEM_SUMMARY.md**](./AGENT_SYSTEM_SUMMARY.md) - краткое описание системы
|
|||
|
|
|
|||
|
|
### Структура
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
ai_docs/
|
|||
|
|
├── README.md (этот файл)
|
|||
|
|
├── AGENT_SYSTEM_SUMMARY.md
|
|||
|
|
└── agent/
|
|||
|
|
├── README.md # Полная документация
|
|||
|
|
├── QUICKSTART.md # Быстрый старт
|
|||
|
|
├── FORGEJO_SETUP.md # Пошаговая настройка
|
|||
|
|
├── CONFIGURATION.md # Детальная конфигурация
|
|||
|
|
├── web_v2/ # Состояние агента web_v2
|
|||
|
|
├── backend/ # Состояние агента backend
|
|||
|
|
├── common/ # Состояние агента common
|
|||
|
|
├── global_lock.json # Глобальная блокировка
|
|||
|
|
└── prompts/ # Промпты для агентов
|
|||
|
|
├── development_prompt.md
|
|||
|
|
└── planning_prompt.md
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
### Workflows
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
.github/workflows/
|
|||
|
|
├── agent-planning.yml # Planning Agent
|
|||
|
|
├── agent-development.yml # Development Agent
|
|||
|
|
└── agent-test-deploy.yml # Test & Deploy
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
### Scripts
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
tools/agent/
|
|||
|
|
├── config.py # Конфигурация
|
|||
|
|
├── task_manager.py # Менеджер задач
|
|||
|
|
├── cursor_cli_wrapper.py # Wrapper для Cursor CLI
|
|||
|
|
├── agent_orchestrator.py # Главный оркестратор
|
|||
|
|
└── planning_agent.py # Planning агент
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
## 🚀 Как использовать
|
|||
|
|
|
|||
|
|
### 1. Настройте систему
|
|||
|
|
|
|||
|
|
Следуйте инструкции: [agent/FORGEJO_SETUP.md](./agent/FORGEJO_SETUP.md)
|
|||
|
|
|
|||
|
|
### 2. Запустите Planning Agent
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
Actions -> AI Agent - Planning -> Run workflow -> выберите компонент
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
### 3. Наблюдайте за работой
|
|||
|
|
|
|||
|
|
Development Agent запустится автоматически и начнет писать код.
|
|||
|
|
|
|||
|
|
## 📚 Дополнительно
|
|||
|
|
|
|||
|
|
- [Cursor CLI Docs](https://cursor.com/docs/cli/headless)
|
|||
|
|
- [Forgejo Actions Docs](https://forgejo.org/docs/latest/user/actions/)
|
|||
|
|
|
|||
|
|
---
|
|||
|
|
|
|||
|
|
**Версия**: 1.0
|
|||
|
|
**Дата**: 2025-11-20
|
|||
|
|
|