AI Development Guide

Kritéria pro revizi backend kódu: anti-patterny, fail-fast chyby, Pravidlo tří, brány kvality

od shinpr · shinpr/claude-code-workflows

Otestováno · Funguje ★ 8.8/10

AI Development Guide — Kritéria pro revizi backend kódu: anti-patterny, fail-fast chyby, Pravidlo tří, brány kvality

Co umí

Průvodce v próze, který poskytuje Claudeovi jazykově agnostická a backend technická kritéria pro rozhodování: katalog anti-patternů, detekce fail-fast maskování chyb, pravidla duplikace Pravidla tří, analýza dopadu a univerzální pracovní postup kontroly kvality. Spouští se při revizi backendových/obecných implementačních voleb, code smells, řetězců selhání nebo posuzování úplnosti implementace. Čisté vedení, žádné skripty ani externí závislosti.

Testovací report

Načteno přes GitHub API; nalezeno 5 bajtově identických kopií SKILL.md (top-level skills/ a čtyři dev-workflows* plugin adresáře) — použita top-level. Frontmatter se parsuje s name+description; tělo je čistá próza s nulovými odkazy na skripty/soubory, žádné pevně zakódované cesty, žádné bezpečnostní rizika. Čistě nainstalováno do dočasného HOME. Test spouštění: 3 fráze pro revizi/ladění/úplnost jej načetly, 2 sousední (vytvořit React dropdown; napsat blogový příspěvek o API) správně nenačetly — 5/5. Test výstupu: zkontrolován 3funkční Python vzorek s tichými except-returns-default záložními mechanismy a téměř duplikátem uživatele/administrátora. Základní revize doporučila "extrahovat sdíleného pomocníka pro odstranění duplikace"; revize s dovedností dala opačné, sledovatelné doporučení — "NEextrahujte sdíleného pomocníka zatím" podle tabulky Pravidla tří (2. výskyt = pouze zvážit) plus upozornění, že uživatelé vs. administrátoři se mohou lišit — a přeformulovala záložní mechanismus slevy jako nepřijatelný bez definované smlouvy o obnově namísto "jen to zalogujte" základní verze.

Testováno: 2026-07-21 · Claude Code 2.x (agent harness)

Instalace

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.).

Příkazy a ukázkové prompty

  • /ai-development-guideKritéria pro revizi backend kódu: anti-patterny, fail-fast chyby, Pravidlo tří, brány kvality

Skilly se spouštějí běžnými požadavky — žádné příkazy k zapamatování. Po instalaci ho aktivují prompty jako tyto (anglicky):

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