UniqueSoft/APAW
2
0
Fork 0
Code Issues 31 Pull Requests Actions Packages Projects Releases Wiki Activity

docs: rewrite README with proper markdown formatting

Browse Source 
- Remove duplicate structure sections
- Add proper ASCII diagram for workflow
- Format all tables correctly
- Remove outdated references
- Add Skills System section
- Clean up code blocks
This commit is contained in:
¨NW¨
2026-04-05 04:08:28 +01:00
parent eac6003137
commit 0764154e94
1 changed files with 192 additions and 442 deletions
Download Patch File Download Diff File Expand all files Collapse all files

634
README.md
View File

@@ -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 <issue>` | Запуск полного пайплайна | `/pipeline 42` |
| `/status <issue>` | Проверка статуса пайплайна | `/status 42` |
| `/evaluate <issue>` | Генерация отчёта эффективности | `/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*