icpg

Visión general de la skill icpg

Qué hace la skill icpg

La skill icpg añade una “capa WHY” a la comprensión de código. En lugar de limitarse a mapear la estructura, vincula funciones, clases y módulos con la razón por la que existen, quién los mantiene y si siguen alineados con su intención original. Si necesitas icpg para Code Review, refactorización o mantenimiento autónomo, su valor principal es reducir la incertidumbre antes de cambiar código.

Para quién es más útil

icpg encaja bien con ingenieros y agentes que trabajan en bases de código activas, donde el comportamiento, la responsabilidad y la intención de diseño importan más que un análisis rápido de la sintaxis. Resulta especialmente útil cuando un repo ha acumulado deriva, el historial de tareas es poco claro o aparecen preguntas repetidas del tipo “¿por qué se escribió esto?”.

Qué la diferencia

La skill se centra en ReasonNodes, contratos formales y detección de deriva en varias dimensiones. Eso significa que icpg no es solo un mapa de código; es una capa de apoyo a la toma de decisiones para el análisis previo a una tarea. La ventaja práctica es una mayor seguridad en los cambios, más contexto claro para la revisión y menos ediciones que violan silenciosamente la intención original.

Cómo usar la skill icpg

Instala y localiza el archivo principal

Sigue el flujo de instalación de skills del repo y empieza por skills/icpg/SKILL.md. Como este repositorio no expone scripts auxiliares ni carpetas de apoyo, el propio archivo de la skill es la principal fuente de verdad. Para decidir rápidamente si merece la pena instalarlo, lee primero el frontmatter y las secciones iniciales antes que nada.

Convierte un objetivo vago en un prompt útil

icpg usage funciona mejor cuando das una tarea concreta, una ruta de destino y la forma de salida que esperas. Buenas entradas serían: “Revisa src/payments/charge.ts en busca de deriva de intención antes de cambiar la lógica de reintentos” o “Inicializa ReasonNodes para el flujo de auth e identifica enlaces de ownership que faltan”. Entradas débiles como “analiza este repo” son demasiado amplias y suelen desaprovechar las fortalezas de la skill para seguir la intención.

Flujo de trabajo sugerido para el primer uso

Empieza preguntando cuál era el propósito previsto del código objetivo; después, qué restricciones o contratos lo protegen; y por último, dónde es probable que haya deriva. Esa secuencia encaja con el diseño de la skill y ayuda al agente a pasar de estructura a intención y de intención a riesgo. En flujos de icpg guide, mantén la solicitud centrada en un módulo o un conjunto de cambios, no en todo el repositorio.

Qué leer primero en el repo

Empieza por SKILL.md, especialmente la declaración de propósito, los ejemplos de CLI y las secciones que cubren el principio central, las consultas canónicas previas a la tarea, ReasonNode y los tipos de aristas. Esas son las piezas con más probabilidad de influir en la decisión de adopción y en la calidad de la salida de icpg para Code Review.

Preguntas frecuentes sobre la skill icpg

¿icpg es solo para agentes autónomos?

No. icpg es útil para personas y agentes, pero resulta más convincente cuando el sistema necesita un razonamiento previo a la tarea que se pueda repetir. Si solo quieres un resumen puntual, un prompt normal puede bastar; si buscas Code Review con conciencia de intención o planificación de cambios, icpg encaja mejor.

¿En qué se diferencia icpg de un prompt genérico de código?

Un prompt genérico puede resumir código, pero icpg está pensado para conservar la intención, la responsabilidad y el contexto de deriva entre tareas. Eso lo hace más útil cuando necesitas responder “¿para qué sirve este código?” antes de modificarlo, no solo “¿qué hace este código?”.

¿icpg es adecuado para principiantes?

Sí, se puede usar siendo principiante, pero los mejores resultados llegan cuando puedes nombrar con precisión un archivo, una funcionalidad o el límite de un cambio. Si eres nuevo en el repo, empieza con un solo módulo y pide intención, restricciones y riesgos de revisión en lugar de un análisis de todo el sistema.

¿Cuándo no debería usar icpg?

Evita icpg cuando la tarea sea trivial, el código esté aislado o solo necesites una explicación rápida y superficial. Tampoco encaja bien si no puedes proporcionar un área objetivo o contexto de cambio, porque el valor de la skill depende de relacionar el código con una razón concreta para existir.

Cómo mejorar la skill icpg

Aporta un contexto de tarea más sólido

Los mejores resultados de icpg llegan con prompts que incluyen el objetivo del cambio, los archivos afectados y lo que no debe romperse. Por ejemplo, “revisa src/billing en busca de deriva después de la nueva regla fiscal” es más sólido que “revisa el código de billing”. Eso ayuda a la skill a extraer los ReasonNodes y las restricciones correctas para icpg for Code Review.

Pide intención antes de implementación

Un fallo habitual es pasar directamente a editar sin preguntar qué debía proteger el código. Mejora la salida pidiendo primero el propósito original, el contrato actual y la deriva sospechada; después, el plan de cambio. Ese orden reduce regresiones innecesarias y hace que el resultado de revisión sea más fácil de confiar.

Usa la primera respuesta para afinar la segunda

Si la primera pasada es demasiado amplia, acota el alcance por módulo, paso del flujo de trabajo o límite de ownership. Si la respuesta es demasiado superficial, pide el contrato que falta, la dimensión de deriva más probable o la consulta canónica previa a la tarea que mejor encaje con el trabajo. Iterar así suele mejorar la señal más que pedir una respuesta más larga.

Mantén el prompt alineado con el diseño de la skill

La icpg skill es más fuerte cuando pides seguimiento de razones, detección de deriva y análisis previo a la tarea, no solo explicación de código. Si quieres mejorar icpg usage, incluye qué significa “hecho”, qué tipo de cambio estás considerando y qué parte de la base de código entra en el alcance.