Przejdź do treści
Biblioteka skilli
Programowanie · Testowanie

eval-integration

/eval-integration

Ocenia ścieżki integrujące usługi zewnętrzne (Supabase, Stripe, Gemini API i inne API): kontrakty API, przepływy uwierzytelniania, trwałość danych, odzyskiwanie po błędach, konfigurację środowiska i spójność przepływu end-to-end.

Licencja
AGPL-3.0
Ostatnia zmiana repozytorium
27.09.2026

Ocena i bezpieczeństwo

100/ 100Klasa: dobry
Format25 / 25
Frontmatter z nazwą i opisem, poprawna nazwa, opis do 1024 znaków, nazwa zgodna z folderem.
Odkrywalność25 / 25
Opis mówi, kiedy użyć skilla, ma sensowną długość i jest w 3. osobie.
Treść35 / 35
Co najmniej 150 słów i do 500 linii, nagłówki, listy kroków, przykłady albo kod.
Higiena15 / 15
Bez zaślepek typu TODO, bez ścieżek Windows, z licencją.
Ryzykobrak sygnałów w skanie
Pliki w paczce
1
Skrypty
0
Komentarze HTML
0
Adresy URL w SKILL.md
0
Przestarzałość

Brak sygnałów. Repozytorium zmienione 27.09.2026, bez odwołań do wycofanych modeli i API.

Licencja

AGPL-3.0, copyleft: przeróbki udostępniane innym muszą mieć tę samą licencję.

Co robi i kiedy

Ocenia ścieżki integrujące usługi zewnętrzne (Supabase, Stripe, Gemini API i inne API): kontrakty API, przepływy uwierzytelniania, trwałość danych, odzyskiwanie po błędach, konfigurację środowiska i spójność przepływu end-to-end.

Wyzwalacze z opisu

integrationauthpaymentsapievaluate integrationtest auth flowcheck APIverify payments
Oryginalny opis (EN)

Specialized integration evaluator for the Evaluate-Loop. Use this for evaluating tracks that integrate external services — Supabase auth/DB, Stripe payments, Gemini API, third-party APIs. Checks API contracts, auth flows, data persistence, error recovery, environment config, and end-to-end flow integrity. Dispatched by loop-execution-evaluator when track type is 'integration', 'auth', 'payments', or 'api'. Triggered by: 'evaluate integration', 'test auth flow', 'check API', 'verify payments'.

Jak działa

  1. When This Evaluator Is Used
  2. Inputs Required
  3. Evaluation Passes (6 checks)
  4. Verdict Template
  5. Handoff
Sekcje z nagłówków SKILL.md, w oryginale · 206 linii, 1 064 słów
Podgląd SKILL.md
---
name: eval-integration
description: "Specialized integration evaluator for the Evaluate-Loop. Use this for evaluating tracks that integrate external services — Supabase auth/DB, Stripe payments, Gemini API, third-party APIs. Checks API contracts, auth flows, data persistence, error recovery, environment config, and end-to-end flow integrity. Dispatched by loop-execution-evaluator when track type is 'integration', 'auth', 'payments', or 'api'. Triggered by: 'evaluate integration', 'test auth flow', 'check API', 'verify payments'."
---

# Integration Evaluator Agent

Specialized evaluator for tracks that integrate external services — Supabase, Stripe, Gemini, or any third-party API.

## When This Evaluator Is Used

Dispatched by `loop-execution-evaluator` when the track involves:
- Authentication or database integration
- Payment processing integration
- AI/ML API integration
- Any external API connection

## Inputs Required

1. Track's `spec.md` and `plan.md`
2. Environment config (`.env.example`, env variable documentation)
3. API client code (`src/lib/`)
4. Database schema (if Supabase)
5. Webhook handlers (if Stripe)

## Evaluation Passes (6 checks)

### Pass 1: API Contract Verification

