AlanWYChen/agent-skills

Guía el desarrollo de aplicaciones de producción en web, móvil y sistemas backend. Útil al implementar o auditar flujos de trabajo de producción; enruta al dominio aplicable y la orientación de apoyo correspondiente.

¿Qué es agent-skills?

Este conjunto de habilidades de agente, enrutado por dominio, está diseñado para guiar a los desarrolladores durante el desarrollo de aplicaciones de producción. Cubre tres dominios principales: aplicaciones web basadas en navegador, aplicaciones móviles (iOS, Android y multiplataforma) y sistemas backend (API, servicios, workers, colas, sistemas de datos y plataformas). En lugar de ofrecer consejos genéricos, proporciona orientación específica para cada dominio sobre temas como seguridad, observabilidad, pruebas, CI/CD y autenticación. El paquete incluye flujos de trabajo compartidos, como una política para Dependabot en la gestión de actualizaciones de dependencias. El proceso de enrutamiento requiere que el agente identifique el dominio principal de la tarea, lea la guía correspondiente, resuelva los enlaces de habilidades de apoyo desde el archivo actual y ejecute una auditoría de producción específica del dominio antes de finalizar. Para sistemas que abarcan múltiples dominios, la auditoría debe ejecutarse para cada dominio afectado. El conjunto enfatiza principios clave como construir flujos de trabajo completos, nunca tratar las verificaciones de UI frontend/móvil como autorización absoluta, validar entradas no confiables en tiempo de ejecución, no exponer secretos a los clientes, preferir la observabilidad y la recuperabilidad sobre fallas silenciosas, usar GitHub Actions como implementación de CI/CD predeterminada y probar flujos de trabajo críticos en la capa adecuada. Es compatible con herramientas de agente como Claude Code, Cursor y Codex.

Compatible con✓Claude Code~Codex CLI~Cursor

npx skills add https://github.com/AlanWYChen/agent-skills/tree/HEAD/production-engineering-skills

Documentación

Habilidades de Ingeniería de Producción

Propósito

Este es un paquete de habilidades enrutado por dominio para el desarrollo de aplicaciones de producción.

Primero elige el dominio relevante:

Guía web para aplicaciones basadas en navegador y sitios web
Guía móvil para aplicaciones móviles iOS, Android y multiplataforma
Guía backend para API, servicios, workers, colas, sistemas de datos y plataformas

Cada dominio duplica intencionalmente preocupaciones importantes como:

seguridad
observabilidad
pruebas
CI/CD
autenticación

Las versiones duplicadas están personalizadas para el dominio en lugar de tratarse como consejo genérico.

Flujos de trabajo compartidos del repositorio

Política de Dependabot: úsala al configurar o auditar horarios de actualización de dependencias, combinación automática oficial de Acciones de GitHub y revisión manual para dependencias de aplicaciones. Esta política es compartida entre dominios; léela solo cuando la tarea se refiera a Dependabot.

Enrutamiento

Al trabajar en una tarea:

Identifica si la tarea es principalmente web, móvil, backend o multidominio.
Lee el archivo SKILL.md vinculado de ese dominio.
Lee solo las habilidades de apoyo aplicables usando sus enlaces relativos. Resuelve cada enlace en relación con el archivo que lo contiene, sin depender del descubrimiento automático de habilidades anidadas.
Antes de finalizar, ejecuta la auditoría de producción específica del dominio.
Para sistemas multidominio, ejecuta la auditoría para cada dominio afectado.

Principios globales

Construye flujos de trabajo completos, no demos de ruta feliz.
Nunca trates las comprobaciones de UI frontend/móvil como autorización autorizada.
Valida entradas no confiables en tiempo de ejecución.
No expongas secretos a los clientes.
Prefiere observabilidad y recuperabilidad sobre fallas silenciosas.
Usa Acciones de GitHub como la implementación predeterminada de CI/CD a menos que el repositorio ya use otro sistema.
Prueba flujos de trabajo críticos en la capa adecuada en lugar de usar en exceso un solo tipo de prueba.