Configura el repositorio de GitHub de punta a punta con gh — descripción, topics, labels, rama develop, protección de ramas, merge settings y metadatos — a partir de la definición del producto. Úsalo al crear el repo de un proyecto nuevo o cuando haya que poner en orden uno existente (p. ej. "configura el repo", "prepara el repositorio en GitHub", "pon los labels y la protección de ramas").
インストールする前に、エージェントに与えられる指示の中身を確認できます。
Deja el repositorio de GitHub operativo y coherente con la plantilla. Requiere gh
autenticado; verifica con gh auth status antes de empezar.
Lee README.md y docs/product/business-model.md para derivar descripción y
topics. Detecta el repo actual (gh repo view). Si no existe remoto, pregunta si
crearlo (gh repo create — público/privado lo decide la persona).
gh repo edit --description). Homepage: la URL del producto si existe.gh repo edit --add-topic).Ejecuta .github/scripts/setup-labels.sh (usa .github/LABELS.md como catálogo).
develop desde main si no existe, publícala y establécela como rama por
defecto del repo (gh api -X PATCH repos/{owner}/{repo} -f default_branch=develop)
— no es opcional: la rama por defecto es a donde apuntan los PRs nuevos y los de
Dependabot; si queda main, el Git Flow se rompe (CONTRIBUTING.md)..github/dependabot.yml tenga target-branch: "develop" en cada
ecosistema.main (y develop si la persona quiere): PR obligatorio, sin
force-push, conversaciones resueltas y checks requeridos por su nombre de check
run, no por el del workflow: Calidad (de quality.yml) y Gitleaks (de
secret-scan.yml). Si pones el nombre del workflow, el PR se queda esperando un
check que nunca reporta. Verifícalos con
gh api repos/{owner}/{repo}/commits/{sha}/check-runs --jq '.check_runs[].name'
sobre un commit que ya haya corrido CI.
Aplica vía gh api repos/{owner}/{repo}/branches/{branch}/protection y muestra el
JSON antes de aplicar.bash .github/scripts/check-hooks-enabled.sh (con --arreglar los activa).
core.hooksPath no viaja en el repositorio, así que el estado por defecto de
cualquier clon nuevo es «sin ninguna verificación local».gh: Upgrade to GitHub Pro or make this repository public to enable this feature. (HTTP 403)
En un repositorio privado de plan gratuito la protección de ramas no existe. No es
un error suelto que se reporta al final: es un resultado previsto que cambia lo que
el proyecto puede prometer. CONTRIBUTING.md y AGENTS.md declaran PR obligatorio,
nada de push directo a main/develop y checks requeridos para fusionar — y todo eso
lo hace cumplir el servidor. Sin él queda esto:
| Control | Qué cubre | Cómo se salta |
|---|---|---|
git-guardrails.sh | Push desde una rama protegida | Es un hook del agente: no aplica a la persona |
.githooks/pre-push | Los checks antes de publicar | git push --no-verify |
core.hooksPath | Activa lo anterior | Se olvida: es manual, una vez por clon |
Haz tres cosas, en el momento en que aparece el 403:
--no-verify».README.md o en el ADR de instanciación, para que quien
llegue después no dé por buenas unas reglas que nadie aplica.quality.yml,
secret-scan.yml) corran.Resume qué quedó configurado (con los comandos ejecutados) y regístralo en el CHANGELOG
bajo Unreleased. Y di qué NO quedó protegido, con su consecuencia — no basta con
listar qué falló por permisos: si no hay protección de ramas, el resumen tiene que decir
que las reglas de CONTRIBUTING.md no las hace cumplir nadie (Paso 4).
Reglas: muestra cada comando destructivo o de configuración antes de ejecutarlo la primera vez; NO borres labels/ramas existentes sin confirmar; NO toques repos que no sean el del proyecto actual.
まだレビューはありません。使ってみた感想をお寄せください。
概要と使いどころ
Revisa los cambios de UI en cuanto a accesibilidad — contraste de color, navegación por teclado, gestión del foco, uso de ARIA y texto alternativo. Úsalo cuando la persona pida una revisión de a11y/accesibilidad, verificar el cumplimiento de WCAG, el soporte de teclado, la compatibilidad con lectores de pantalla o el manejo del foco (p. ej. "¿es accesible este modal?", "audita la a11y del formulario").
日本語の概要は準備中です。原文の説明を表示しています。
Trae a este proyecto las mejoras que la plantilla de origen recibió después de la instanciación — lee .template-origin, calcula el diff del tooling (skills, hooks, scripts, workflows) contra la plantilla actual y propone aplicarlo. Úsalo cuando la persona quiera actualizar/sincronizar el proyecto con la plantilla (p. ej. "actualiza la plantilla", "trae las mejoras nuevas del template").
日本語の概要は準備中です。原文の説明を表示しています。
Actualiza CHANGELOG.md en el formato Keep a Changelog, añadiendo los cambios actuales bajo la sección Unreleased. Úsalo cuando la persona pida actualizar el changelog, añadir una entrada al changelog o registrar lo que cambió para las notas de la versión (p. ej. "añade esto al changelog", "actualiza el CHANGELOG con estos commits").
日本語の概要は準備中です。原文の説明を表示しています。
Escribe un mensaje de Conventional Commits para los cambios en stage y crea el commit, incluyendo la línea de coautoría de atribución de IA. Úsalo cuando la persona pida hacer commit, escribir un mensaje de commit o guardar cambios (p. ej. "haz commit de esto", "escribe un mensaje de commit para estos cambios"). No hace push.
日本語の概要は準備中です。原文の説明を表示しています。
Revisa o produce textos visibles para la persona usuaria (texto de UI, encabezados, botones, mensajes de error, marketing) con la voz y el tono del proyecto. Úsalo cuando la persona pida escribir/mejorar textos, corregir la redacción, revisar el tono o redactar microcopy (p. ej. "escribe el texto del estado vacío", "haz este mensaje de error más amable", "revisa el titular de la landing").
日本語の概要は準備中です。原文の説明を表示しています。
Audita una vista o componente frente al design system en lo que un script no puede comprobar — estados de interacción, los cuatro estados de datos, primitivas nativas frente a componentes reinventados y jerarquía visual. Úsalo cuando la persona pida revisar el cumplimiento del design system o si un componente sigue las guías (p. ej. "¿esta tarjeta sigue nuestro sistema?", "audita la vista de ajustes").
日本語の概要は準備中です。原文の説明を表示しています。