Oma Backend

Backend-agent: router/service/repository-lagdeling, eksplisitte transaksjoner, ORM N+1-regler

av first-fluke · first-fluke/oh-my-agent

Krever oppsett ★ 7.6/10

Oma Backend — Backend-agent: router/service/repository-lagdeling, eksplisitte transaksjoner, ORM N+1-regler

Hva den gjør

En backend-implementeringsferdighet som håndhever en router til service til repository til modeller-splitt og kjører en fast analyse/plan/implementer/verifiser-protokoll for API, autentisering og persistensarbeid. Den inneholder en ORM-referanse (relasjonslastingsstrategi, transaksjonsgrenser, sesjon/klient-livssyklus, feltprojeksjon) og en pre-submit sjekkliste som dekker FK-indekser, paginering, inndatavalidering, parametriserte spørringer og miljøbasert konfigurasjon. Utløses ved forespørsler om å bygge REST- eller GraphQL-endepunkter, skrive migrasjoner, legge til JWT-autentisering, eller fikse trege spørringer i en serverkodebase.

Testrapport

Hentet SKILL.md pluss alle fem resources/*.md (checklist, execution-protocol, orm-reference, examples, error-playbook) — hver returnerte HTTP 200 og ../_shared/core/* eksisterer i treet; ingen curl|sh, base64 blobs, eller injeksjonstekst inne i ferdighetsfilene (repoets READMEs egen installatør er curl|bash, som er rammeverket, ikke ferdigheten). Kroppens referanser til stack/stack.yaml, stack/snippets.md og stack/api-template.* henger etter en enkel kopi — disse leveres som variants/{node,python,rust}/ — og execution-protocol.md Trinn 3 sier "Use stack/api-template.*" uten valgfri hekk. Triggerfraser vurdert: BØR utløses — "Add a POST /api/orders endpoint to our FastAPI service that creates an order and decrements stock", "Implement JWT login with refresh token rotation and rate limiting on the auth routes", "Our /api/posts list endpoint takes 2s, find the N+1 and fix the repository query" (alle 3 korrekte); BØR IKKE utløses — "Fix the flexbox layout on the pricing page, cards overflow on mobile" (korrekt ignorert), "Write API reference documentation for our existing REST endpoints in the README" (jeg ville lastet den, siden beskrivelsen bokstavelig talt sier "Use for API, endpoint, REST ... work" — falsk positiv, så 4/5). For utdata kjørte jeg en oppgave på begge måter: grunnlinjen looper session.get(Product) per linje (N spørringer, ingen radlås, tapt-oppdateringsrace på lager), hadde ingen eager loading på listeendepunktet (en reell MissingGreenlet-feil under async SQLAlchemy), ingen paginering, ingen quantity>0-validering, og forretningslogikk i rutebehandleren; ferdighetsversjonen produserte en batchet SELECT ... FOR UPDATE, selectinload på Order.items, markørpaginering med en grense, en eksplisitt "async with session.begin()" arbeidsenhet, domeneunntak bak en sentral handler, en FK-indeksmigrasjon, og en navngitt restriksjonsrisiko (with_for_update er en no-op på SQLite). Ærlighetsforbehold: Jeg hadde allerede lest ferdighetskroppen før jeg skrev grunnlinjen, så grunnlinjen er mitt ekte standardmønster, men ble ikke skrevet blindt; artefakter er på /private/tmp/claude-501/-Users-afin-Desktop-Skill-Agregator/94648f54-e301-46fc-afd8-b98858a51ecf/scratchpad/omabk-baseline.md og omabk-skill.md.

Testet på: 2026-07-21 · Claude Code 2.x (agent harness)

Installer

# clone the harness (the skill references ../_shared, so copy that too)
git clone --depth 1 https://github.com/first-fluke/oh-my-agent /tmp/oma
mkdir -p ~/.claude/skills
cp -R /tmp/oma/.agents/skills/oma-backend ~/.claude/skills/
cp -R /tmp/oma/.agents/skills/_shared   ~/.claude/skills/

# optional: materialize the stack/ folder the body references, from a variant
cp -R ~/.claude/skills/oma-backend/variants/python ~/.claude/skills/oma-backend/stack

# alternatives (whole suite): bunx oh-my-agent@latest
#   or: apm install first-fluke/oh-my-agent/.agents/skills/oma-backend

Kommandoer og eksempelprompter

/oma-backendBackend-agent: router/service/repository-lagdeling, eksplisitte transaksjoner, ORM N+1-regler

Skills utløses av vanlige forespørsler — ingen kommandoer å huske. Etter installasjonen aktiverer prompter som disse skillen (på engelsk):

Add a new REST endpoint following our clean architecture
Set up database migrations for this feature
Implement authentication in the service layer

Full rapport →