Agent skill

github-projects

Gerencia GitHub Projects V2 via GraphQL API. Cria projects, configura campos customizados e views. Use quando: iniciar projeto SDLC, mover issues entre fases.

View SKILL.md on GitHub Repository
Stars 163
Forks 31

Install this agent skill to your Project

npx add-skill https://github.com/majiayu000/claude-skill-registry/tree/main/skills/data/github-projects

SKILL.md

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.

bash
# 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.

bash
# 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

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

Adicionar Item

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

Atualizar Campo

graphql
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)

bash
# 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

bash
# 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

bash
# 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

Didn't find tool you were looking for?

Be as detailed as possible for better results