CommunityRedacción y edicióngithub.com

ProgramAsWeights (PAW)

Compila especificaciones en lenguaje natural en funciones neuronales locales para clasificación, extracción y coincidencia difusa en tu agente de codificación de IA.

¿Qué es ProgramAsWeights (PAW)?

ProgramAsWeights (PAW) es una habilidad diseñada para agentes de IA de codificación (como Claude Code, Cursor y Codex) que permite compilar especificaciones en lenguaje natural en funciones neuronales diminutas que se ejecutan localmente, sin depender de servidores externos ni conexiones a internet después de la compilación inicial. Está optimizado para tareas de texto a texto como clasificación, extracción de datos, reparación de formatos y coincidencia difusa, ofreciendo un reemplazo rápido y económico para expresiones regulares frágiles o costosas llamadas a LLM por elemento. Funciona principalmente con Python a través del SDK `programasweights`, pero también admite JavaScript/WebAssembly para navegadores. La habilidad enfatiza un flujo de trabajo iterativo: revisar el Hub en busca de funciones precompiladas, compilar el propio especificación con ejemplos y una restricción de salida explícita, y luego iterar con casos de prueba para refinar la precisión. Es ideal para desarrolladores que necesitan soluciones de procesamiento de texto locales, rápidas y predecibles, evitando la latencia y el costo de las API de LLM para tareas bien definidas.

Compatible con~Claude Code~Codex CLI~Cursor
npx skills add tolimcn7786/skills

Installed? Explore more Redacción y edición skills: steipete/notion, langchain-ai/langchain, bytedance/podcast-generation · View all 6 →

Preguntar en tu IA favorita

Abre un nuevo chat con esta habilidad de agente ya precargada.

Documentación

¿Qué hace ProgramAsWeights (PAW)?

ProgramAsWeights compila una breve especificación en lenguaje natural en una función neuronal diminuta ("software neuronal") que toma una entrada de texto y devuelve una salida de texto y se ejecuta localmente. Compilas una vez en la API alojada; la función resultante luego se ejecuta localmente y sin conexión para siempre.

Cuándo usar esto

Recurre a PAW cuando una tarea es difusa texto -> texto y la deseas barata, rápida, local y repetible:

  • Clasificación / categorización - sentimiento, urgencia, intención, tema, spam o líneas de registro ALERTA vs TRANQUILO.
  • Extracción - extraer correos electrónicos, nombres, fechas, IDs o campos de texto desordenado/no estructurado.
  • Reparación de formato / normalización - arreglar JSON roto, normalizar fechas, limpiar entradas inconsistentes.
  • Coincidencia difusa - coincidencia tolerante a errores tipográficos, detección de casi duplicados, mapear una frase a la opción más cercana.
  • Triaje / enrutamiento - filtrar ruido de registros, enrutar una solicitud al controlador correcto.

Reemplaza una expresión regular frágil o una costosa llamada LLM por elemento con una función pequeña que, después de compilar, se ejecuta en aproximadamente 0.05-0.5s localmente sin red.

Cuándo NO usarlo

  • Generación larga o abierta (ensayos, código, chat) - usa un LLM completo.
  • Razonamiento de múltiples pasos, matemáticas o tareas que necesitan amplio conocimiento del mundo.
  • Cualquier cosa que no sea una sola entrada de texto -> una sola salida de texto. Las funciones son sin estado y comparten una ventana de ~2048 tokens entre especificación + entrada + salida.

Cómo usarlo (el flujo de trabajo)

1. Revisa el Hub primero. Alguien puede haber publicado una función; prueba un slug antes de compilar:

import programasweights as paw

fn = paw.function("email-triage")   # descarga una vez, luego se ejecuta localmente
fn("¡Urgente: el servidor está caído!")        # "inmediato"
fn("Boletín: picnic de primavera")            # "esperar"

2. De lo contrario, compila tu propia. Una buena especificación es una descripción MÁS algunos ejemplos Entrada: ... Salida: ... y una restricción de salida explícita:

import programasweights as paw

fn = paw.compile_and_load("""
Clasificar tickets de soporte. Devuelve SOLO uno de: facturación, error, función, otro.

Entrada: Me cobraron dos veces este mes
Salida: facturación

Entrada: El botón de exportar no hace nada
Salida: error

Entrada: Por favor añadan un modo oscuro
Salida: función
""")

fn("me volvieron a cobrar la tarjeta")   # "facturación"

3. Itera con casos de prueba - la práctica #1. No aceptes el primer resultado. Construye un pequeño conjunto de pares entrada/esperado, mide la precisión, luego refina el texto y los ejemplos y recompila hasta que sea lo suficientemente bueno. Trátalo como software: prueba, depura los fallos específicos, corrige la especificación, vuelve a probar. Un bucle de evaluación mínimo:

import programasweights as paw

tests = [
    {"input": "Me cobraron dos veces este mes", "expected": "facturación"},
    {"input": "El botón de exportar no hace nada", "expected": "error"},
    {"input": "Por favor añadan un modo oscuro",  "expected": "función"},
]

fn = paw.compile_and_load(open("spec.txt").read())
results = [(t, fn(t["input"]).strip()) for t in tests]
misses = [(t, got) for t, got in results if got != t["expected"]]
print(f"precisión: {(len(tests) - len(misses)) / len(tests):.0%}")
for t, got in misses:        # inspecciona fallos, luego corrige la especificación + recompila
    print("FALLO:", t["input"], "-> obtuvo", repr(got), "deseaba", repr(t["expected"]))

Consulta references/writing-good-specs.md para saber cómo depurar los fallos.

4. Guarda el id del programa o slug y reutilízalo localmente. La inferencia no necesita servidor después de la primera descarga del activo.

Instalación

pip install programasweights --extra-index-url https://pypi.programasweights.com/simple/

Navegador / JavaScript: npm install @programasweights/web. Las funciones compiladas con compiler="paw-4b-gpt2" se ejecutan en el lado del cliente a través de WebAssembly. Consulta references/browser-sdk.md.

Qué se ejecuta dónde (flujo de datos - lee antes de usar)

  • Compilar envía tu especificación a la API de PAW alojada (https://programasweights.com) y devuelve un id de programa. No pongas secretos en una especificación.
  • La inferencia se ejecuta localmente a través del SDK y funciona sin conexión después de la primera descarga.
  • La autenticación es opcional - el uso anónimo funciona. Inicia sesión solo para límites de compilación más altos y slugs con nombre (export PAW_API_KEY=paw_sk_...).

Más detalles (cargar bajo demanda)

  • API completa, compiladores, versionado, encadenamiento, autenticación: references/api.md
  • Escribir y depurar especificaciones: references/writing-good-specs.md
  • SDK de navegador / JavaScript: references/browser-sdk.md
  • Errores comunes y correcciones: references/troubleshooting.md
  • Casos de estudio prácticos (monitoreo de registros, búsqueda semántica, llamada a herramientas): https://programasweights.readthedocs.io

Skills relacionados