AI Development Guide

Kryteria przeglądu kodu backendu: antywzorce, błędy fail-fast, Reguła Trzech, bramki jakości

Autor: shinpr · shinpr/claude-code-workflows

Testowano · Działa ★ 8.8/10

AI Development Guide — Kryteria przeglądu kodu backendu: antywzorce, błędy fail-fast, Reguła Trzech, bramki jakości

Co robi ten skill

Przewodnik w prozie, który dostarcza Claude'owi niezależne od języka i techniczne kryteria decyzyjne dla backendu: katalog antywzorców, wykrywanie maskowania błędów fail-fast, zasady duplikacji Reguły Trzech, analiza wpływu i uniwersalny przepływ pracy kontroli jakości. Uruchamia się podczas przeglądania wyborów implementacyjnych backendu/ogólnych, zapachów kodu, łańcuchów awarii lub oceny kompletności implementacji. Czyste wskazówki, bez skryptów i zewnętrznych zależności.

Raport z testu

Pobrano za pośrednictwem GitHub API; znaleziono 5 identycznych bajtowo kopii SKILL.md (top-level skills/ i cztery katalogi wtyczek dev-workflows*) — użyto tej z najwyższego poziomu. Frontmatter parsowany z name+description; treść to czysta proza bez odwołań do skryptów/plików, bez zakodowanych na stałe ścieżek, bez zagrożeń bezpieczeństwa. Zainstalowano czysto w tymczasowym HOME. Test wyzwalacza: 3 frazy dotyczące przeglądu/debugowania/kompletności załadowały go, 2 sąsiednie (zbuduj rozwijaną listę React; napisz post na blogu API) poprawnie tego nie zrobiły — 5/5. Test wyjściowy: przejrzano 3-funkcyjny przykład Python z cichymi powrotami do wartości domyślnych w przypadku wyjątku i prawie duplikatem użytkownika/administratora. Przegląd bazowy zalecił „wyodrębnienie wspólnego pomocnika w celu usunięcia duplikacji”; przegląd z użyciem umiejętności dał przeciwne, możliwe do śledzenia zalecenie — „NIE wyodrębniaj jeszcze wspólnego pomocnika” zgodnie z tabelą Reguły Trzech (drugie wystąpienie = tylko rozważ) plus zastrzeżenie, że użytkownicy vs administratorzy mogą się różnić — i przeformułował awaryjne rozwiązanie zniżkowe jako niedopuszczalne w przypadku braku zdefiniowanej umowy odzyskiwania, zamiast bazowego „po prostu zaloguj to”.

Testowano: 2026-07-21 · Claude Code 2.x (agent harness)

Instalacja

git clone --depth 1 https://github.com/shinpr/claude-code-workflows.git /tmp/ai-development-guide-src
mkdir -p ~/.claude/skills
cp -R /tmp/ai-development-guide-src/skills/ai-development-guide ~/.claude/skills/ai-development-guide
# Pure-prose SKILL.md (~293 lines), no scripts, no external deps, no API keys.
# Repo ships 5 identical copies (top-level skills/ + four dev-workflows* plugin dirs);
# the top-level skills/ copy above is the clean standalone install.
# Plugin-marketplace alternative: install the `dev-workflows` plugin from this repo
# to get the full recipe workflow (/recipe-implement, /recipe-design, etc.).

Komendy i przykładowe prompty

/ai-development-guideKryteria przeglądu kodu backendu: antywzorce, błędy fail-fast, Reguła Trzech, bramki jakości

Skille uruchamiają się na zwykłe polecenia — bez komend do zapamiętania. Po instalacji aktywują go prompty takie jak te (po angielsku):

Check this code for common anti-patterns
Help me decide between these two architecture options
Run a quality check workflow on this feature

Pełny raport →