Github Projects

GitHub Projects Skill

Skill para gerenciamento de GitHub Projects V2 usando GraphQL API.

Objetivo

Automatizar criacao e gerenciamento de GitHub Projects V2 para projetos SDLC, incluindo configuracao de campos customizados, views e sincronizacao de issues.

Pre-requisitos

• GitHub CLI (gh) instalado e autenticado
• Scope project habilitado: gh auth refresh -s project

Scripts Disponiveis

project_manager.py

Gerencia Projects V2 via GraphQL.

# Criar project
python3 .claude/skills/github-projects/scripts/project_manager.py create \
  --title "SDLC: Feature X" \
  --description "Projeto para feature X"

# Obter project por titulo
python3 .claude/skills/github-projects/scripts/project_manager.py get --title "SDLC: Feature X"

# Listar projects
python3 .claude/skills/github-projects/scripts/project_manager.py list

# Adicionar issue ao project
python3 .claude/skills/github-projects/scripts/project_manager.py add-item \
  --project-number 1 \
  --issue-url "https://github.com/owner/repo/issues/123"

# Atualizar campo de um item
python3 .claude/skills/github-projects/scripts/project_manager.py update-field \
  --project-number 1 \
  --item-id "PVTI_xxx" \
  --field "Phase" \
  --value "Implementation"

# Configurar campos customizados SDLC
python3 .claude/skills/github-projects/scripts/project_manager.py configure-fields \
  --project-number 1

project_views.py

Gerencia views (Kanban, Timeline, Table) do Project.

# Criar view Kanban por fase
python3 .claude/skills/github-projects/scripts/project_views.py create-kanban \
  --project-number 1

# Criar view Timeline
python3 .claude/skills/github-projects/scripts/project_views.py create-timeline \
  --project-number 1

# Listar views
python3 .claude/skills/github-projects/scripts/project_views.py list \
  --project-number 1

Campos Customizados SDLC

Colunas do Kanban (por fase SDLC)

1. Backlog - Phases 0-1 (Preparation, Discovery)
2. Requirements - Phase 2
3. Architecture - Phase 3
4. Planning - Phase 4
5. In Progress - Phase 5 (Implementation)
6. QA - Phase 6 (Quality)
7. Release - Phase 7
8. Done - Completed

GraphQL Queries Utilizadas

Criar Project

mutation CreateProject($ownerId: ID!, $title: String!) {
  createProjectV2(input: {ownerId: $ownerId, title: $title}) {
    projectV2 { id number url }
  }
}

Adicionar Item

mutation AddItem($projectId: ID!, $contentId: ID!) {
  addProjectV2ItemById(input: {projectId: $projectId, contentId: $contentId}) {
    item { id }
  }
}

Atualizar Campo

mutation UpdateField($projectId: ID!, $itemId: ID!, $fieldId: ID!, $value: ProjectV2FieldValue!) {
  updateProjectV2ItemFieldValue(
    input: {projectId: $projectId, itemId: $itemId, fieldId: $fieldId, value: $value}
  ) { item { id } }
}

Integracao SDLC

Ao iniciar workflow (Phase 0)

# 1. Criar project
PROJECT=$(python project_manager.py create --title "SDLC: $FEATURE_NAME" --json)

# 2. Configurar campos
python project_manager.py configure-fields --project-number $PROJECT_NUMBER

# 3. Criar views
python project_views.py create-kanban --project-number $PROJECT_NUMBER

Ao transicionar de fase

# Atualizar campo Phase de todas as issues do sprint
python project_manager.py update-phase \
  --project-number $PROJECT_NUMBER \
  --from-phase 5 \
  --to-phase 6

Exemplo de Uso Completo

# Criar project para nova feature
python project_manager.py create \
  --title "SDLC: Sistema de Autenticacao" \
  --description "Implementacao de autenticacao OAuth2"

# Configurar campos SDLC
python project_manager.py configure-fields --project-number 1

# Adicionar issue existente
python project_manager.py add-item \
  --project-number 1 \
  --issue-url "https://github.com/arbgjr/sdlc_agentico/issues/123"

# Atualizar fase da issue
python project_manager.py update-field \
  --project-number 1 \
  --item-id "PVTI_xxx" \
  --field "Phase" \
  --value "In Progress"

Limitacoes

• Projects V2 requer scope project no token
• Alguns campos (Iteration) tem API limitada
• Views customizadas tem suporte parcial via API