Arbgjr Smart Alarm Github Sync

GitHub Sync Skill

Skill base que fornece utilitarios para sincronizacao com GitHub Issues, Labels e Milestones.

Objetivo

Prover uma camada de abstracao sobre a API do GitHub para que outros agentes e skills possam gerenciar issues, labels e milestones de forma consistente e automatizada.

Scripts Disponiveis

label_manager.py

Gerencia labels SDLC no repositorio.

# Criar todos os labels SDLC se nao existem
python3 .claude/skills/github-sync/scripts/label_manager.py ensure

# Listar labels existentes
python3 .claude/skills/github-sync/scripts/label_manager.py list

# Verificar se labels SDLC existem
python3 .claude/skills/github-sync/scripts/label_manager.py check

Labels criados:

• phase:0 a phase:8 - fase atual do SDLC
• complexity:0 a complexity:3 - nivel de complexidade
• type:story, type:task, type:epic - tipo de item
• sdlc:auto - criado automaticamente pelo SDLC

milestone_sync.py

Gerencia milestones (sprints) no repositorio.

# Criar milestone
python3 .claude/skills/github-sync/scripts/milestone_sync.py create \
  --title "Sprint 1" \
  --description "Sprint goal" \
  --due-date "2026-01-28"

# Fechar milestone
python3 .claude/skills/github-sync/scripts/milestone_sync.py close --title "Sprint 1"

# Listar milestones
python3 .claude/skills/github-sync/scripts/milestone_sync.py list

# Obter milestone por titulo
python3 .claude/skills/github-sync/scripts/milestone_sync.py get --title "Sprint 1"

issue_sync.py

Gerencia issues com integracao SDLC.

# Criar issue com labels SDLC
python3 .claude/skills/github-sync/scripts/issue_sync.py create \
  --title "[TASK-001] Implementar feature X" \
  --body-file task.md \
  --phase 5 \
  --type task \
  --milestone "Sprint 1"

# Atualizar issue
python3 .claude/skills/github-sync/scripts/issue_sync.py update \
  --number 123 \
  --phase 6 \
  --state open

# Sincronizar task YAML para issue
python3 .claude/skills/github-sync/scripts/issue_sync.py sync-task \
  --task-path .agentic_sdlc/projects/xxx/tasks/task-001.yml

# Buscar issue por titulo
python3 .claude/skills/github-sync/scripts/issue_sync.py find --title "[TASK-001]"

Mapeamento SDLC <-> GitHub

Labels por Cor

Integracao com Outros Skills

Esta skill e usada por:

• github-projects - Para criar issues e adicionar ao project
• orchestrator - Para sincronizar estado do SDLC com GitHub
• delivery-planner - Para criar milestones de sprints

Pre-requisitos

• GitHub CLI (gh) instalado e autenticado
• Permissoes de escrita no repositorio
• Scope project para integracao com Projects V2

# Verificar autenticacao
gh auth status

# Adicionar scope project se necessario
gh auth refresh -s project

Exemplos de Uso

Preparar repositorio para SDLC

# 1. Criar labels
python3 .claude/skills/github-sync/scripts/label_manager.py ensure

# 2. Criar primeiro milestone
python3 .claude/skills/github-sync/scripts/milestone_sync.py create \
  --title "Sprint 1" \
  --description "Inicio do projeto" \
  --due-date "$(date -d '+14 days' +%Y-%m-%d)"

Criar issue para task

python3 .claude/skills/github-sync/scripts/issue_sync.py create \
  --title "[TASK-001] Implementar autenticacao" \
  --body "## Descricao\n\nImplementar sistema de autenticacao OAuth2.\n\n## Acceptance Criteria\n\n- [ ] Login funcional\n- [ ] Logout funcional" \
  --phase 5 \
  --type task \
  --milestone "Sprint 1"

Transicao de fase

# Atualizar issue para nova fase
python3 .claude/skills/github-sync/scripts/issue_sync.py update \
  --number 123 \
  --phase 6

Converted and distributed by TomeVault — claim your Tome and manage your conversions.