luciano-stefano-meloclaps/platform-argentum / .claude/skills/publicar-issues
publicar-issues
VerifiedCrea, comenta y edita issues del tracker con gh de forma barata — título, cuerpo, etiquetas y dependencias como texto. Usala al publicar un corte aprobado o al comentar un issue.
| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 3.8 KB |
SKILL.md
View on GitHub---
name: publicar-issues
description: Crea, comenta y edita issues del tracker con gh de forma barata — título, cuerpo, etiquetas y dependencias como texto. Usala al publicar un corte aprobado o al comentar un issue.
when_to_use: Cuando el delivery-specialist publica tickets aprobados, comenta un issue o lista los desbloqueados.
---
# Publicar issues
Fuente de las reglas: `docs/agents/issue-tracker.md`. Los tipos del título son
los de `convenciones-git`. El vocabulario es el de `CONTEXT.md` (rebanada,
cimiento, ticket).
## Antes de publicar
- **El corte tiene que estar aprobado por el usuario.** Sin aprobación explícita
no se publica nada.
- Etiquetas: todo ticket lleva `tipo:`, `area:` y `prioridad:` (esquema en
`docs/agents/issue-tracker.md`); `tamano:`, `espera:` y `bloqueada` cuando
corresponda. Verificá con `rtk gh label list --limit 100`: sin el límite, `gh` muestra solo
30 y parece que faltan etiquetas que sí existen. Una inexistente hace fallar el `create`, y
crear etiquetas está denegado. No uses `ready-for-agent`.
- Publicá en **orden de dependencia**: los bloqueantes primero, para que el
número de `Bloqueada por:` ya exista.
## Crear
```bash
rtk gh issue create --title "tipo(alcance): mensaje breve" \
--label <existente> --body-file <archivo-fuera-del-repo>
```
Cuerpo, en español:
```markdown
Bloqueada por: #12 (solo si hay; arriba de todo)
## Qué tiene que quedar andando
## Criterios de aceptación
## Qué tiene que quedar en pie
## Cómo se verifica
```
Dice en el cuerpo, no en el título, si es cimiento o rebanada.
## Leer y listar con poco texto
```bash
rtk gh issue view <n> --comments
rtk gh issue list --state open --json number,title
```
Pedí `body` y `comments` solo del issue que vas a trabajar.
## Mover la tarjeta en el tablero
El tablero es el proyecto 2 de `luciano-stefano-meloclaps`. Columnas: `Backlog`,
`Listo`, `En curso`, `En revisión`, `Hecho`. Solo se mueven tarjetas
(`item-edit`); el proyecto y sus campos no se tocan.
```bash
O=luciano-stefano-meloclaps; P=PVT_kwHOBS9uN84BgJQ7
ITEM=$(rtk gh project item-list 2 --owner $O --limit 100 --format json \
--jq '.items[]|select(.content.number==<n>)|.id')
CAMPO=$(rtk gh project field-list 2 --owner $O --format json \
--jq '.fields[]|select(.name=="Status")|.id')
OPC=$(rtk gh project field-list 2 --owner $O --format json \
--jq '.fields[]|select(.name=="Status")|.options[]|select(.name=="<columna>")|.id')
rtk gh project item-edit --id $ITEM --project-id $P --field-id $CAMPO --single-select-option-id $OPC
```
Si falla por permisos, el `GH_TOKEN` no tiene `project`: reportalo y seguí, el
tablero no bloquea el trabajo.
## Cargar los campos de la tarjeta
Al publicar un ticket, además de las etiquetas, cargá en su tarjeta los campos
`Tipo`, `Área`, `Prioridad` y, si corresponde, `Tamaño` y `Espera`, y asigná el
hito con `--milestone`. Son los que se ven en
la vista **Kanban**. Es el mismo comando de arriba cambiando el nombre del
campo (`Status` por `Tipo`, `Área`, `Prioridad` o `Tamaño`) y el valor de la
opción. Los valores son los de las etiquetas: `Prioridad` va con inicial
mayúscula (`Crítica`, `Alta`, `Media`, `Baja`) y `Tamaño` en `S`, `M` o `L`.
Un campo vacío no aparece en la tarjeta.
`Hecho` no se mueve a mano: al cerrar el issue lo pone el tablero.
## Lo que la guarda no deja pasar
`limitar-gh.sh` deniega un `gh` que aparece dentro de otro comando. Para evitarlo:
un comando `gh` por llamada, sin `cd … && gh`, y sin escribir `gh` ni
`gh project` como texto dentro del cuerpo de un heredoc. Escribí el cuerpo en
un archivo fuera del repo y pasalo con `--body-file`.
## Reglas duras
- No cerrar ni editar un issue que no creaste, salvo pedido explícito.
- Cerrar es de `publicar-pr`: solo con el PR mergeado en `development`.
- Dependencias siempre como texto, nunca con `gh api`.
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| slack-gif-creatoranthropics/skillsKnowledge and utilities for creating animated GIFs optimized for Slack. Provides constraints, validation tools, and animation concepts. Use when users request animated GIFs for Slack like "make me a GIF of X doing Y for Slack." | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |
| ponytailDietrichGebert/ponytailLazy senior dev mode for any coding task: the smallest change that fully solves it, and a reply a busy human understands in one read. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-debtDietrichGebert/ponytailHarvest every shortcut: comment into one debt ledger, so deferrals get tracked instead of forgotten. One-shot report. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-debtDietrichGebert/ponytailList every `shortcut:` comment (and older `ponytail:` ones) as a debt ledger. One-shot report, changes nothing. Use for "ponytail debt", "what did ponytail defer", "list the shortcuts", /ponytail-debt. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |