Coding Standards

Estándares agnósticos al lenguaje de anti-patrones, seguridad de tipos y desarrollo guiado por pruebas para revisiones y refactorizaciones

Por shinpr · shinpr/ai-coding-project-boilerplate

Funciona con configuración ★ 8.4/10

Coding Standards — Estándares agnósticos al lenguaje de anti-patrones, seguridad de tipos y desarrollo guiado por pruebas para revisiones y refactorizaciones

Qué hace

Una referencia universal de estándares de codificación que codifica la detección de anti-patrones (Rule of Three, SRP, DRY, supresión de errores, aserciones de tipo excesivas), reglas de seguridad de tipos (unknown + type guards sobre any/as), manejo de errores fail-fast, pruebas Red-Green-Refactor, puertas de análisis de impacto y valores predeterminados seguros. Se activa al implementar características, revisar código o refactorizar. Se aplica como guía en la ventana de contexto en lugar de ejecutar cualquier herramienta.

Informe de la prueba

Se obtuvo SKILL.md en .claude/skills-en/coding-standards/; el frontmatter tiene name+description. Se verificaron 3 rutas referenciadas mediante fetch raw — references/security-checks.md, implementation-approach/SKILL.md, typescript-rules/SKILL.md, todas HTTP 200; sin problemas de seguridad (el "Knowledge Cutoff Supplement" es informativo, no de inyección). Para OUTPUT escribí dos implementaciones de fetchUser(): la línea base devolvió `data as User` (sin validación); la versión siguiendo la habilidad usó `unknown` + un type guard isUser + un InvalidUserError fail-fast. Se ejecutó el guard en node contra `{id:42}`: la línea base pasa el objeto malformado tipado como User, el guard de la habilidad devuelve false, por lo que lanza un error — una diferencia observada concreta que coincide con las reglas de seguridad de tipos y fail-fast de la habilidad.

Probado el: 2026-07-31 · Claude Code 2.x (agent harness)

Instalación

# Copies the coding-standards skill (SKILL.md + references/) into ~/.claude/skills
git clone --depth 1 https://github.com/shinpr/ai-coding-project-boilerplate.git /tmp/coding-standards-src
mkdir -p ~/.claude/skills
cp -R /tmp/coding-standards-src/.claude/skills-en/coding-standards ~/.claude/skills/coding-standards
# Japanese variant also exists at .claude/skills-ja/coding-standards if preferred
# No external deps, scripts, or API keys required — pure guidance document

Comandos y prompts de ejemplo

/coding-standardsEstándares agnósticos al lenguaje de anti-patrones, seguridad de tipos y desarrollo guiado por pruebas para revisiones y refactorizaciones

Los skills se activan con peticiones en lenguaje natural, sin comandos que memorizar. Tras instalarlo, prompts como estos lo activan (en inglés):

Check this function for code smells
Review my pull request for anti-patterns
Refactor this module for readability

Informe completo →