Codebase Design

Fælles ordforråd til design af dybe moduler: interfaces, samlinger, adaptere, testbarhed

Af mxyhi · mxyhi/ok-skills

Testet · Virker ★ 9.2/10

Codebase Design — Fælles ordforråd til design af dybe moduler: interfaces, samlinger, adaptere, testbarhed

Hvad det gør

En færdighed med ordforråd og principper til design af dybe moduler – meget adfærd bag en lille interface, placeret ved en ren samling og testet gennem denne interface. Den udløses, når brugeren ønsker at designe eller forbedre et moduls interface, beslutte, hvor en samling skal placeres, klassificere afhængigheder til testning eller gøre kode mere testbar. To understøttende filer tilføjer en uddybende workflow (afhængighedskategorier, replace-don't-layer testning) og en parallel sub-agent 'design it twice'-proces.

Testrapport

Hentede alle tre filer råt (SKILL.md, DEEPENING.md, DESIGN-IT-TWICE.md alle HTTP 200); frontmatter parses med name+description, ingen scripts, ingen sikkerhedsbrister. Kørte en reel designopgave in-context — "design the interface for a rate-limiter guarding a third-party API" — og producerede en baseline-artefakt og en færdigheds-følgende artefakt. Konkret forskel: baseline eksponerede en 4-metodes Redis-koblet klasse (tryAcquire/getRemaining/reset/setLimit); færdighedsversionen kollapsede kalderfladen til ét guard(key, action) indgangspunkt, klassificerede Redis som kategori-2 lokalt-udskiftelig vs. SMS API'et som kategori-4 ægte-ekstern, og anvendte "two adapters = real seam" for at beholde lagerporten, mens uret blev skjult som en intern samling. Færdighedens indhold omformede målbart designet i stedet for blot at blive citeret tilbage.

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

Installation

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-designFælles ordforråd til design af dybe moduler: interfaces, samlinger, adaptere, testbarhed

Skills udløses af almindelige forespørgsler — ingen kommandoer at huske. Efter installationen 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