Skip to content
Back to skills

Refactor Harness

ASecurity

Graba casos dorados de un módulo antes de refactorizarlo y los reproduce después, ejecutando solo con permiso explícito y tratando la excepción como conducta observable.

  • 2 stars
  • 0 votes
  • 0 copies
  • 0 views
  • Added November 18, 2026
ai-agentsgobashvue

Security analysis

A100/100

Scanned November 18, 2026

npx -y skills add alberto2005-coder/skills-ia --skill refactor-harness --agent claude-code

Installs into .claude/skills of the current project.

Are you the author of Refactor Harness?

Add the live security badge to your README. It updates with every re-scan.

Security grade badge for Refactor Harness
[![Security: A — Skills Directory](https://www.skillsdirectory.com/api/skills/alberto2005-coder-refactor-harness/badge)](https://www.skillsdirectory.com/skills/alberto2005-coder-refactor-harness)

More formats (shields.io, HTML) on the badges page. Keep it an A: scan every change in CI with Pro.

Download with Pro
SKILL.md
---
name: refactor-harness
description: Graba casos dorados de un módulo antes de refactorizarlo y los reproduce después, ejecutando solo con permiso explícito y tratando la excepción como conducta observable.
license: MIT
metadata:
  package: refactor-surgeon
  version: "1.4.0"
---

# Refactor Harness

## Objetivo

Tener una red de seguridad barata cuando el módulo no tiene tests: congelar qué devuelve cada llamada antes de tocar una línea.

## Instrucciones de ejecución

1. Declara los casos en un JSON con el módulo y las llamadas:

```json
{"module": "src/app.py", "cases": [{"function": "sumar", "args": [1, 2]}]}
```

2. Graba antes del cambio y verifica después:

```bash
py refactor-surgeon/scripts/golden_harness.py --cases cases.json --snapshot golden.json --record --allow-exec
py refactor-surgeon/scripts/golden_harness.py --cases cases.json --snapshot golden.json --verify --allow-exec
```

3. Sin `--allow-exec` solo valida el fichero de casos: importar y ejecutar código ajeno es una decisión explícita.

## Reglas

- Los casos cubren el camino feliz y los bordes conocidos; una excepción también se graba con su tipo y mensaje.
- El snapshot se versiona junto al cambio para que la comparación sobreviva a la sesión.
- Un caso que no se puede ejecutar sin efectos externos se declara fuera del arnés.

## Límites

- Ejecuta el módulo en el proceso actual: sin aislamiento y sin límite de tiempo propio.
- No genera casos por sí solo a partir de la firma: los declara quien refactoriza.
- La comparación es por resultado serializado; un objeto que no es serializable se compara como texto.

## Gate de salida

- Snapshot grabado antes del primer corte.
- Verificación sin discrepancias sobre el código refactorizado.
- Los casos no cubiertos se nombran como riesgo aceptado.

## Handoff

Entrega a `refactor-verify` el snapshot y la lista de casos; si ya hay tests, añade este arnés solo para lo que los tests no tocan.

Attribution

Is this your skill, or is something wrong with this listing? Request removal or report an issue. Author removals are honored within 72 hours.

View all in ai-agents →

Comments

Loading comments…

Newsletter

Get the weekly list of safe new skills, and the ones we pulled.