MCP HubMCP Hub
Retour aux compétences

generate-status-report

pjt222
Mis à jour 2 days ago
2 vues
17
2
17
Voir sur GitHub
Métageneral

À propos

Cette compétence génère automatiquement un rapport d'état de projet en analysant les artefacts existants tels que les backlogs et les plans de sprint. Elle calcule des métriques, identifie les blocages et résume l'avancement en utilisant les indicateurs RAG (Rouge/Orange/Vert) pour le calendrier, le périmètre, le budget et la qualité. Utilisez-la en fin de sprint, avant les réunions de gouvernance, ou lorsque de nouveaux blocages surviennent, pour fournir des mises à jour aux parties prenantes.

Installation rapide

Claude Code

Recommandé
Principal
npx skills add pjt222/agent-almanac -a claude-code
Commande PluginAlternatif
/plugin add https://github.com/pjt222/agent-almanac
Git CloneAlternatif
git clone https://github.com/pjt222/agent-almanac.git ~/.claude/skills/generate-status-report

Copiez et collez cette commande dans Claude Code pour installer cette compétence

Documentation


name: generate-status-report description: > Generar un informe de estado del proyecto leyendo artefactos existentes (acta, backlog, plan de sprint, EDT), calculando métricas, identificando bloqueadores y resumiendo el progreso con indicadores RAV (Rojo/Ámbar/Verde) para cronograma, alcance, presupuesto y calidad. Usar al final de un sprint o período de reporte, cuando los interesados solicitan una actualización del estado, antes de reuniones del comité directivo o de gobernanza, o cuando un nuevo bloqueador o riesgo se materializa a mitad del proyecto. license: MIT allowed-tools: Read Write Edit Bash Grep Glob metadata: author: Philipp Thoss version: "1.0" domain: project-management complexity: intermediate language: multi tags: project-management, status-report, metrics, rag, progress, blockers locale: es source_locale: en source_commit: 6f65f316 translator: claude-opus-4-6 translation_date: 2026-03-16

Generar un Informe de Estado del Proyecto

Producir un informe de estado periódico analizando los artefactos del proyecto, calculando métricas de progreso y resumiendo logros, bloqueadores y trabajo futuro con indicadores de salud RAV (Rojo/Ámbar/Verde).

Cuándo Usar

  • Fin de sprint o período de reporte (semanal, quincenal, mensual)
  • Solicitudes de los interesados para una actualización del estado del proyecto
  • Antes de reuniones del comité directivo o de gobernanza
  • Cuando los indicadores de salud del proyecto cambian (por ejemplo, aparece un nuevo bloqueador o riesgo)
  • Revisión periódica en relación con los hitos del acta de constitución

Entradas

  • Requerido: Período de reporte (fecha de inicio, fecha de fin)
  • Requerido: Al menos un artefacto del proyecto (BACKLOG.md, SPRINT-PLAN.md, WBS.md o PROJECT-CHARTER.md)
  • Opcional: Informes de estado anteriores (para comparación de tendencias)
  • Opcional: Datos de seguimiento de presupuesto o recursos
  • Opcional: Actualizaciones del registro de riesgos

Procedimiento

Paso 1: Leer los Artefactos Existentes

Explorar el directorio del proyecto en busca de artefactos de gestión de proyectos:

  • PROJECT-CHARTER.md — hitos, criterios de éxito
  • BACKLOG.md — recuentos de elementos por estado, datos de burn-down
  • SPRINT-PLAN.md — objetivo del sprint, elementos comprometidos, finalización de tareas
  • WBS.md — porcentajes de finalización de paquetes de trabajo
  • Archivos STATUS-REPORT-*.md anteriores — datos de tendencias

Leer los archivos disponibles. No todos existirán — adaptar el informe a los datos disponibles.

Esperado: Al menos un artefacto leído con éxito, métricas clave extraídas.

En caso de fallo: Si no existen artefactos, no se puede generar el informe. Crear primero un acta o un backlog usando las habilidades draft-project-charter o manage-backlog.

Paso 2: Calcular las Métricas de Progreso

Calcular métricas a partir de los datos disponibles:

Métricas ágiles (de BACKLOG.md / SPRINT-PLAN.md):

  • Velocidad: puntos de historia completados en este sprint
  • Completado del sprint: elementos terminados / elementos comprometidos
  • Burn-down del backlog: puntos totales restantes vs período anterior
  • Tiempo de ciclo: promedio de días de En Progreso a Terminado

