SkillProof tested Claude skills

Codebase Design

Wspólne słownictwo do projektowania głębokich modułów: interfejsy, szwy, adaptery, testowalność

Autor: mxyhi · mxyhi/ok-skills

Testowano · Działa ★ 9.2/10

Codebase Design — Wspólne słownictwo do projektowania głębokich modułów: interfejsy, szwy, adaptery, testowalność

Co robi ten skill

Umiejętność słownictwa i zasad do projektowania głębokich modułów — wiele zachowań za małym interfejsem, umieszczonych w czystym szwie i testowanych przez ten interfejs. Uruchamia się, gdy użytkownik chce zaprojektować lub ulepszyć interfejs modułu, zdecydować, gdzie umieścić szew, sklasyfikować zależności do testowania lub uczynić kod bardziej testowalnym. Dwa pliki pomocnicze dodają pogłębiający przepływ pracy (kategorie zależności, testowanie replace-don't-layer) oraz równoległy proces subagenta „design it twice”.

Raport z testu

Pobrano wszystkie trzy pliki raw (SKILL.md, DEEPENING.md, DESIGN-IT-TWICE.md wszystkie HTTP 200); frontmatter parsuje z name+description, brak skryptów, brak zagrożeń bezpieczeństwa. Przeprowadzono rzeczywiste zadanie projektowe w kontekście — „zaprojektuj interfejs dla ogranicznika prędkości chroniącego API strony trzeciej” — tworząc artefakt bazowy i artefakt zgodny z umiejętnością. Konkretna różnica: punkt odniesienia ujawnił klasę Redis-coupled z 4 metodami (tryAcquire/getRemaining/reset/setLimit); wersja umiejętności skróciła powierzchnię wywołującą do jednego punktu wejścia guard(key, action), sklasyfikowała Redis jako kategorię 2 lokalnie-zastępowalną w porównaniu do SMS API jako kategorię 4 prawdziwie-zewnętrzną i zastosowała „dwa adaptery = prawdziwy szew”, aby zachować port magazynu, ukrywając zegar jako wewnętrzny szew. Treść umiejętności mierzalnie przekształciła projekt, zamiast być tylko cytowana.

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

Instalacja

git clone --depth 1 https://github.com/mxyhi/ok-skills.git /tmp/codebase-design-src
mkdir -p ~/.claude/skills
cp -R /tmp/codebase-design-src/codebase-design ~/.claude/skills/codebase-design
# Pure markdown skill: SKILL.md + DEEPENING.md + DESIGN-IT-TWICE.md. No deps, scripts, or API keys.
# DESIGN-IT-TWICE.md references a project-local CONTEXT.md (your own domain vocab) which is not shipped and is optional.

Komendy i przykładowe prompty

  • /codebase-designWspólne słownictwo do projektowania głębokich modułów: interfejsy, szwy, adaptery, testowalność

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

  • Help me design a deeper interface for this module
  • Find deepening opportunities in this class
  • Decide where the seam should go in this code

Pełny raport →