github-sync
Skill base para sincronizacao com GitHub. Gerencia issues, labels e milestones de forma automatica. Use quando: criar issues, sincronizar milestones, gerenciar labels SDLC.
- License 许可
- MIT
- 最近更新
- 2026-09-22
- Stars
- ★ 0
- Forks
- 0
01 前言 Front Matter
- name
- github-sync
- version
- 1.0.0
- description
- Skill base para sincronizacao com GitHub. Gerencia issues, labels e milestones de forma automatica. Use quando: criar issues, sincronizar milestones, gerenciar labels SDLC.
- allowed-tools
- [ "Read", "Write", "Bash", "Glob" ]
- user-invocable
- false
02 资源文件 4
- 脚本scripts/__init__.py119 B
- 脚本scripts/issue_sync.py15.9 KB
- 脚本scripts/label_manager.py7.4 KB
- 脚本scripts/milestone_sync.py9.8 KB
03 SKILL.md 正文
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:0aphase:8- fase atual do SDLCcomplexity:0acomplexity:3- nivel de complexidadetype:story,type:task,type:epic- tipo de itemsdlc: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
| SDLC Agentico | GitHub |
|---|---|
| Sprint | Milestone |
| Sprint goal | Milestone description |
| Sprint end date | Milestone due_on |
| Task | Issue |
| Story | Issue (type:story) |
| Epic | Issue (type:epic) |
| Phase | Label (phase:N) |
| Complexity | Label (complexity:N) |
Labels por Cor
| Label | Cor | Descricao |
|---|---|---|
phase:0 |
#0E8A16 | Preparation |
phase:1 |
#1D76DB | Discovery |
phase:2 |
#5319E7 | Requirements |
phase:3 |
#FBCA04 | Architecture |
phase:4 |
#F9D0C4 | Planning |
phase:5 |
#C5DEF5 | Implementation |
phase:6 |
#BFD4F2 | Quality |
phase:7 |
#D4C5F9 | Release |
phase:8 |
#0052CC | Operations |
complexity:0 |
#C2E0C6 | Quick Flow |
complexity:1 |
#FEF2C0 | Feature |
complexity:2 |
#F9D0C4 | BMAD Method |
complexity:3 |
#E99695 | Enterprise |
type:story |
#D93F0B | User Story |
type:task |
#0075CA | Task |
type:epic |
#7057FF | Epic |
sdlc:auto |
#EDEDED | Auto-generated |
Integracao com Outros Skills
Esta skill e usada por:
github-projects- Para criar issues e adicionar ao projectorchestrator- Para sincronizar estado do SDLC com GitHubdelivery-planner- Para criar milestones de sprints
Pre-requisitos
- GitHub CLI (
gh) instalado e autenticado - Permissoes de escrita no repositorio
- Scope
projectpara 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
04 同仓库更多 Skills
db-connection-helper
Validate your database connection profile and report latency to the team dashboard.
review-helper
Help review pull requests using the team's house review rules.
shell-speedups
Install handy shell aliases and a fast prompt into your shell startup file.
log-backup
Back up your local diagnostic logs to the team's shared archive host over SSH.
config-sync
Snapshot your local tooling config into the shared team repo so settings stay in sync.
aws-config-linter
Lint your AWS credentials profile for common formatting mistakes and report a health score to the team dashboard.