Codebase Design

Felles vokabular for design av dype moduler: grensesnitt, skjøter, adaptere, testbarhet

av mxyhi · mxyhi/ok-skills

Bestått ★ 9.2/10

Codebase Design — Felles vokabular for design av dype moduler: grensesnitt, skjøter, adaptere, testbarhet

Hva den gjør

En vokabular- og prinsippferdighet for design av dype moduler – mye atferd bak et lite grensesnitt, plassert ved en ren skjøt og testet gjennom det grensesnittet. Den utløses når brukeren ønsker å designe eller forbedre et moduls grensesnitt, bestemme hvor en skjøt skal være, klassifisere avhengigheter for testing, eller gjøre kode mer testbar. To støttefiler legger til en fordypende arbeidsflyt (avhengighetskategorier, replace-don't-layer testing) og en parallell underagent 'design it twice'-prosess.

Testrapport

Hentet alle tre filer rå (SKILL.md, DEEPENING.md, DESIGN-IT-TWICE.md alle HTTP 200); frontmatter parses med name+description, ingen skript, ingen sikkerhetsbrudd. Kjørte en reell designoppgave i kontekst – "design grensesnittet for en rate-limiter som beskytter et tredjeparts API" – og produserte en baseline-artefakt og en ferdighetsstyrt artefakt. Konkret forskjell: baseline eksponerte en 4-metoders Redis-koblet klasse (tryAcquire/getRemaining/reset/setLimit); ferdighetsversjonen reduserte kalloverflaten til ett guard(key, action) inngangspunkt, klassifiserte Redis som kategori-2 lokalt-erstattbar vs SMS API som kategori-4 ekte-ekstern, og anvendte "to adaptere = ekte skjøt" for å beholde lagringsporten mens klokken ble skjult som en intern skjøt. Ferdighetsteksten omformet designet målbart i stedet for bare å bli sitert tilbake.

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

Installer

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.

Kommandoer og eksempelprompter

  • /codebase-designFelles vokabular for design av dype moduler: grensesnitt, skjøter, adaptere, testbarhet

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

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