SkillProof tested Claude skills

Codebase Design

Vocabolario condiviso per la progettazione di moduli profondi: interfacce, giunzioni, adattatori, testabilità

di mxyhi · mxyhi/ok-skills

Promosso ★ 9.2/10

Codebase Design — Vocabolario condiviso per la progettazione di moduli profondi: interfacce, giunzioni, adattatori, testabilità

Cosa fa

Una skill di vocabolario e principi per la progettazione di moduli profondi — molto comportamento dietro una piccola interfaccia, posizionata in una giunzione pulita e testata tramite quell'interfaccia. Si attiva quando l'utente vuole progettare o migliorare l'interfaccia di un modulo, decidere dove posizionare una giunzione, classificare le dipendenze per i test o rendere il codice più testabile. Due file di supporto aggiungono un flusso di lavoro di approfondimento (categorie di dipendenza, testing 'replace-don't-layer') e un processo parallelo di sub-agente 'design it twice'.

Rapporto di test

Tutti e tre i file recuperati raw (SKILL.md, DEEPENING.md, DESIGN-IT-TWICE.md tutti HTTP 200); il frontmatter viene analizzato con name+description, nessun script, nessun problema di sicurezza. Eseguito un compito di progettazione reale nel contesto — "design the interface for a rate-limiter guarding a third-party API" — producendo un artefatto baseline e un artefatto guidato dalla skill. Differenza concreta: la baseline esponeva una classe Redis-coupled con 4 metodi (tryAcquire/getRemaining/reset/setLimit); la versione della skill ha ridotto la superficie del chiamante a un singolo punto di ingresso guard(key, action), ha classificato Redis come categoria-2 sostituibile localmente rispetto all'API SMS come categoria-4 veramente esterna, e ha applicato "due adattatori = vera giunzione" per mantenere la porta dello store nascondendo l'orologio come giunzione interna. Il corpo della skill ha rimodellato misurabilmente il design piuttosto che essere semplicemente citato.

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

Installazione

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.

Comandi e prompt di esempio

  • /codebase-designVocabolario condiviso per la progettazione di moduli profondi: interfacce, giunzioni, adattatori, testabilità

Gli skill si attivano con richieste in linguaggio naturale, senza comandi da ricordare. Dopo l'installazione, prompt come questi lo attivano (in inglese):

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

Rapporto completo →