Métricas clásicas (de WBS.md):

  • % completado: paquetes de trabajo terminados / total de paquetes de trabajo
  • Variación del cronograma: fechas planificadas de hitos vs fechas reales
  • Variación del esfuerzo: esfuerzo estimado vs esfuerzo real consumido
## Metrics
| Metric | Value | Previous | Trend |
|--------|-------|----------|-------|
| Velocity | [N] pts | [N] pts | ↑/↓/→ |
| Sprint Completion | [N]% | [N]% | ↑/↓/→ |
| Backlog Remaining | [N] pts | [N] pts | ↓ (good) |
| Schedule Variance | [+/-N days] | [+/-N days] | |

Esperado: 3-5 métricas calculadas con comparación del período anterior.

En caso de fallo: Si no existen datos históricos (primer informe), omitir las columnas Previous y Trend. Si los datos están incompletos, anotar las brechas en el pie del informe con elementos de acción para establecer el seguimiento.

Paso 3: Identificar Bloqueadores, Riesgos e Incidencias

Listar los bloqueadores y riesgos activos:

## Blockers & Risks
| ID | Type | Description | Severity | Owner | Status | Action Required |
|----|------|------------|----------|-------|--------|----------------|
| R-001 | Risk | [Description] | High | [Name] | Open | [Action] |
| B-001 | Blocker | [Description] | Critical | [Name] | Active | [Action by date] |
| I-001 | Issue | [Description] | Medium | [Name] | Investigating | [Action] |

Cruzar referencias con el registro de riesgos del acta. Señalar cualquier riesgo nuevo no identificado previamente.

Esperado: Todos los bloqueadores activos y los principales riesgos documentados con responsables y acciones.

En caso de fallo: Si no existen bloqueadores, indicar explícitamente "No hay bloqueadores activos" — no dejar la sección vacía. Si un bloqueador carece de responsable, escalar al director del proyecto para su asignación.

Paso 4: Resumir los Logros y el Plan del Próximo Período

Redactar dos secciones:

## Accomplishments (This Period)
- [Completed item/milestone with evidence]
- [Completed item/milestone with evidence]
- [Completed item/milestone with evidence]

## Planned (Next Period)
- [Planned item/milestone with target]
- [Planned item/milestone with target]
- [Planned item/milestone with target]

Esperado: 3-5 logros con evidencia concreta, 3-5 elementos planificados para el próximo período.

En caso de fallo: Si no existen logros, informar la razón (bloqueado, replaneando, equipo no disponible). Si el plan del próximo período no está claro, listar "Sesión de planificación programada para [fecha]" como elemento principal.

Paso 5: Asignar Indicadores RAV y Redactar el Informe

Evaluar la salud del proyecto en cuatro dimensiones:

DimensiónVerdeÁmbarRojo
CronogramaEn curso o adelantado1-2 semanas de retraso>2 semanas de retraso o hito perdido
AlcanceSin cambios no controladosAjustes menores de alcanceExpansión del alcance que afecta entregables
PresupuestoDentro del 5% del plan5-15% sobre el plan>15% sobre el plan o sin seguimiento
CalidadPruebas aprobadas, criterios cumplidosProblemas menores de calidadDefectos críticos o fallos de aceptación

Redactar el informe completo:

# Status Report: [Project Name]
## Report Date: [YYYY-MM-DD]
## Reporting Period: [Start] to [End]
## Document ID: SR-[PROJECT]-[YYYY-MM-DD]

### Overall Health
| Dimension | Status | Notes |
|-----------|--------|-------|
| Schedule | 🟢/🟡/🔴 | [One-line explanation] |
| Scope | 🟢/🟡/🔴 | [One-line explanation] |
| Budget | 🟢/🟡/🔴 | [One-line explanation] |
| Quality | 🟢/🟡/🔴 | [One-line explanation] |

### Executive Summary
[2-3 sentences: overall status, key achievement, biggest risk]

### Metrics
[From Step 2]

### Accomplishments
[From Step 4]

### Blockers & Risks
[From Step 3]

### Planned Next Period
[From Step 4]

### Decisions Needed
- [Decision 1 — needed by date, from whom]

---
*Report prepared by: [Name/Agent]*

Guardar como STATUS-REPORT-[YYYY-MM-DD].md.

Esperado: Informe de estado completo guardado con indicadores RAV, métricas y narrativa.

En caso de fallo: Si los datos son insuficientes para la evaluación RAV, usar ⚪ (Gris) que indica "datos insuficientes" y listar qué datos deben recopilarse para el próximo informe.

