diff --git a/README.md b/README.md index ef72d70..6a5ff64 100644 --- a/README.md +++ b/README.md @@ -16,132 +16,25 @@ . ├── .claude/ # Claude Code runtime │ ├── commands/ # 14 slash-команд (/project:*) -│ │ ├── pipeline.md # Полный цикл одной командой -│ │ ├── orchestrate.md # Диспетчер -│ │ ├── refine.md # Уточнение требований -│ │ ├── mine.md # Поиск дублей в git -│ │ ├── analyze.md # Системный дизайн -│ │ ├── tests.md # TDD red phase -│ │ ├── implement.md # TDD green phase -│ │ ├── skeptic.md # Adversarial ревью -│ │ ├── perf.md # Анализ производительности -│ │ ├── fix.md # Исправление проблем -│ │ ├── security.md # Аудит безопасности -│ │ ├── release.md # Менеджер релизов -│ │ ├── evaluate.md # Оценка агентов -│ │ └── optimize-prompts.md # PromptOps авто-улучшение -│ ├── rules/ -│ │ └── global.md # Глобальные правила кодирования -│ └── logs/ -│ └── efficiency_score.json # История оценок агентов -├── .kilo/ # KiloCode plugin runtime (@kilocode/plugin) +│ ├── rules/ # Глобальные правила кодирования +│ └── logs/ # История оценок агентов +├── .kilo/ # KiloCode plugin runtime │ ├── agents/ # 25 агентов (YAML frontmatter) -│ │ ├── orchestrator.md # Диспетчер -│ │ ├── requirement-refiner.md # Уточнитель требований -│ │ ├── history-miner.md # Архивариус Git -│ │ ├── system-analyst.md # Системный аналитик -│ │ ├── product-owner.md # Менеджер задач -│ │ ├── lead-developer.md # Ведущий разработчик -│ │ ├── frontend-developer.md # Frontend -│ │ ├── backend-developer.md # Backend (Node.js) -│ │ ├── go-developer.md # Backend (Go) -│ │ ├── the-fixer.md # Исправитель -│ │ ├── sdet-engineer.md # Тестирование TDD -│ │ ├── code-skeptic.md # Критик кода -│ │ ├── performance-engineer.md # Производительность -│ │ ├── security-auditor.md # Безопасность -│ │ ├── release-manager.md # Релизы -│ │ ├── evaluator.md # Оценщик -│ │ ├── prompt-optimizer.md # PromptOps -│ │ ├── capability-analyst.md # Анализ возможностей -│ │ ├── agent-architect.md # Архитектор агентов -│ │ ├── workflow-architect.md # Архитектор workflows -│ │ ├── planner.md # Планировщик (CoT/ToT) -│ │ ├── reflector.md # Рефлексия -│ │ ├── memory-manager.md # Управление памятью -│ │ └── ... -│ ├── commands/ # Workflow команды (18 файлов) -│ ├── skills/ # Специализированные навыки (34+) -│ │ ├── nodejs-* # Node.js навыки -│ │ ├── go-* # Go навыки -│ │ ├── gitea-* # Gitea интеграция -│ │ └── ... +│ ├── commands/ # 18 workflow команд +│ ├── skills/ # 34+ специализированных навыка │ ├── rules/ # Правила кодирования │ ├── workflows/ # Workflow определения -│ ├── capability-index.yaml # Индекс возможностей -│ └── logs/ # Логи -├── src/ -│ └── kilocode/ # TypeScript API -│ ├── index.ts -│ └── ... -├── archive/ # Архив (устаревшие файлы) -├── AGENTS.md # Справка по агентам -└── README.md # Этот документ -``` -. -├── install-apaw.sh # Установщик в любой проект (bash) -├── .claude/ # Claude Code runtime -│ ├── commands/ # 13 slash-команд (/project:*) -│ │ ├── pipeline.md # Полный цикл одной командой -│ │ ├── orchestrate.md # Диспетчер (Sonnet) -│ │ ├── refine.md # Уточнение требований (Sonnet) -│ │ ├── mine.md # Поиск дублей в git (Haiku) -│ │ ├── analyze.md # Системный дизайн (Opus) -│ │ ├── tests.md # TDD red phase (Sonnet) -│ │ ├── implement.md # TDD green phase (Opus) -│ │ ├── skeptic.md # Adversarial ревью (Sonnet) -│ │ ├── perf.md # Анализ производительности (Sonnet) -│ │ ├── fix.md # Исправление проблем (Sonnet) -│ │ ├── security.md # Аудит безопасности (Opus) -│ │ ├── release.md # Менеджер релизов (Sonnet) -│ │ ├── evaluate.md # Оценка агентов (Haiku) -│ │ └── optimize-prompts.md # PromptOps авто-улучшение (Opus) -│ ├── rules/ -│ │ └── global.md # Глобальные правила кодирования -│ └── logs/ -│ └── efficiency_score.json # История оценок агентов -├── .kilo/ # KiloCode plugin runtime (@kilocode/plugin) -│ ├── agent/ # 19 агентов в формате plugin (YAML frontmatter) -│ │ ├── orchestrator.md # Диспетчер (GLM-5) -│ │ ├── requirement-refiner.md # Уточнитель требований (Kimi-k2-thinking) -│ │ ├── history-miner.md # Архивариус Git (Gemini-3-Flash) -│ │ ├── system-analyst.md # Системный аналитик (GPT-OSS 120B) -│ │ ├── product-owner.md # Менеджер задач (Qwen3.5 122B) -│ │ ├── lead-developer.md # Ведущий разработчик (DeepSeek-v3.2) -│ │ ├── frontend-developer.md # Frontend (Kimi-k2.5) -│ │ ├── the-fixer.md # Исправитель (MiniMax-m2.7) -│ │ ├── sdet-engineer.md # Тестирование TDD (Qwen3-Coder-Next) -│ │ ├── code-skeptic.md # Критик кода (GPT-OSS 120B) -│ │ ├── capability-analyst.md # Анализ возможностей -│ │ ├── agent-architect.md # Архитектор агентов -│ │ ├── workflow-architect.md # Архитектор workflows -│ │ ├── planner.md # Планировщик (CoT/ToT) -│ │ ├── reflector.md # Рефлексия -│ │ └── memory-manager.md # Управление памятью -│ ├── commands/ # Workflow команды (18 файлов) -│ ├── skills/ # 34+ специализированных навыков -│ │ ├── nodejs-* # Node.js навыки (8) -│ │ ├── go-* # Go навыки (8) -│ │ ├── gitea-* # Gitea интеграция -│ │ └── ... -│ ├── rules/ # Правила кодирования -│ │ ├── nodejs.md # Node.js правила -│ │ ├── go.md # Go правила -│ │ ├── agent-patterns.md # Паттерны агентов -│ │ └── ... -│ ├── workflows/ # Workflow определения │ ├── capability-index.yaml # Индекс возможностей агентов │ └── logs/ # Логи эффективности -├── src/ -│ └── kilocode/ # TypeScript API +├── src/kilocode/ # TypeScript API ├── archive/ # Архив (устаревшие файлы) ├── AGENTS.md # Справка по агентам -└── README.md # Этот документ +└── README.md # Этот документ ``` --- -## Состав команды (14 агентов) +## Состав команды (25+ агентов) ### Блок А: Вход и Планирование @@ -149,82 +42,129 @@ |---|------|--------|---------------| | 1 | **Requirement Refiner** | Kimi-k2-thinking | Транслирует задачи в строгие технические чек-листы | | 2 | **Orchestrator** | GLM-5 | Главный диспетчер, управляет State Machine | -| 3 | **History Miner** | GPT-OSS 20B | Сканирует git log, предотвращает дублирование работы | +| 3 | **History Miner** | GPT-OSS 20B | Сканирует git log, предотвращает дублирование | +| 4 | **Planner** | GPT-OSS 120B | Декомпозиция задач (Chain of Thought) | ### Блок Б: Проектирование | # | Роль | Модель | Специализация | |---|------|--------|---------------| -| 4 | **System Analyst** | Qwen3.6-Plus (Free) | Создаёт схемы БД, TypeScript-интерфейсы и API-контракты | -| 5 | **Product Owner** | Qwen3.6-Plus (Free) | Управляет чек-листами в Issues и статусными лейблами | +| 5 | **System Analyst** | Qwen3.6-Plus | Создаёт схемы БД, API-контракты | +| 6 | **Product Owner** | Qwen3.6-Plus | Управляет чек-листами в Issues | +| 7 | **Capability Analyst** | GPT-OSS 120B | Gap analysis, рекомендации | +| 8 | **Workflow Architect** | GLM-5 | Создание workflow определений | ### Блок В: Производство | # | Роль | Модель | Специализация | |---|------|--------|---------------| -| 6 | **Lead Developer** | Qwen3-Coder 480B | Пишет основной код (Go / Node.js) по TDD-спецификации | -| 7 | **Frontend Dev** | Kimi-k2.5 | UI-компоненты, мультимодальный анализ скриншотов | -| 8 | **The Fixer** | MiniMax-m2.5 | Итеративно исправляет баги после тестов и ревью | +| 9 | **Lead Developer** | Qwen3-Coder 480B | Пишет основной код по TDD | +| 10 | **Backend Developer** | Qwen3-Coder 480B | Node.js/Express APIs | +| 11 | **Go Developer** | DeepSeek-v3.2 | Go/Gin/Echo APIs, concurrency | +| 12 | **Frontend Dev** | Kimi-k2.5 | UI-компоненты, мультимодальный анализ | +| 13 | **The Fixer** | MiniMax-m2.5 | Итеративно исправляет баги | ### Блок Г: Контроль Качества | # | Роль | Модель | Специализация | |---|------|--------|---------------| -| 9 | **SDET Engineer** | Qwen3-Coder 480B | Пишет падающие тесты до реализации (TDD Red Phase) | -| 10 | **Code Skeptic** | MiniMax-m2.5 | Ищет race conditions, уязвимости, логические дыры | -| 11 | **Performance Engineer** | Nemotron-3-Super | Проверяет на N+1, утечки памяти, блокировки event loop | -| 12 | **Security Auditor** | Kimi-k2.5 | OWASP Top 10, SQL-инъекции, XSS, CVE в зависимостях | +| 14 | **SDET Engineer** | Qwen3-Coder 480B | TDD Red Phase — пишет падающие тесты | +| 15 | **Code Skeptic** | MiniMax-m2.5 | Adversarial ревью кода | +| 16 | **Performance Engineer** | Nemotron-3-Super | N+1, утечки памяти, блокировки | +| 17 | **Security Auditor** | Kimi-k2.5 | OWASP Top 10, CVE в зависимостях | ### Блок Д: Релиз и Самообучение | # | Роль | Модель | Специализация | |---|------|--------|---------------| -| 13 | **Release Manager** | Qwen3-Coder 480B | SemVer, Git Flow, мердж только при Green Build | -| 14 | **Performance Evaluator** | GPT-OSS 120B | Оценивает эффективность каждого агента по шкале 1-10 | -| 15 | **Prompt Optimizer** | Qwen3.6-Plus (Free) | Анализирует ошибки и переписывает системные промпты | +| 18 | **Release Manager** | Qwen3-Coder 480B | SemVer, Git Flow, мердж | +| 19 | **Evaluator** | GPT-OSS 120B | Оценивает эффективность агентов (1-10) | +| 20 | **Prompt Optimizer** | Qwen3.6-Plus | Анализирует ошибки, улучшает промпты | + +### Блок Е: Когнитивное усиление (Research-Based) + +| # | Роль | Паттерн | Специализация | +|---|------|---------|---------------| +| 21 | **Planner** | Chain of Thought / Tree of Thoughts | Декомпозиция сложных задач | +| 22 | **Reflector** | Reflexion | Self-reflection, анализ ошибок | +| 23 | **Memory Manager** | Memory Architecture | Контекст и эпизодическая память | + +### Блок Ж: Специализированные + +| # | Роль | Модель | Специализация | +|---|------|--------|---------------| +| 24 | **Browser Automation** | Qwen3-Coder 480B | E2E тесты с Playwright | +| 25 | **Visual Tester** | Qwen3-Coder 480B | Visual regression testing | +| 26 | **Markdown Validator** | GLM-5 | Валидация Markdown | --- ## Жизненный цикл задачи (State Machine) ``` -[Пользователь] -> Requirement Refiner -> Orchestrator - | - +-------------------------+ - v v - History Miner (если дубль -> закрыть) - | - v - System Analyst - | - v - SDET Engineer (Red Phase: тесты падают) - | - v - Lead Developer (Green Phase: тесты проходят) - | - v - Code Skeptic ---- замечания ---> The Fixer --+ - | | - +--------------------------------------+ - | (Approve) - v - Performance Engineer -- проблемы -> The Fixer - | (OK) - v - Security Auditor -- уязвимости -> The Fixer - | (OK) - v - Release Manager (SemVer + Merge) - | - v - Performance Evaluator (оценка 1-10) - | - v - Prompt Optimizer (если оценка < 7 -> улучшить промпт) - | - v - Product Owner (закрывает Issue) +[Пользователь] + │ + ▼ +┌─────────────────┐ +│ Requirement │ Вагные идеи → технические чек-листы +│ Refiner │ +└────────┬────────┘ + │ + ▼ +┌─────────────────┐ +│ History Miner │ Проверка дублей в git +└────────┬────────┘ + │ + ▼ +┌─────────────────┐ +│ System Analyst │ Схемы БД, API-контракты +└────────┬────────┘ + │ + ▼ +┌─────────────────┐ +│ SDET Engineer │ RED Phase — тесты падают +└────────┬────────┘ + │ + ▼ +┌─────────────────┐ +│ Lead Developer │ GREEN Phase — тесты проходят +└────────┬────────┘ + │ + ▼ +┌─────────────────┐ замечания ┌─────────────┐ +│ Code Skeptic │ ───────────────▶ │ The Fixer │ +└────────┬────────┘ └──────┬──────┘ + │ approve │ + ▼ │ +┌─────────────────┐ │ +│ Performance │ ◀───────────────────────┘ +│ Engineer │ +└────────┬────────┘ + │ approve + ▼ +┌─────────────────┐ +│ Security Auditor │ +└────────┬────────┘ + │ approve + ▼ +┌─────────────────┐ +│ Release Manager │ SemVer + Merge +└────────┬────────┘ + │ + ▼ +┌─────────────────┐ +│ Evaluator │ Оценка 1-10 +└────────┬────────┘ + │ + ▼ +┌─────────────────┐ +│ Prompt Optimizer │ Если оценка < 7 +└────────┬────────┘ + │ + ▼ +┌─────────────────┐ +│ Product Owner │ Закрывает Issue +└─────────────────┘ ``` --- @@ -233,15 +173,13 @@ ### Вариант A: Claude Code (рекомендуется) -#### Глобальная установка — команды работают во ВСЕХ проектах +#### Глобальная установка ```bash git clone https://git.softuniq.eu/UniqueSoft/APAW.git mkdir -p ~/.claude/commands ~/.claude/rules cp APAW/.claude/commands/*.md ~/.claude/commands/ cp APAW/.claude/rules/global.md ~/.claude/rules/ -# Заменить /project: на /user: во внутренних ссылках: -sed -i 's|/project:|/user:|g' ~/.claude/commands/*.md ``` После этого в **любом проекте** доступны команды `/user:pipeline`, `/user:refine` и т.д. @@ -254,125 +192,36 @@ cp -r APAW/.claude /path/to/your-project/ cp -r APAW/.kilo /path/to/your-project/ ``` -Копирует `.claude/` и `.kilo/` в целевой проект. Команды доступны как `/project:*`. - #### Быстрый старт -``` +```bash # Полный цикл от идеи до релиза: -/project:pipeline добавить эндпоинт авторизации через JWT -# или глобально (после глобальной установки): -/user:pipeline добавить эндпоинт авторизации через JWT +/project:pipeline добавить JWT авторизацию # Или пошагово: -/project:refine хочу кнопку экспорта в PDF -/project:mine экспорт PDF -/project:analyze экспорт PDF — user story + acceptance criteria -/project:tests ... -/project:implement ... +/project:refine хочу экспорт в PDF +/project:mine экспорт PDF # Проверка дублей +/project:analyze экспорт PDF # User story + acceptance criteria +/project:tests ... # TDD Red +/project:implement ... # TDD Green ``` #### Таблица команд -| Команда | Агент | Модель | Назначение | -|---------|-------|--------|-----------| -| `/project:pipeline` | Pipeline Runner | Sonnet | Весь цикл одной командой | -| `/project:orchestrate` | Orchestrator | Sonnet | Маршрутизация по состоянию | -| `/project:refine` | Requirement Refiner | Sonnet | Вагные идеи → чеклист | -| `/project:mine` | History Miner | **Haiku** | Поиск дублей в git | -| `/project:analyze` | System Analyst | **Opus** | Схемы БД, API-контракты | -| `/project:tests` | SDET Engineer | Sonnet | TDD — пишет падающие тесты | -| `/project:implement` | Lead Developer | **Opus** | TDD — делает тесты зелёными | -| `/project:skeptic` | Code Skeptic | Sonnet | Adversarial ревью кода | -| `/project:perf` | Performance Engineer | Sonnet | N+1, утечки, блокировки | -| `/project:fix` | The Fixer | Sonnet | Точечные исправления | -| `/project:security` | Security Auditor | **Opus** | OWASP Top 10, CVE | -| `/project:release` | Release Manager | Sonnet | SemVer, gate-check, тег | -| `/project:evaluate` | Evaluator | **Haiku** | Оценка агентов 1–10 | -| `/project:optimize-prompts` | Prompt Optimizer | **Opus** | PromptOps авто-улучшение | - -> Haiku = быстро и дёшево. Opus = максимальное качество. Sonnet = баланс. - ---- - -## KiloCode Commands (Quick Actions) - -| Command | Description | Model | -|---------|-------------|-------| -| `/plan` | Creates detailed task plans | ollama-cloud/qwen3-coder:480b | -| `/ask` | Answers codebase questions | openai/qwen3-32b | -| `/debug` | Analyzes and fixes bugs | ollama-cloud/gpt-oss:20b | -| `/code` | Quick code generation | ollama-cloud/qwen3-coder:480b | - -## KiloCode Pipeline Agents - -| Agent | Role | Model | -|-------|------|-------| -| `@RequirementRefiner` | Converts vague ideas to strict User Stories | ollama-cloud/kimi-k2-thinking | -| `@HistoryMiner` | Finds duplicates and past solutions in git | ollama-cloud/gpt-oss:20b | -| `@SystemAnalyst` | Designs technical specifications | qwen/qwen3.6-plus:free | -| `@SDETEngineer` | Writes tests following TDD | ollama-cloud/qwen3-coder:480b | -| `@LeadDeveloper` | Primary code writer | ollama-cloud/qwen3-coder:480b | -| `@FrontendDeveloper` | UI implementation with multimodal | ollama-cloud/kimi-k2.5 | -| `@BackendDeveloper` | Node.js/Express APIs and database | ollama-cloud/qwen3-coder:480b | -| `@GoDeveloper` | Go/Gin/Echo APIs and concurrency | ollama-cloud/deepseek-v3.2 | -| `@CodeSkeptic` | Adversarial code reviewer | ollama-cloud/minimax-m2.5 | -| `@TheFixer` | Iteratively fixes bugs | ollama-cloud/minimax-m2.5 | -| `@PerformanceEngineer` | Reviews for performance issues | ollama-cloud/nemotron-3-super | -| `@SecurityAuditor` | Scans for vulnerabilities | ollama-cloud/kimi-k2.5 | -| `@ReleaseManager` | Git operations and deployments | ollama-cloud/qwen3-coder:480b | -| `@Evaluator` | Scores agent effectiveness | ollama-cloud/gpt-oss:120b | -| `@PromptOptimizer` | Improves agent prompts | qwen/qwen3.6-plus:free | -| `@ProductOwner` | Manages issue checklists | qwen/qwen3.6-plus:free | -| `@Orchestrator` | Routes tasks between agents | ollama-cloud/glm-5 | -| `@CapabilityAnalyst` | Gap analysis and recommendations | ollama-cloud/gpt-oss:120b | -| `@WorkflowArchitect` | Creates workflow definitions | ollama-cloud/glm-5 | -| `@Planner` | Task decomposition (CoT/ToT) | ollama-cloud/gpt-oss:120b | -| `@Reflector` | Self-reflection and lesson extraction | ollama-cloud/gpt-oss:120b | -| `@MemoryManager` | Memory systems and context retrieval | ollama-cloud/gpt-oss:120b | -| `@MarkdownValidator` | Validates Markdown formatting | ollama-cloud/glm-5 | -| `@BrowserAutomation` | E2E browser testing with Playwright | ollama-cloud/qwen3-coder:480b | -| `@VisualTester` | Visual regression testing | ollama-cloud/qwen3-coder:480b | - -### Cognitive Enhancement Agents (Research-Based) - -| Agent | Pattern | Role | -|-------|---------|------| -| `@Planner` | Chain of Thought / Tree of Thoughts | Task decomposition | -| `@Reflector` | Reflexion | Self-reflection and mistake analysis | -| `@MemoryManager` | Memory Architecture | Context and episodic memory | - -## Конфигурация разрешений агентов - -Все агенты настроены для автономной работы без запросов разрешений на каждое действие: - -| Агент | read | edit | write | bash | glob | grep | task | -|-------|------|------|-------|------|------|------|------| -| **orchestrator** | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | 15 subagents | -| **lead-developer** | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | code-skeptic | -| **frontend-developer** | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | deny | -| **sdet-engineer** | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | lead-developer | -| **the-fixer** | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | code-skeptic, orchestrator | -| **code-skeptic** | ✅ | ❌ | ❌ | ✅ | ✅ | ✅ | the-fixer, performance-eng | -| **performance-engineer** | ✅ | ❌ | ❌ | ✅ | ✅ | ✅ | the-fixer, security-auditor | -| **security-auditor** | ✅ | ❌ | ❌ | ✅ | ✅ | ✅ | the-fixer, release-manager | -| **evaluator** | ✅ | ❌ | ❌ | ❌ | ✅ | ✅ | prompt-optimizer, product-owner | -| **requirement-refiner** | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | history-miner, system-analyst | -| **history-miner** | ✅ | ❌ | ❌ | ✅ | ✅ | ✅ | deny | -| **system-analyst** | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | deny | -| **product-owner** | ✅ | ✅ | ✅ | ❌ | ✅ | ✅ | deny | -| **release-manager** | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | evaluator | -| **prompt-optimizer** | ✅ | ✅ | ✅ | ❌ | ✅ | ✅ | deny | -| **agent-architect** | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | deny | - -**Категории разрешений:** -- **Code Writers** (lead-developer, frontend-developer, sdet-engineer, the-fixer) — полный доступ для написания кода -- **Reviewers** (code-skeptic, performance-engineer, security-auditor, evaluator) — только чтение, без редактирования -- **Analysts** (requirement-refiner, history-miner, system-analyst, product-owner) — чтение + создание спецификаций -- **Release Manager** — полный доступ для git-операций -- **Configurators** (prompt-optimizer, agent-architect) — полный доступ для редактирования конфигураций - - +| Команда | Назначение | +|---------|-----------| +| `/project:pipeline` | Весь цикл одной командой | +| `/project:refine` | Идеи → чеклист | +| `/project:mine` | Поиск дублей в git | +| `/project:analyze` | Схемы БД, API-контракты | +| `/project:tests` | TDD — падающие тесты | +| `/project:implement` | TDD — реализация | +| `/project:skeptic` | Adversarial ревью | +| `/project:perf` | N+1, утечки, блокировки | +| `/project:fix` | Точечные исправления | +| `/project:security` | OWASP Top 10, CVE | +| `/project:release` | SemVer, gate-check, тег | +| `/project:evaluate` | Оценка агентов 1-10 | --- @@ -383,99 +232,40 @@ git clone https://git.softuniq.eu/UniqueSoft/APAW.git cp -r APAW/.kilo /your-project/ ``` -KiloCode автоматически обнаружит `.kilo/` и загрузит все агенты. -Начните с **Requirement Refiner**, введя описание задачи на естественном языке. +KiloCode автоматически обнаружит `.kilo/` и загрузит всех агентов. --- -## PromptOps: Эволюция промптов через Git +## KiloCode Pipeline Agents -Все системные промпты хранятся в `.kilo/agents/` и версионируются через Git: - -- **Отслеживать эволюцию** — `git diff` покажет изменения, сделанные Prompt Optimizer -- **Откатывать изменения** — `git checkout` вернёт предыдущую версию промпта -- **Анализировать обучение** — частые коммиты в промпт означают, что агент требует доработки - -Пример коммита от Prompt Optimizer: - -``` -chore(ai-brain): optimize Lead Dev prompt based on Issue #142 failures - -- Added: "Always check type compatibility in index.d.ts before implementation" -- Reason: 4 fix iterations due to TypeScript interface mismatches -``` +| Agent | Role | Model | +|-------|------|-------| +| `@RequirementRefiner` | Converts ideas to User Stories | ollama-cloud/kimi-k2-thinking | +| `@HistoryMiner` | Finds duplicates in git | ollama-cloud/gpt-oss:20b | +| `@SystemAnalyst` | Technical specifications | qwen/qwen3.6-plus:free | +| `@SDETEngineer` | TDD tests | ollama-cloud/qwen3-coder:480b | +| `@LeadDeveloper` | Primary code writer | ollama-cloud/qwen3-coder:480b | +| `@FrontendDeveloper` | UI implementation | ollama-cloud/kimi-k2.5 | +| `@BackendDeveloper` | Node.js/Express APIs | ollama-cloud/qwen3-coder:480b | +| `@GoDeveloper` | Go/Gin/Echo APIs | ollama-cloud/deepseek-v3.2 | +| `@CodeSkeptic` | Adversarial reviewer | ollama-cloud/minimax-m2.5 | +| `@TheFixer` | Bug fixes | ollama-cloud/minimax-m2.5 | +| `@PerformanceEngineer` | Performance review | ollama-cloud/nemotron-3-super | +| `@SecurityAuditor` | Vulnerability scan | ollama-cloud/kimi-k2.5 | +| `@ReleaseManager` | Git operations | ollama-cloud/qwen3-coder:480b | +| `@Evaluator` | Effectiveness scoring | ollama-cloud/gpt-oss:120b | +| `@PromptOptimizer` | Prompt improvements | qwen/qwen3.6-plus:free | +| `@ProductOwner` | Issue management | qwen/qwen3.6-plus:free | +| `@Orchestrator` | Task routing | ollama-cloud/glm-5 | +| `@Planner` | Task decomposition | ollama-cloud/gpt-oss:120b | +| `@Reflector` | Self-reflection | ollama-cloud/gpt-oss:120b | +| `@MemoryManager` | Context management | ollama-cloud/gpt-oss:120b | --- -## Оценка эффективности +## Прямой вызов агентов -Файл `.kilo/logs/efficiency_score.json` хранит историю оценок по каждому Issue: - -```json -{ - "version": "1.0", - "history": [ - { - "issue": 142, - "date": "2026-03-31T10:30:00Z", - "agents": { - "requirement-refiner": 8, - "lead-developer": 6, - "code-skeptic": 9 - }, - "iterations": 3, - "duration_hours": 2.5 - } - ] -} -``` - ---- - -## KiloCode Workflows Integration - -Проект интегрирован с **KiloCode Workflows** (slash commands): - -### Доступные команды - -| Команда | Описание | Пример | -|---------|----------|--------| -| `/pipeline ` | Запуск полного пайплайна | `/pipeline 42` | -| `/status ` | Проверка статуса пайплайна | `/status 42` | -| `/evaluate ` | Генерация отчёта эффективности | `/evaluate 42` | -| `/plan` | Создание детального плана | `/plan feature X` | -| `/ask` | Вопросы по кодовой базе | `/ask how does auth work` | -| `/debug` | Анализ и исправление багов | `/debug error in login` | -| `/code` | Быстрая генерация кода | `/code add validation` | - -### Как использовать Pipeline - -1. Откройте проект в VS Code с плагином KiloCode -2. Создайте Issue в Gitea -3. Введите `/pipeline <номер-issue>` в чате KiloCode -4. Пайплайн автоматически: - - Получит контекст Issue - - Проверит дубликаты в git - - Маршрутизирует через агентов по статусу - - Логирует прогресс в комментарии Gitea - - Сгенерирует итоговый отчёт - -### Workflow файлы - -| Файл | Назначение | -|------|------------| -| `.kilo/commands/pipeline.md` | Основной workflow пайплайна | -| `.kilo/commands/status.md` | Проверка статуса | -| `.kilo/commands/evaluate.md` | Оценка эффективности | -| `.kilo/agents/*.md` | Определения агентов (subagents) | -| `.kilo/rules/*.md` | Правила кодирования | -| `.kilo/skills/gitea/` | Gitea integration skill | - -### Прямой вызов агентов - -Агентов можно вызывать напрямую через `@mention`: - -``` +```bash @lead-developer implement authentication flow @code-skeptic review the auth module @security-auditor check for vulnerabilities @@ -483,20 +273,8 @@ chore(ai-brain): optimize Lead Dev prompt based on Issue #142 failures --- -## Технический стек - -- **Оркестрация**: Node.js / TypeScript (Agent Manager) -- **Интеграция**: KiloCode VS Code Extension / Claude Code -- **Версионирование**: Gitea + Git Flow -- **Язык разработки**: TypeScript / Node.js / Go -- **Тестирование**: TDD (Red-Green-Refactor) - ---- - ## Agent Manager API -Новый модуль `src/kilocode/` предоставляет программный API для работы с пайплайном: - ### Установка ```bash @@ -510,37 +288,18 @@ bun run build import { PipelineRunner, GiteaClient, - decideRouting, - WORKFLOW_GRAPH, - type AgentRole, - type IssueStatus + decideRouting } from './src/kilocode/index.js' -// Инициализация пайплайна const runner = await createPipelineRunner({ giteaToken: process.env.GITEA_TOKEN, - giteaApiUrl: 'https://git.softuniq.eu/api/v1', - efficiencyThreshold: 7, - autoLog: true + giteaApiUrl: 'https://git.softuniq.eu/api/v1' }) -// Запуск пайплайна для Issue const result = await runner.run({ issueNumber: 42, - files: ['src/auth.ts', 'src/user.ts'], - testResults: { passed: 5, failed: 0 } -}) - -// Определение следующего агента -const decision = decideRouting({ - status: 'implementing', - labels: ['status: implemented'], - checklists: { completed: 3, total: 5 }, - comments: [], files: ['src/auth.ts'] }) - -console.log(decision.nextAgent) // 'code-skeptic' ``` ### Gitea интеграция @@ -551,55 +310,11 @@ const client = new GiteaClient({ token: process.env.GITEA_TOKEN }) -client.setRepository('UniqueSoft', 'APAW') - -// Получить Issue const issue = await client.getIssue(42) - -// Установить статус await client.setStatus(42, 'implementing') - -// Добавить комментарий await client.createComment(42, { - body: '## ✅ Implementation Complete\n\nAll tests passed.' + body: '## ✅ Implementation Complete' }) - -// Закрыть Issue -await client.closeIssue(42) -``` - -### Логирование эффективности - -```typescript -await runner.logEvaluation(42, [ - { agent: 'lead-developer', score: 8, notes: 'Clean implementation' }, - { agent: 'code-skeptic', score: 7, notes: 'Found 2 minor issues' }, - { agent: 'the-fixer', score: 9, notes: 'Fixed issues quickly', iterations: 1 } -], 2, 1.5) -``` - ---- - -## Self-Improving Pipeline - -Система автоматически логирует эффективность каждого агента в Gitea Issues: - -1. **Pipeline Runner** запускается для каждой задачи -2. Каждый агент логирует свой прогресс в комментарии Issue -3. **Evaluator** оценивает эффективность агентов (1-10) -4. **Prompt Optimizer** получает агентов с низкими оценками (<7) -5. Промпты автоматически улучшаются на основе анализа - -Журнал эффективности сохраняется в `.kilo/logs/efficiency_score.json` для аналитики. - ---- - -## Переменные окружения - -```bash -# Gitea API -GITEA_API_URL=https://git.softuniq.eu/api/v1 -GITEA_TOKEN=your-token-here ``` --- @@ -609,6 +324,7 @@ GITEA_TOKEN=your-token-here Система навыков в `.kilo/skills/` обеспечивает специализацию агентов: ### Backend Development + | Skill | Technology | |-------|------------| | `nodejs-express-patterns` | Express.js routing, middleware | @@ -621,6 +337,7 @@ GITEA_TOKEN=your-token-here | `go-modules` | Go modules management | ### Integration & Workflow + | Skill | Purpose | |-------|---------| | `gitea-commenting` | Gitea API integration | @@ -628,4 +345,37 @@ GITEA_TOKEN=your-token-here | `research-cycle` | Self-improvement cycle | | `planning-patterns` | Task decomposition | -*Разработано в рамках проекта APAW (Automatic Programmers Agent Workflow) — 2026* +--- + +## Переменные окружения + +```bash +GITEA_API_URL=https://git.softuniq.eu/api/v1 +GITEA_TOKEN=your-token-here +``` + +--- + +## PromptOps: Эволюция промптов + +Все промпты хранятся в `.kilo/agents/` и версионируются через Git: + +- **Отслеживать эволюцию** — `git diff` покажет изменения +- **Откатывать изменения** — `git checkout` вернёт предыдущую версию +- **Анализировать обучение** — частые коммиты означают необходимость доработки + +--- + +## Технический стек + +| Layer | Technology | +|-------|------------| +| Runtime | Node.js / TypeScript | +| Integration | KiloCode VS Code Extension / Claude Code | +| Version Control | Gitea + Git Flow | +| Languages | TypeScript / Node.js / Go | +| Testing | TDD (Red-Green-Refactor) | + +--- + +*Разработано в рамках проекта APAW (Automatic Programmers Agent Workflow) — 2026* \ No newline at end of file