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

docs: update README to reflect current repository state

Browse Source 
- Fix outdated structure (.kilocode -> .kilo)
- Add missing agents (go-developer, cognitive agents)
- Add skills section
- Remove references to deleted files (install-apaw.sh)
- Add archive directory documentation

Update agent list to 25+ agents
This commit is contained in:
¨NW¨
2026-04-05 03:59:52 +01:00
parent 5a77528b23
commit eac6003137
1 changed files with 135 additions and 48 deletions
Download Patch File Download Diff File Expand all files Collapse all files

183
README.md
View File

@@ -1,9 +1,9 @@
# APAW — Automatic Programmers Agent Workflow
**Dual-runtime Agent Pipeline** — полная конфигурация автономного ИТ-офиса из 13+ специализированных ИИ-агентов.
**Dual-runtime Agent Pipeline** — полная конфигурация автономного ИТ-офиса из 25+ специализированных ИИ-агентов.
Поддерживает два runtime:
- **KiloCode** (VS Code плагин) — через `.kilo/agent/` (`@kilocode/plugin` формат)
- **KiloCode** (VS Code плагин) — через `.kilo/agents/` (`@kilocode/plugin` формат)
- **Claude Code** (CLI / VS Code extension) — через `.claude/commands/`
Система спроектирована как **Self-Healing Repository**: агенты автоматически анализируют задачи, пишут код, тестируют, проводят ревью и деплоят, не переписывая одно и то же дважды благодаря встроенной памяти коммитов.
@@ -12,6 +12,71 @@
## Структура репозитория
```
.
├── .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)
│ ├── 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 интеграция
│ │ └── ...
│ ├── rules/ # Правила кодирования
│ ├── workflows/ # Workflow определения
│ ├── capability-index.yaml # Индекс возможностей
│ └── logs/ # Логи
├── src/
│ └── kilocode/ # TypeScript API
│ ├── index.ts
│ └── ...
├── archive/ # Архив (устаревшие файлы)
├── AGENTS.md # Справка по агентам
└── README.md # Этот документ
```
.
├── install-apaw.sh # Установщик в любой проект (bash)
@@ -47,36 +112,31 @@
│ │ ├── the-fixer.md # Исправитель (MiniMax-m2.7)
│ │ ├── sdet-engineer.md # Тестирование TDD (Qwen3-Coder-Next)
│ │ ├── code-skeptic.md # Критик кода (GPT-OSS 120B)
│ │ ├── performance-engineer.md # Производительность (Nemotron-3-Super)
│ │ ├── security-auditor.md # Безопасность (GLM-4.7)
│ │ ├── release-manager.md # Релизы (Devstral-2 123B)
│ │ ├── evaluator.md # Оценщик (GPT-o3)
│ │ ├── prompt-optimizer.md # PromptOps (Claude 4.5)
│ │ ├── ask.md # Knowledge agent (Gemini-3-Flash)
│ │ ├── code.md # Quick coder (DeepSeek-v3.2)
│ │ ├── debug.md # Диагностика (MiniMax-m2.7)
│ │ └── plan.md # Стратег (GPT-OSS 120B)
│ ├── package.json # @kilocode/plugin dependency
│ └── node_modules/ # Plugin runtime
├── .kilocode/
│ ├── agents/ # Устаревший формат (заменён .kilo/agent/)
│ ├── rules/
│ │ └── global.md # Глобальные правила
│ └── logs/
│ └── efficiency_score.json # История оценок
│ │ ├── 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/
│ ├── index.ts # Точка входа модуля
│ └── agent-manager/ # TypeScript-интеграция с KiloCode
│ ├── index.ts # Загрузчик конфигурации агентов
│ ├── workflow.ts # State Machine пайплайна
│ ├── router.ts # Маршрутизатор между агентами
│ ├── prompt-loader.ts # Динамическая загрузка промптов
│ ├── git-ops.ts # Git-операции (история, коммиты)
│ ├── evaluator.ts # Логика оценки эффективности
│ ├── gitea-client.ts # Gitea API для логирования
│ ├── pipeline-runner.ts # Оркестратор пайплайна
│ └── types.ts # TypeScript-типы системы
│ └── kilocode/ # TypeScript API
├── archive/ # Архив (устаревшие файлы)
├── AGENTS.md # Справка по агентам
└── README.md # Этот документ
```
---
@@ -190,10 +250,11 @@ sed -i 's|/project:|/user:|g' ~/.claude/commands/*.md
```bash
git clone https://git.softuniq.eu/UniqueSoft/APAW.git
./APAW/install-apaw.sh /path/to/your-project
cp -r APAW/.claude /path/to/your-project/
cp -r APAW/.kilo /path/to/your-project/
```
Скрипт создаёт `.claude/` в целевом проекте. Команды доступны как `/project:*`.
Копирует `.claude/` и `.kilo/` в целевой проект. Команды доступны как `/project:*`.
#### Быстрый старт
@@ -253,6 +314,8 @@ git clone https://git.softuniq.eu/UniqueSoft/APAW.git
| `@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 |
@@ -262,9 +325,22 @@ git clone https://git.softuniq.eu/UniqueSoft/APAW.git
| `@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 |
| `@AgentArchitect` | Manages agent network per Kilo.ai spec | qwen/qwen3.6-plus:free |
| `@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 |
> **Note:** For AgentArchitect, use `subagent_type: "system-analyst"` with prompt "You are Agent Architect..." (workaround for unsupported agent-architect type).
### 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 |
## Конфигурация разрешений агентов
@@ -304,18 +380,17 @@ git clone https://git.softuniq.eu/UniqueSoft/APAW.git
```bash
git clone https://git.softuniq.eu/UniqueSoft/APAW.git
cp -r APAW/.kilocode /your-project/
cp APAW/.kilocodemodes /your-project/
cp -r APAW/.kilo /your-project/
```
KiloCode автоматически обнаружит `.kilocodemodes` и загрузит все режимы агентов.
KiloCode автоматически обнаружит `.kilo/` и загрузит все агенты.
Начните с **Requirement Refiner**, введя описание задачи на естественном языке.
---
## PromptOps: Эволюция промптов через Git
Все системные промпты хранятся в `.kilocode/agents/` и версионируются через Git:
Все системные промпты хранятся в `.kilo/agents/` и версионируются через Git:
- **Отслеживать эволюцию** — `git diff` покажет изменения, сделанные Prompt Optimizer
- **Откатывать изменения** — `git checkout` вернёт предыдущую версию промпта
@@ -334,7 +409,7 @@ chore(ai-brain): optimize Lead Dev prompt based on Issue #142 failures
## Оценка эффективности
Файл `.kilocode/logs/efficiency_score.json` хранит историю оценок по каждому Issue:
Файл `.kilo/logs/efficiency_score.json` хранит историю оценок по каждому Issue:
```json
{
@@ -529,16 +604,28 @@ GITEA_TOKEN=your-token-here
---
## Удаление дубликатов
## Skills System
Если в проекте есть старые файлы в `packages/opencode/`, выполните:
Система навыков в `.kilo/skills/` обеспечивает специализацию агентов:
```bash
sudo rm -rf packages/opencode/src/kilocode/
```
### Backend Development
| Skill | Technology |
|-------|------------|
| `nodejs-express-patterns` | Express.js routing, middleware |
| `nodejs-auth-jwt` | JWT authentication |
| `nodejs-db-patterns` | Database operations |
| `nodejs-security-owasp` | Security best practices |
| `go-web-patterns` | Gin/Echo web framework |
| `go-db-patterns` | GORM/sqlx patterns |
| `go-concurrency` | Goroutines, channels |
| `go-modules` | Go modules management |
Код интегрирован в `src/kilocode/`.
---
### Integration & Workflow
| Skill | Purpose |
|-------|---------|
| `gitea-commenting` | Gitea API integration |
| `gitea-workflow` | Workflow execution |
| `research-cycle` | Self-improvement cycle |
| `planning-patterns` | Task decomposition |
*Разработано в рамках проекта APAW (Automatic Programmers Agent Workflow) — 2026*