0xKoios/skills — Azure DevOps Boards: mis tarjetas

Azure DevOps Boards: mis tarjetas

Ayuda a una persona a gestionar sus propias tarjetas en Azure Boards a través de MCP o az. Las convenciones del equipo están en la configuración; la misma habilidad se adapta a diferentes equipos.

1. Antes que nada

1. Leer configuración — ~/.config/ado-boards/config.md (Windows: %USERPROFILE%\.config\ado-boards\config.md). Si falta → ejecutar primero la configuración principal (workflows/setup.md); adivinar la org/proyecto escribe en el lugar equivocado. Los valores marcados como not set yet se recopilan la primera vez que un flujo de trabajo los necesita.
2. Elegir backend para esta vez solamente:
   • MCP cuando las herramientas MCP de Azure DevOps estén disponibles (p. ej. wit_work_item): cargar mcp-tools.md (más un archivo az/ de brecha solo cuando ese mapa documente una brecha de MCP).
   • az en caso contrario: cargar az/README.md más el archivo de sección para este flujo de trabajo. También az/windows.md solo cuando una escritura de descripción/AC en HTML regrese dañada, o el quoting de PowerShell falle. Confirmar inicio de sesión (az account show o AZURE_DEVOPS_EXT_PAT); si ninguno, el usuario ejecuta az login por su cuenta.
   • Ninguno → apuntar a la configuración.
3. Abrir el flujo de trabajo coincidente (tabla siguiente) y seguirlo. Los flujos de trabajo dicen qué hacer; el archivo del backend dice cómo. Las reglas en §2 vinculan a ambos backends.

Listo cuando se tenga la configuración, se haya elegido un backend y el archivo de flujo de trabajo esté abierto.

El usuario inicia sesión por sí mismo (Entra / az login). Las credenciales permanecen fuera del chat.

2. Reglas

Las lecturas no requieren permiso. Cada escritura necesita una previsualización y un sí explícito — incluso cuando la herramienta misma no lo pida. El tablero es compartido; las escrituras MCP a menudo omiten un aviso, por lo que la previsualización es la puerta de entrada.

Regla	Criterio
Tamaño de previsualización	Un cambio en la propia tarjeta del usuario → una línea (#512: Estado Activo -> Cerrado. ¿OK?). Varios cambios, o la tarjeta de otra persona → tabla (ID, campo, antiguo, nuevo). Más de 10 → indicar la cantidad y confirmar de nuevo.
Relectura	Después de cada escritura: informar ID, qué cambió, URL https://dev.azure.com/<org>/<project>/_workitems/edit/<id>.
Padres	Cuando la configuración diga Parent required: yes, crear solo con un padre (los huérfanos desaparecen de las vistas del backlog).
Bugs	Cuando la configuración indique que los bugs viven en otro lugar: ofrecer una Tarea bajo el bug existente (un segundo Bug divide el historial).
Tarjetas externas	Prefijo en el título en la configuración (p. ej. EXT): advertir que los comentarios pueden sincronizarse con el informante antes del cambio de comentario o campo; saltar Impacto al cerrar.
Unidades	Los campos de tiempo son números planos; la unidad está en la configuración. Convertir cuando el usuario mencione otra unidad, mostrar ambas, siempre nombrar la unidad (la interfaz de Boards dice "h" de todas formas).
Las tarjetas permanecen	Cerrar o mover; dejar la tarjeta en el tablero. Eliminar un comentario solo después de mostrarlo completo y obtener un sí — ninguna de las dos acciones se puede deshacer.
Comentarios propios	Editar o eliminar solo los comentarios propios del usuario (ADO rechaza el resto).
Valores reales	Preguntar por estimaciones, asignados, fechas, impacto — o dejar en blanco. Los números inventados se ven reales en el tablero.
Comillas seguras	Citar valores de forma segura; los títulos pueden contener comillas.
Pie de escritura	Después de una escritura: qué hiciste, qué omitiste, un siguiente paso. Lecturas simples: solo responder.

3. Flujos de trabajo

Cuándo	Abrir
Configurar la habilidad ado; falta configuración; algo cambió	workflows/setup.md
Qué tengo en mi plato; mostrar mis tarjetas; mover; registrar tiempo; cerrar	workflows/my-cards.md
Crear una tarjeta; dividir una historia en tareas	workflows/create-card.md
Añadir, listar, editar o eliminar un comentario	workflows/comments.md
Descripción o criterios de aceptación	workflows/write-description.md
Planificar mi sprint; en qué debería trabajar primero	workflows/plan-my-sprint.md

4. Referencia ágil (verificar contra configuración)

Jerarquía: Épica > Funcionalidad > Historia de Usuario > Tarea. Los Bugs se colocan junto o debajo de las historias según la configuración del equipo.

Tipo	Estados
Funcionalidad / Historia de Usuario	Nuevo, Activo, Resuelto, Cerrado, Eliminado
Bug	Nuevo, Activo, Resuelto, Cerrado
Tarea	Nuevo, Activo, Cerrado, Eliminado

Padres: Tarea bajo Historia de Usuario (o Bug), Historia de Usuario bajo Funcionalidad. Los estados personalizados y campos obligativos viven en la configuración una vez recopilados.