AgentSkillsCN

stack_guardrail

作为全局守卫,明确界定项目封闭的技术栈。在执行任何涉及工具或依赖项的操作之前,务必先行执行此步骤。

SKILL.md
--- frontmatter
name: stack_guardrail
description: Guardrail global que define el stack tecnológico cerrado del proyecto. Ejecutar ANTES de cualquier acción que involucre herramientas o dependencias.

Skill: Stack Guardrail

Objetivo

Prevenir la instalación o uso de herramientas fuera del stack definido.

Stack Tecnológico CERRADO

Dependencias autorizadas (package.json)

DependenciaVersiónPropósito autorizado
playwright^1.58.0Solo para script html_to_pdf.js
@playwright/test^1.58.0Referencia — NO ejecutar CLI
sharp^0.34.5Optimización de imágenes
glob^13.0.0Búsqueda de archivos

Herramientas MCP autorizadas

PrefijoPropósito
mcp_playwright_browser_*Interacción con browser
activate_page_capture_toolsCapturas de pantalla
activate_form_and_file_management_toolsFormularios

Scripts Node.js autorizados

ScriptRuta
html_to_pdf.js.github/skills/generate_pdf_report/scripts/html_to_pdf.js
optimize-images.js.github/skills/optimize-images/optimize-images.js

Herramientas PROHIBIDAS

Automatización de browser (PROHIBIDO)

  • ❌ Puppeteer
  • ❌ Selenium / WebDriver
  • ❌ Cypress
  • ❌ TestCafe
  • ❌ WebDriverIO
  • ❌ Nightmare.js
  • ❌ PhantomJS

Frameworks de testing CLI (PROHIBIDO)

  • ❌ Jest
  • ❌ Mocha
  • ❌ Jasmine
  • ❌ Vitest
  • ❌ AVA

Comandos de instalación (PROHIBIDO)

  • pnpm add <cualquier-herramienta-de-testing>
  • npm install <cualquier-herramienta-de-testing>
  • yarn add <cualquier-herramienta-de-testing>

Comandos CLI de testing (PROHIBIDO)

  • pnpm test
  • npm test
  • npx playwright test
  • npx cypress run
  • npx jest

Reglas de ejecución

Antes de cualquier acción, verificar:

  1. ¿La herramienta está en la lista de autorizadas? → Si NO, DETENER
  2. ¿El comando instala una dependencia nueva? → Si SÍ, DETENER
  3. ¿Se está generando código .spec.ts? → Si SÍ, DETENER

Ante errores o limitaciones:

  1. REPORTAR el problema específico
  2. SOLICITAR instrucciones al usuario
  3. NUNCA proponer herramientas alternativas
  4. NUNCA ejecutar instalaciones de dependencias

Ejemplo de flujo correcto

code
Usuario: "Ejecuta TC-001"

✅ CORRECTO:
1. Ejecutar skill setup_test_session
2. Usar mcp_playwright_browser_navigate
3. Usar mcp_playwright_browser_click
4. Usar activate_page_capture_tools
5. Ejecutar node optimize-images.js
6. Generar HTML
7. Ejecutar node html_to_pdf.js

❌ INCORRECTO:
1. "Voy a instalar Puppeteer para tomar screenshots"
2. "Necesito Selenium para interactuar con el browser"
3. "Creo un archivo test.spec.ts para ejecutar las pruebas"

Validación final

Al terminar cualquier tarea, verificar:

  • ¿Se usaron solo herramientas MCP autorizadas?
  • ¿Se ejecutaron solo scripts autorizados?
  • ¿No se instalaron dependencias nuevas?
  • ¿No se crearon archivos .spec.ts?

Si alguna respuesta es NO, la ejecución fue incorrecta.