github-projects

name	github-projects
description	Gerencia GitHub Projects V2 via GraphQL API. Cria projects, configura campos customizados e views. Use quando: iniciar projeto SDLC, mover issues entre fases.
allowed-tools	["Read","Write","Bash"]
user-invocable	false
version	1.0.0

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

Campo	Tipo	Valores
Phase	SingleSelect	Backlog, Requirements, Architecture, Planning, In Progress, QA, Release, Done
Sprint	Iteration	Sprints configurados
Story Points	Number	1, 2, 3, 5, 8, 13, 21
Priority	SingleSelect	Critical, High, Medium, Low

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