SkillProof tested Claude skills

Codebase Design

Sdílená slovní zásoba pro návrh hlubokých modulů: rozhraní, švy, adaptéry, testovatelnost

od mxyhi · mxyhi/ok-skills

Otestováno · Funguje ★ 9.2/10

Codebase Design — Sdílená slovní zásoba pro návrh hlubokých modulů: rozhraní, švy, adaptéry, testovatelnost

Co umí

Dovednost pro slovní zásobu a principy pro návrh hlubokých modulů — mnoho chování za malým rozhraním, umístěným na čistém švu a testovaným přes toto rozhraní. Spouští se, když uživatel chce navrhnout nebo vylepšit rozhraní modulu, rozhodnout, kam umístit šev, klasifikovat závislosti pro testování nebo učinit kód testovatelnějším. Dva podpůrné soubory přidávají prohlubující pracovní postup (kategorie závislostí, testování replace-don't-layer) a paralelní proces sub-agenta "design it twice".

Testovací report

Načteny všechny tři soubory raw (SKILL.md, DEEPENING.md, DESIGN-IT-TWICE.md všechny HTTP 200); frontmatter se parsuje s name+description, žádné skripty, žádné bezpečnostní problémy. Spuštěna skutečná návrhová úloha v kontextu — "navrhnout rozhraní pro rate-limiter chránící API třetí strany" — což vedlo k základnímu artefaktu a artefaktu podle dovednosti. Konkrétní rozdíl: základní verze odhalila třídu Redis-coupled se 4 metodami (tryAcquire/getRemaining/reset/setLimit); verze dovednosti zúžila povrch volajícího na jeden vstupní bod guard(key, action), klasifikovala Redis jako category-2 local-substitutable oproti SMS API jako category-4 true-external a aplikovala "two adapters = real seam" pro zachování portu úložiště a skrytí hodin jako interního švu. Tělo dovednosti měřitelně přetvořilo design, spíše než aby bylo jen citováno zpět.

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

Instalace

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.

Příkazy a ukázkové prompty

  • /codebase-designSdílená slovní zásoba pro návrh hlubokých modulů: rozhraní, švy, adaptéry, testovatelnost

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

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

Kompletní testovací report (anglicky) →