菜单
Gestión de la documentación externa de GitHooks (MkDocs + Material for MkDocs). Usa esta skill cuando el usuario quiera añadir, modificar o reorganizar páginas de documentación, actualizar el sitio de docs, añadir una guía, documentar una feature nueva, o cuando mencione "docs", "documentación", "mkdocs", "página de docs".
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
Genera el archivo de release notes (CHANGELOG-X.Y.Z.md) para pegar en GitHub Releases a partir de la sección [X.Y.Z] ya escrita en docs/changelog.md. Usa esta skill al cerrar un release: cuando el usuario pida "preparar release notes", "generar changelog de release", "CHANGELOG-X.Y.Z.md", "release notes para GitHub", o cuando se vaya a publicar una release y haga falta el texto pulido para GitHub Releases. NO usar durante el desarrollo — docs/changelog.md se mantiene en caliente por tarea, fuera de esta skill.
Gestión del kanban local del proyecto GitHooks (`.kanban-tasks/.kanban`, extensión `harehare.portable-kanban`). Usa esta skill cuando el usuario quiera añadir, mover, actualizar, cerrar o eliminar tasks del backlog; cuando pida "añade al kanban", "mueve FEAT-X a Doing", "cierra BUG-X", "haz limpieza post-release", "crea una idea nueva", "qué labels lleva esta task", o cuando haya que crear el `.md` de detalle de una task siguiendo las plantillas. NO uses esta skill para edición que el usuario haga directamente desde la UI del editor (drag-and-drop, asignación visual de labels) — solo para operaciones iniciadas por Claude.
Crea tests PHPUnit para el proyecto GitHooks (wtyd/githooks) siguiendo sus convenciones y patrones. Usa esta skill siempre que el usuario pida crear tests, añadir tests, testear una feature, verificar una funcionalidad, o cuando se implemente una nueva feature que necesite cobertura de tests. También cuando se mencione: "añadir tests", "crear tests", "test unitario", "test de integración", "test de sistema", "necesito tests para esto", "falta cobertura".
Analiza informes de Infection (mutation testing) para el proyecto GitHooks. Clasifica los mutants escaped, distingue bugs latentes reales de mutants equivalentes/cosméticos, y produce un plan de refuerzo de tests priorizado. Usa esta skill cuando el usuario pida "analizar Infection", "revisar mutants escaped", "interpretar mutation testing", "qué mutants han sobrevivido", "MSI bajo", o cuando ejecute Infection y haya mutants escaped que revisar.
Testing funcional y de integración de GitHooks como QA tester. Prueba todos los comandos CLI (flow, job, hook, conf:check, conf:migrate, cache:clear, status, system:info, tool), edge cases de configuración, formatos de salida, flags, combinaciones y compatibilidad legacy. Usa esta skill cuando el usuario quiera probar, verificar, o validar funcionalidades del CLI, buscar bugs, hacer testing de aceptación, o cuando mencione "probar", "testear funcionalidad", "verificar comando", "QA", "edge cases", "testing funcional".
Guía para modificar los workflows de GitHub Actions y el proceso de build del proyecto GitHooks. Usa esta skill cuando el usuario quiera modificar CI, cambiar versiones de PHP en la matriz, añadir/quitar jobs, modificar el release pipeline, tocar el build del .phar, o cuando mencione "GitHub Actions", "workflow", "CI", "pipeline", "build", "release", "matriz de PHP", "phar", "deploy", "artefacto". También cuando se toquen ficheros en .github/workflows/, box.json, o los comandos PreBuildCommand/BuildCommand.
| name | docs |
| description | Gestión de la documentación externa de GitHooks (MkDocs + Material for MkDocs). Usa esta skill cuando el usuario quiera añadir, modificar o reorganizar páginas de documentación, actualizar el sitio de docs, añadir una guía, documentar una feature nueva, o cuando mencione "docs", "documentación", "mkdocs", "página de docs". |
La documentación se genera con MkDocs + Material for MkDocs y se despliega en GitHub Pages (https://wtyd.github.io/githooks/).
mkdocs.yml ← Configuración MkDocs (nav, theme, plugins, extensions)
docs/
index.md ← Landing page
execution-modes.md ← full/fast/fast-branch
comparison.md ← vs GrumPHP, CaptainHook
getting-started/ ← Tutorial (3 páginas)
configuration/ ← Referencia de config (6 páginas)
tools/ ← Una página por herramienta QA (9 páginas)
cli/ ← Una página por comando (10 páginas)
how-to/ ← Guías prácticas (8 páginas)
migration/ ← Guías de migración (4 páginas)
.github/workflows/docs.yml ← GitHub Action: auto-deploy en push a master
| Cambio | Acción |
|---|---|
| Nueva herramienta QA (ej: PHP CS Fixer) | Crear docs/tools/phpcsfixer.md + añadir a nav en mkdocs.yml + actualizar docs/tools/index.md |
| Nuevo comando CLI | Crear docs/cli/nuevo-comando.md + añadir a nav + actualizar docs/cli/index.md |
| Nueva opción en comando existente | Actualizar la página del comando en docs/cli/ + actualizar docs/getting-started/ si afecta al tutorial |
| Nueva feature configurable | Actualizar docs/configuration/ (sección correspondiente) + crear how-to si aplica |
| Nueva guía práctica | Crear docs/how-to/nombre.md + añadir a nav + actualizar docs/how-to/index.md |
| Cambio en comportamiento existente | Actualizar las páginas afectadas (buscar con grep en docs/) |
| Nueva versión major | Actualizar migration/, comparison.md, y landing page |
| Contenido | Página |
|---|---|
| Keywords de una herramienta QA | docs/tools/{tool}.md |
| Opciones de un comando CLI | docs/cli/{command}.md |
| Sección hooks/flows/jobs/options del config | docs/configuration/{section}.md |
| Modos full/fast/fast-branch | docs/execution-modes.md |
| Recetas y escenarios | docs/how-to/ |
| Comparativa con competencia | docs/comparison.md |
| Migración desde otras herramientas | docs/migration/ |
Antes de añadir o modificar, lee references/page-templates.md para ver la estructura estándar de cada tipo de página.
.md en el directorio correspondiente.nav: de mkdocs.yml.index.md, actualizar la tabla de contenidos.El nav se define en mkdocs.yml. Cada sección usa index.md como página de índice de sección:
nav:
- Tools Reference:
- tools/index.md # Página de sección (navigation.indexes)
- PHPStan: tools/phpstan.md
- Nueva Tool: tools/nueva.md # ← Añadir aquí
# Build con validación estricta (detecta links rotos)
mkdocs build --strict
# Preview local con hot-reload
mkdocs serve
# Build para producción
mkdocs build -d public
Si el cambio afecta a algo que también está en el README (nueva herramienta, nuevo comando, cambio en install), actualizar también README.md.
El README debe ser un resumen conciso que enlaza a la documentación completa. No duplicar contenido extenso.
Enlaces en el README:
https://wtyd.github.io/githooks/configuration/https://wtyd.github.io/githooks/cli/# Nombre de la herramienta
Descripción en una línea.
- **Type:** `tipo`
- **Accelerable:** Yes/No
- **Default executable:** `vendor/bin/tool`
## Keywords
| Keyword | Type | Description | Example |
|---|---|---|---|
## Examples
Minimal + Full
## Threading / Cache (si aplica)
# githooks comando
Descripción breve.
## Synopsis
## Options (tabla)
## Examples
## Exit codes
## See also
!!! tip "Título opcional"
Contenido del tip.
!!! note
Nota informativa.
!!! warning
Advertencia importante.
!!! important
Información crítica.
```mermaid
graph LR
A[Hook] --> B[Flow]
B --> C[Job]
```
nav: de mkdocs.yml (si es página nueva)index.md de la sección actualizado (si es página nueva)mkdocs build --strict pasa sin errores