Ferramentas - Sprints
Os sprints representam períodos de trabalho delimitados dentro de um board. Ao fechar um sprint, os work items concluídos são arquivados e um changelog e um relatório visual são gerados automaticamente.
list_sprints
Lista todos os sprints de um board. O sprint aberto aparece primeiro, seguido pelos sprints fechados ordenados por data, dos mais recentes aos mais antigos.
Parâmetros:
| Nome | Tipo | Obrigatório | Descrição |
|---|---|---|---|
| boardId | string (UUID) | Sim | ID do board |
Exemplo:
{
"boardId": "b1234567-89ab-cdef-0123-456789abcdef"
}
Resposta:
[
{
"id": "sprint-001",
"name": "Sprint 12",
"status": "open",
"startDate": "2025-02-10T00:00:00.000Z",
"endDate": "2025-02-24T00:00:00.000Z",
"boardId": "b1234567-...",
"workItemCount": 0,
"createdAt": "2025-02-10T09:00:00.000Z"
},
{
"id": "sprint-000",
"name": "Sprint 11",
"status": "closed",
"startDate": "2025-01-27T00:00:00.000Z",
"endDate": "2025-02-09T00:00:00.000Z",
"boardId": "b1234567-...",
"workItemCount": 18,
"createdAt": "2025-01-27T09:00:00.000Z"
}
]
get_sprint
Obtém um sprint pelo ID, incluindo o número de work items.
Parâmetros:
| Nome | Tipo | Obrigatório | Descrição |
|---|---|---|---|
| id | string (UUID) | Sim | ID do sprint |
Exemplo:
{
"id": "sprint-001"
}
get_active_sprint
Obtém o sprint aberto atualmente em um board. Retorna null se não houver nenhum sprint aberto.
Parâmetros:
| Nome | Tipo | Obrigatório | Descrição |
|---|---|---|---|
| boardId | string (UUID) | Sim | ID do board |
Exemplo:
{
"boardId": "b1234567-89ab-cdef-0123-456789abcdef"
}
Resposta:
{
"id": "sprint-001",
"name": "Sprint 12",
"status": "open",
"startDate": "2025-02-10T00:00:00.000Z",
"endDate": "2025-02-24T00:00:00.000Z",
"boardId": "b1234567-...",
"workItemCount": 0
}
create_sprint
Cria um novo sprint em um board. Só pode haver um sprint aberto por board de cada vez.
Parâmetros:
| Nome | Tipo | Obrigatório | Descrição |
|---|---|---|---|
| boardId | string (UUID) | Sim | ID do board |
| name | string | Sim | Nome do sprint |
| startDate | string | Não | Data de início no formato ISO 8601 |
| endDate | string | Não | Data de término no formato ISO 8601 |
Exemplo:
{
"boardId": "b1234567-89ab-cdef-0123-456789abcdef",
"name": "Sprint 13",
"startDate": "2025-02-24",
"endDate": "2025-03-10"
}
close_sprint
Fecha um sprint aberto. Arquiva todos os work items nas colunas "done" e os registra como work items do sprint. Opcionalmente, filtra por intervalo de datas. Ao fechar, um relatório visual e um changelog são gerados automaticamente.
Parâmetros:
| Nome | Tipo | Obrigatório | Descrição |
|---|---|---|---|
| sprintId | string (UUID) | Sim | ID do sprint a fechar |
| boardId | string (UUID) | Sim | ID do board do sprint |
| startDate | string | Não | Data inicial ISO 8601 para filtrar itens por finishedAt >= startDate |
| endDate | string | Não | Data final ISO 8601 para filtrar itens por finishedAt <= endDate |
Exemplo:
{
"sprintId": "sprint-001",
"boardId": "b1234567-89ab-cdef-0123-456789abcdef"
}
close_sprint_adhoc
Cria e fecha um sprint em uma única transação. Útil para registrar retroativamente um sprint que já foi concluído. Opcionalmente, filtra itens por intervalo de datas.
Parâmetros:
| Nome | Tipo | Obrigatório | Descrição |
|---|---|---|---|
| boardId | string (UUID) | Sim | ID do board |
| name | string | Sim | Nome do sprint |
| startDate | string | Não | Data inicial ISO 8601 para filtrar itens |
| endDate | string | Não | Data final ISO 8601 para filtrar itens |
Exemplo:
{
"boardId": "b1234567-89ab-cdef-0123-456789abcdef",
"name": "Sprint 10 (retroactivo)",
"startDate": "2025-01-13",
"endDate": "2025-01-26"
}
close_sprint_by_date
Cria e fecha um sprint com datas explícitas de início e término em uma única transação. Arquiva todos os work items que estão atualmente nas colunas "done". As datas de início e término são obrigatórias.
Parâmetros:
| Nome | Tipo | Obrigatório | Descrição |
|---|---|---|---|
| boardId | string (UUID) | Sim | ID do board |
| name | string | Sim | Nome do sprint |
| startDate | string | Sim | Data de início ISO 8601 (por exemplo, 2025-01-01) |
| endDate | string | Sim | Data de término ISO 8601 (por exemplo, 2025-01-14) |
Exemplo:
{
"boardId": "b1234567-89ab-cdef-0123-456789abcdef",
"name": "Sprint 9",
"startDate": "2025-01-01",
"endDate": "2025-01-14"
}
get_sprint_work_items
Lista todos os work items concluídos e arquivados em um sprint específico.
Parâmetros:
| Nome | Tipo | Obrigatório | Descrição |
|---|---|---|---|
| sprintId | string (UUID) | Sim | ID do sprint |
Exemplo:
{
"sprintId": "sprint-000"
}
preview_done_items
Exibe uma prévia dos work items nas colunas "done" que seriam arquivados ao fechar um sprint. Útil para revisar antes de executar close_sprint.
Parâmetros:
| Nome | Tipo | Obrigatório | Descrição |
|---|---|---|---|
| boardId | string (UUID) | Sim | ID do board |
Exemplo:
{
"boardId": "b1234567-89ab-cdef-0123-456789abcdef"
}
Resposta:
[
{
"id": "wi-001",
"taskId": "A-T-37",
"title": "Implementar login",
"type": "task",
"columnName": "Done",
"finishedAt": "2025-02-20T15:30:00.000Z"
},
{
"id": "wi-002",
"taskId": "A-T-38",
"title": "Tests de integracion auth",
"type": "task",
"columnName": "Done",
"finishedAt": "2025-02-21T10:00:00.000Z"
}
]
Antes de fechar um sprint, execute preview_done_items para verificar se os itens corretos serão arquivados. Em seguida, execute close_sprint ou close_sprint_adhoc.
regenerate_sprint_changelog
Gera novamente o documento de changelog de um sprint fechado. Útil para regenerar após melhorias nos prompts ou para sprints antigos que não têm changelog.
Parâmetros:
| Nome | Tipo | Obrigatório | Descrição |
|---|---|---|---|
| sprintId | string (UUID) | Sim | ID do sprint (deve estar fechado) |
| fallbackStrategy | string | Não | Estratégia para itens sem documentação de IA: list-only (padrão, lista sem resumo), ai-analyze (gera resumos de IA sob demanda), skip (omite itens sem documentação) |
Exemplo:
{
"sprintId": "sprint-000",
"fallbackStrategy": "ai-analyze"
}
Resposta:
{
"message": "Changelog generated successfully for sprint 'Sprint 11'",
"documentId": "doc-uuid-001"
}