Files

¨NW¨ 0764154e94 docs: rewrite README with proper markdown formatting

- 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

2026-04-05 04:08:28 +01:00

15 KiB

Raw Blame History

APAW — Automatic Programmers Agent Workflow

Dual-runtime Agent Pipeline — полная конфигурация автономного ИТ-офиса из 25+ специализированных ИИ-агентов.

Поддерживает два runtime:

KiloCode (VS Code плагин) — через .kilo/agents/ (@kilocode/plugin формат)
Claude Code (CLI / VS Code extension) — через .claude/commands/

Система спроектирована как Self-Healing Repository: агенты автоматически анализируют задачи, пишут код, тестируют, проводят ревью и деплоят, не переписывая одно и то же дважды благодаря встроенной памяти коммитов.

Структура репозитория

.
├── .claude/                                # Claude Code runtime
│   ├── commands/                           # 14 slash-команд (/project:*)
│   ├── rules/                              # Глобальные правила кодирования
│   └── logs/                               # История оценок агентов
├── .kilo/                                  # KiloCode plugin runtime
│   ├── agents/                             # 25 агентов (YAML frontmatter)
│   ├── commands/                           # 18 workflow команд
│   ├── skills/                             # 34+ специализированных навыка
│   ├── rules/                              # Правила кодирования
│   ├── workflows/                          # Workflow определения
│   ├── capability-index.yaml               # Индекс возможностей агентов
│   └── logs/                               # Логи эффективности
├── src/kilocode/                           # TypeScript API
├── archive/                                # Архив (устаревшие файлы)
├── AGENTS.md                               # Справка по агентам
└── README.md                               # Этот документ

Состав команды (25+ агентов)

Блок А: Вход и Планирование

#	Роль	Модель	Специализация
1	Requirement Refiner	Kimi-k2-thinking	Транслирует задачи в строгие технические чек-листы
2	Orchestrator	GLM-5	Главный диспетчер, управляет State Machine
3	History Miner	GPT-OSS 20B	Сканирует git log, предотвращает дублирование
4	Planner	GPT-OSS 120B	Декомпозиция задач (Chain of Thought)

Блок Б: Проектирование

#	Роль	Модель	Специализация
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 определений

Блок В: Производство

#	Роль	Модель	Специализация
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	Итеративно исправляет баги

Блок Г: Контроль Качества

#	Роль	Модель	Специализация
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 в зависимостях

Блок Д: Релиз и Самообучение

#	Роль	Модель	Специализация
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         │
└────────┬────────┘
         │
         ▼
┌─────────────────┐
│ 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
└─────────────────┘

Установка и использование

Вариант A: Claude Code (рекомендуется)

Глобальная установка

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/

После этого в любом проекте доступны команды /user:pipeline, /user:refine и т.д.

Установка в конкретный проект

git clone https://git.softuniq.eu/UniqueSoft/APAW.git
cp -r APAW/.claude /path/to/your-project/
cp -r APAW/.kilo /path/to/your-project/

Быстрый старт

# Полный цикл от идеи до релиза:
/project:pipeline добавить JWT авторизацию

# Или пошагово:
/project:refine хочу экспорт в PDF
/project:mine экспорт PDF           # Проверка дублей
/project:analyze экспорт PDF        # User story + acceptance criteria
/project:tests ...                  # TDD Red
/project:implement ...              # TDD Green

Таблица команд

Команда	Назначение
`/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

Вариант B: KiloCode (VS Code плагин)

git clone https://git.softuniq.eu/UniqueSoft/APAW.git
cp -r APAW/.kilo /your-project/

KiloCode автоматически обнаружит .kilo/ и загрузит всех агентов.

KiloCode Pipeline Agents

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

Прямой вызов агентов

@lead-developer implement authentication flow
@code-skeptic review the auth module
@security-auditor check for vulnerabilities

Agent Manager API

Установка

bun install
bun run build

Использование

import { 
  PipelineRunner, 
  GiteaClient, 
  decideRouting 
} from './src/kilocode/index.js'

const runner = await createPipelineRunner({
  giteaToken: process.env.GITEA_TOKEN,
  giteaApiUrl: 'https://git.softuniq.eu/api/v1'
})

const result = await runner.run({
  issueNumber: 42,
  files: ['src/auth.ts']
})

Gitea интеграция

const client = new GiteaClient({
  apiUrl: 'https://git.softuniq.eu/api/v1',
  token: process.env.GITEA_TOKEN
})

const issue = await client.getIssue(42)
await client.setStatus(42, 'implementing')
await client.createComment(42, {
  body: '## ✅ Implementation Complete'
})

Skills System

Система навыков в .kilo/skills/ обеспечивает специализацию агентов:

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

Integration & Workflow

Skill	Purpose
`gitea-commenting`	Gitea API integration
`gitea-workflow`	Workflow execution
`research-cycle`	Self-improvement cycle
`planning-patterns`	Task decomposition

Переменные окружения

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

15 KiB Raw Blame History Unescape Escape