Herramientas de desarrollo con IA (devkit)

devkit es un conjunto de herramientas de código abierto que te ayuda a desarrollar extensiones de zittme con herramientas de programación con IA (Claude Code, Cursor, etc.) sin romper las convenciones. Se compone de un servidor MCP, skills y documentos de guía de desarrollo.

Repositorio zittme/devkit

Repositorio: github.com/zittme/devkit (licencia MIT)
Esta herramienta se ofrece sin garantía y no está cubierta por el soporte técnico oficial. Los reportes de problemas se reciben en GitHub Issues.

Estructura

Carpeta	Contenido
`mcp/`	Servidor MCP. Generación de scaffolds, análisis estático de plantillas (lint), listas de verificación de desarrollo, despliegue a tu propio servidor
`skills/`	3 skills: `make-layout`, `make-board-skin`, `make-theme`. Antes de crear, hacen primero unas preguntas de diseño
`docs/`	Guía de desarrollo. Se puede consultar también sin IA

Flujo de trabajo

Flujo de desarrollo con devkit

La skill pregunta primero las decisiones de diseño, como el modo oscuro o la estructura del menú, y genera el scaffold según tus respuestas. Las plantillas terminadas pasan por el análisis estático (lint_template), y las herramientas de despliegue rechazan la subida si hay violaciones de las convenciones. Se revisan las trampas típicas que provocan errores de servidor en las plantillas v2 (comentarios de varias líneas, closures dentro de expresiones, etc.).

Instalar solo las skills rápidamente

npx skills add https://github.com/zittme/devkit

Para instalar solo una skill concreta, indícala así: --skill make-layout.

Instalar el servidor MCP

git clone https://github.com/zittme/devkit
cd devkit/mcp
npm install
npm run build

Registro en Claude Code:

claude mcp add zittme-devkit -- node <클론 경로>/mcp/dist/index.js

La variable de entorno obligatoria es ZITTME_PATH (ruta del código fuente del sitio que estás desarrollando), y para usar el despliegue pones los datos de conexión, como DEVKIT_SFTP_HOST, en variables de entorno. Como las credenciales no se escriben en archivos, no hay forma de que se suban por error al repositorio.

Cómo registrarlo en otras herramientas, como Cursor, Windsurf, Codex CLI o Gemini CLI, está explicado en la guía de integración del repositorio.

Herramientas incluidas (MCP)

Categoría	Herramientas
Scaffold	`scaffold_module` `scaffold_layout` `scaffold_skin` `scaffold_query` `scaffold_schema`
Verificación	`lint_template` `check_php_syntax`
Conocimiento	`get_dev_checklist` `get_guidelines` `get_framework_docs`
Exploración	`get_module_structure` `search_code` `search_queries` `get_db_schema`, etc.
Despliegue	`deploy_to_server` `deploy_changed` `push_file` (todas requieren pasar el lint)
Aprendizaje	`record_pitfall` `list_pitfalls` (se acumulan localmente en tu proyecto)

Ver también

Sintaxis de plantillas v2 - el texto original de las convenciones que revisa devkit
Crear skins y layouts
Crear un paquete de tema