Validación

  • Archivo de informe de estado creado con nombre de archivo con sello de fecha correcto
  • Indicadores RAV asignados para las cuatro dimensiones con justificación
  • Al menos 3 métricas calculadas a partir de los artefactos del proyecto
  • Sección de bloqueadores presente (incluso si indica "No hay bloqueadores activos")
  • Logros listados con evidencia
  • Plan del próximo período incluido
  • El resumen ejecutivo tiene 2-3 oraciones, no un párrafo
  • Cada bloqueador y riesgo tiene un responsable y una acción con fecha límite

Errores Comunes

  • Informe sin datos: Los informes de estado deben basarse en evidencia. Cada afirmación debe referenciar un artefacto o métrica.
  • Todo verde, siempre: El verde persistente en el RAV sin evidencia sugiere que el informe no es honesto. Cuestionar las evaluaciones verdes.
  • Bloqueador sin responsable: Cada bloqueador necesita un responsable y una acción. Los bloqueadores sin responsable no se resuelven.
  • Métrica sin contexto: "Velocidad = 18" no significa nada sin comparación. Incluir siempre el período anterior o el objetivo.
  • Demasiado largo: Un informe de estado debe poder examinarse en 2 minutos. Limitarlo a 1-2 páginas.
  • Falta la sección de decisiones: Si el proyecto necesita decisiones de los interesados, hacerlas explícitas con plazos.
  • Datos obsoletos: Usar artefactos desactualizados lleva a informes engañosos. Verificar que las fechas de los artefactos coincidan con el período de reporte.
  • Falta de datos de tendencia: Los primeros informes no pueden mostrar tendencias, pero los informes posteriores deben compararse con períodos anteriores.

Habilidades Relacionadas

  • draft-project-charter — el acta proporciona hitos y criterios de éxito para el seguimiento del estado
  • manage-backlog — las métricas del backlog alimentan el informe de estado
  • plan-sprint — los resultados del sprint proporcionan datos de velocidad y completado
  • create-work-breakdown-structure — el completado de la EDT impulsa las métricas de progreso clásicas
  • conduct-retrospective — los datos del informe de estado alimentan la retrospectiva

Dépôt GitHub

pjt222/agent-almanac
Chemin: i18n/es/skills/generate-status-report
0
agentsagentskillsai-assisted-developmentclaude-codeskillsteams

Compétences associées

content-collections

Méta

Cette compétence propose une configuration éprouvée en production pour Content Collections, un outil axé sur TypeScript qui transforme des fichiers Markdown/MDX en collections de données typées de manière sûre avec une validation Zod. Utilisez-la lors de la création de blogs, de sites de documentation ou d'applications Vite + React riches en contenu pour garantir la sécurité de typage et la validation automatique du contenu. Elle couvre tout, de la configuration du plugin Vite et de la compilation MDX à l'optimisation des déploiements et la validation des schémas.

Voir la compétence

polymarket

Méta

Cette compétence permet aux développeurs de créer des applications avec la plateforme de marchés prédictifs Polymarket, incluant l'intégration d'API pour le trading et les données de marché. Elle fournit également une diffusion de données en temps réel via WebSocket pour surveiller les transactions en direct et l'activité du marché. Utilisez-la pour mettre en œuvre des stratégies de trading ou pour créer des outils traitant les mises à jour de marché en direct.

Voir la compétence

creating-opencode-plugins

Méta

Cette compétence aide les développeurs à créer des plugins OpenCode qui s'interconnectent avec plus de 25 types d'événements tels que les commandes, les fichiers et les opérations LSP. Elle fournit la structure du plugin, les spécifications de l'API événementielle et les modèles d'implémentation pour les modules JavaScript/TypeScript. Utilisez-la lorsque vous avez besoin d'intercepter, de surveiller ou d'étendre le cycle de vie de l'assistant IA OpenCode avec une logique personnalisée pilotée par les événements.

Voir la compétence

sglang

Méta

SGLang est un framework de service LLM haute performance spécialisé dans la génération rapide et structurée pour les workflows JSON, regex et agentiques grâce à son cache de préfixe RadixAttention. Il offre une inférence nettement plus rapide, particulièrement pour les tâches avec des préfixes répétés, ce qui le rend idéal pour les sorties complexes et structurées ainsi que les conversations multi-tours. Choisissez SGLang plutôt que des alternatives comme vLLM lorsque vous avez besoin d'un décodage contraint ou que vous construisez des applications avec un partage étendu de préfixes.

Voir la compétence