| Check | What to Look For |
|-------|-----------------|
| Request shapes | API calls send correct payload structure |
| Response handling | Responses parsed with correct types |
| Error responses | 4xx/5xx errors handled with user-friendly messaging |
| Rate limits | Rate limit handling present (retry, backoff, queue) |
| Timeout | Reasonable timeout set on API calls |
| Auth headers | Bearer token / API key sent correctly |

```markdown
### API Contracts: PASS ✅ / FAIL ❌
- Endpoints verified: [count]
- Missing error handling: [list]
- Type mismatches: [list]
```

### Pass 2: Authentication Flow

| Check | What to Look For |
|-------|-----------------|
| Sign up | Creates user, stores token, redirects to dashboard |
| Sign in | Validates credentials, stores token, redirects |
| Sign out | Clears token, redirects to home |
| Token refresh | Handles expired tokens (refresh or re-auth) |
| Protected routes | Unauthenticated users redirected to login |
| OAuth | Third-party login flow (if applicable) |

```markdown
### Auth Flow: PASS ✅ / FAIL ❌
- Flows tested: [sign up / sign in / sign out / token refresh]
- Broken flows: [list]
- Token handling: [correct / issues]
```

### Pass 3: Data Persistence & Schema Hygiene

**CRUD Operations:**

| Check | What to Look For |
|-------|-----------------|
| Create | Data saved correctly to database/storage |
| read_file | Data retrieved and rendered correctly |
| Update | Changes persisted on save |
| Delete | Records removed, UI reflects deletion |
| Relationships | Foreign keys / joins working correctly |
| Storage | File uploads stored and retrievable (if applicable) |

**Database Schema Quality (MANDATORY for all new tables/migrations):**

| Check | Requirement | Why |
|-------|-------------|-----|
| Timestamps | `created_at`, `updated_at` on ALL mutable tables | Debugging, audit trail, cache invalidation |
| Primary keys | UUID with default OR auto-increment | Data uniqueness |
| Foreign keys | Explicit cascade rules (`on delete cascade`) | Prevent orphaned data |
| Indexes | Index ALL foreign keys | Query performance |
| Null constraints | New columns nullable OR have defaults | Backward compatibility |
| Unique constraints | Composite uniques where needed | Data integrity |
| Version history | JSONB column for flexible history | Schema evolution |

**Schema Anti-Patterns to Flag:**

```sql
-- ❌ BAD: No timestamps
create table brands (
  id uuid primary key,
  name text
);

-- ✅ GOOD: Complete schema
create table brands (
  id uuid primary key default gen_random_uuid(),
  name text not null,
  created_at timestamptz default now() not null,
  updated_at timestamptz default now() not null
);

-- ❌ BAD: Foreign key without cascade
brand_id uuid references brands(id)

-- ✅ GOOD: Explicit cascade
brand_id uuid references brands(id) on delete cascade not null

-- ❌ BAD: New required column (breaks existing data)
alter table assets add column image_url text not null;

-- ✅ GOOD: Nullable or has default
alter table assets add column locked boolean default false;
```

```markdown
### Data Persistence & Schema: PASS ✅ / FAIL ❌
- CRUD operations: [which work / which fail]
- Data integrity: [any corruption or loss]
- Storage: [files accessible / issues]
- **Tables missing timestamps: [count] — [list]**
- **Foreign keys without indexes: [count] — [list]**
- **Migrations without defaults: [count] — [list]**
- **Orphaned data risk: [YES/NO — describe]**
```

### Pass 4: Error Recovery

| Check | What to Look For |
|-------|-----------------|
| Network failure | Offline/timeout → user sees error, can retry |
| Invalid data | Malformed responses → graceful fallback |
| Auth failure | Expired token → redirect to login, not crash |
| Payment failure | Declined card → clear message, can retry |
| API down | Service unavailable → error state, not blank screen |
| Partial failure | One API fails, others still work |

```markdown
### Error Recovery: PASS ✅ / FAIL ❌
- Scenarios tested: [list]
- Unhandled failures: [list]
- User messaging: [clear / missing]
```

### Pass 5: Environment Configuration

