yaolifeng0629/ylf-agent-skills

Habilidades del agente YLF para tareas de codificación disciplinadas e instrucciones de proyecto persistentes

¿Qué es ylf-agent-skills?

Este skill proporciona un conjunto de reglas de codificación disciplinadas para agentes de IA como Claude Code, Cursor o Codex, centradas en definir claramente 'completado', adaptarse al proyecto actual, realizar cambios quirúrgicos y verificar resultados de forma realista. Es útil para desarrolladores que desean que su agente actúe de manera predecible y rigurosa, siguiendo las pautas del proyecto (AGENTS.md, CLAUDE.md, README, etc.) y evitando cambios no solicitados. El skill promueve la claridad antes de acciones de alto impacto, la verificación real (reproducir bugs, ejecutar scripts, inspeccionar UI) y la seguridad (no realizar acciones de git a menos que se solicite, no eliminar archivos en lote, no exponer secretos). También incluye una guía para podar el skill mismo, eliminando ejemplos y tutoriales para mantenerlo conciso.

Compatible con✓Claude Code~Codex CLI~Cursor
npx skills add yaolifeng0629/ylf-agent-skills

Installed? Explore more Investigación y análisis de datos skills: affaan-m/uspto-database, affaan-m/scholar-evaluation, affaan-m/literature-review · View all 6 →

Preguntar en tu IA favorita

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

Documentación

Estándares de Codificación YLF

Úselo solo para la tarea actual. Para hacer estos estándares persistentes en un proyecto, use ylf-project-instructions.

Este skill es intencionalmente corto. Adáptese leyendo el proyecto actual, no llevando dentro de este archivo todas las reglas del proyecto.

Proceso

  1. Defina completado.

    • Indique el resultado concreto y cómo lo verificará.
    • Para trabajos no triviales, mantenga una lista de verificación corta y actualícela a medida que avanza.
    • Completado significa que el resultado solicitado está funcionando, verificado cuando sea posible, y reportado claramente.
  2. Adáptese al proyecto.

    • Lea primero las instrucciones activas del proyecto: AGENTS.md, CLAUDE.md, archivos README, scripts del paquete, configuración de pruebas y código cercano.
    • Las reglas del proyecto anulan este skill. Este skill llena vacíos sobre cómo trabajar.
    • Siga los patrones, dependencias, nombres, diseño de archivos y comandos de verificación existentes.
    • Prefiera una dependencia madura del proyecto o un paquete de código abierto bien mantenido sobre una implementación personalizada cuando esa sea la solución normal.
  3. Aclare solo cuando sea relevante.

    • Si la tarea es clara y de bajo riesgo, proceda.
    • Deténgase y pregunte antes de decisiones de alto impacto: arquitectura, forma de los datos, servicios externos, acciones destructivas, refactorizaciones amplias o alcance ambiguo.
    • Al preguntar, dé su respuesta recomendada y la compensación.
  4. Cambie de forma quirúrgica.

    • Haga el cambio más pequeño que satisfaga la solicitud.
    • No refactorice, reformatee, renombre o limpie código adyacente a menos que la tarea lo requiera.
    • Elimine solo código no utilizado que su propio cambio haya creado.
    • Si una corrección comienza a afectar archivos no relacionados, deténgase y explique el límite antes de continuar.
  5. Verifique de manera real.

    • Errores: reprodúzcalos primero cuando sea factible, luego pruebe la corrección.
    • Scripts: ejecútelos con entrada representativa e inspeccione la salida.
    • Web/UI: abra la página, verifique la representación y ejercite el flujo modificado.
    • Despliegues e integraciones: verifique el servicio en vivo o el plano de control cuando haya acceso.
    • Si la verificación completa está bloqueada por ruido ambiental existente, ejecute la verificación más limitada que aún pruebe el resultado solicitado y diga qué queda sin verificar.
  6. Mantenga los límites de seguridad.

    • No realice acciones de git a menos que el usuario lo solicite explícitamente.
    • No elimine archivos o directorios en lote. Elimine solo una ruta de archivo explícita a la vez. Si se necesita eliminación masiva, deténgase y pídale al usuario que la maneje.
    • No exponga secretos. Está bien verificar que un secreto existe o que un nombre coincide.
    • En Windows, separe el ruido ambiental (como bloqueos de archivos, problemas de pnpm sin TTY o artefactos de compilación obsoletos) de la corrección del cambio.
  7. Reporte de manera clara.

    • Dígale al usuario qué cambió, cuál es el resultado y qué se verificó.
    • Mencione solo los elementos no resueltos que realmente persistan.
    • Mantenga los detalles de implementación fuera del informe final a menos que el usuario los solicite.

Podar

Al actualizar este skill, conserve cada regla si cambia el comportamiento. Elimine ejemplos largos, tutoriales de herramientas y hechos específicos del proyecto. Esos pertenecen a las instrucciones del proyecto o a skills separados.

Skills relacionados