| Check | What to Look For |
|-------|-----------------|
| `.env.example` | All required variables documented |
| No secrets in code | No API keys, tokens, or passwords in source files |
| Environment switching | Dev/staging/prod configs separate |
| Missing vars | App handles missing env vars gracefully (error, not crash) |

```markdown
### Environment: PASS ✅ / FAIL ❌
- Variables documented: [YES/NO]
- Secrets in code: [NONE / list files with exposed secrets]
- Missing var handling: [graceful / crashes]
```

### Pass 6: End-to-End Flow

Walk through the complete user journey that involves this integration:

| Flow | Steps to Verify |
|------|----------------|
| Auth flow | Landing → Sign Up → Verify → Dashboard |
| Payment flow | Select plan → Checkout → Payment → Confirmation |
| Generation flow | Form → Generate → View → Download |

```markdown
### E2E Flow: PASS ✅ / FAIL ❌
- Flow tested: [describe]
- Steps completed: [X]/[Y]
- Broken at step: [which step, if any]
```

## Verdict Template

```markdown
## Integration Evaluation Report

**Track**: [track-id]
**Evaluator**: eval-integration
**Date**: [YYYY-MM-DD]
**Service**: [Supabase/Stripe/Gemini/etc.]

### Results
| Pass | Status | Issues |
|------|--------|--------|
| 1. API Contracts | PASS/FAIL | [details] |
| 2. Auth Flow | PASS/FAIL | [details] |
| 3. Data Persistence | PASS/FAIL | [details] |
| 4. Error Recovery | PASS/FAIL | [details] |
| 5. Environment | PASS/FAIL | [details] |
| 6. E2E Flow | PASS/FAIL | [details] |

### Verdict: PASS ✅ / FAIL ❌
[If FAIL, list specific fix actions for loop-fixer]
```

## Handoff

- **PASS** → Return to `loop-execution-evaluator` → Conductor marks complete
- **FAIL** → Return to `loop-execution-evaluator` → Conductor dispatches `loop-fixer`

Wersje

W bazie nie ma innych skilli o nazwie eval-integration.

Migawka bazy z 13.11.2026 · wersja paczki 16a463054ae9 (skrót SHA-256 całej paczki)

Pobrania w ostatnich 30 dniach: 0 · ranking

Zgłoś problem z tym skillem: szkodliwa treść, błędny opis albo prośba autora o usunięcie.

Podobne skille

  • 100loop-execution-evaluator
    Dyspozytor kroku 4 pętli Evaluate-Loop: ustala typ ścieżki i uruchamia właściwego wyspecjalizowanego oceniającego (UI/UX, jakość kodu, integracje, logika biznesowa) zamiast ogólnej listy kontrolnej.
  • 100eval-code-quality
    Ocenia jakość implementacji kodu w ścieżkach funkcji, tras API, zarządzania stanem i narzędzi: integralność buildu, bezpieczeństwo typów, wzorce, obsługa błędów, martwy kod, importy, pokrycie testami i nazewnictwo.
  • 90add-integration-test
    Dodaje testy integracyjne i end-to-end obejmujące kilka komponentów: trasy API z bazą, wywołania między usługami, wieloetapowe przepływy, trwałość danych, współbieżność i odzyskiwanie po awarii.
  • 90nextjs-supabase-auth
    Integruje Supabase Auth z Next.js App Router: logowanie, middleware uwierzytelniania i chronione trasy.
  • 100supabase-install-auth
    Instaluje i konfiguruje SDK oraz CLI Supabase wraz z kluczami API i inicjalizacją w projekcie.
  • 100api-integration
    Pomaga konsumować zewnętrzne API i integrować usługi zewnętrzne: typowane klienty API, przepływy uwierzytelniania i specyfikacje OpenAPI, GraphQL i REST, głównie w TypeScript.

Uwagi i zgłoszenia

Wiadomość trafi do Bartosza Sokolińskiego. Adres e-mail jest potrzebny tylko do odpowiedzi. Szczegóły w polityce prywatności.