Notre avis
Ce protocole guide l'utilisateur dans la réalisation de fusions Git sûres et la résolution des problèmes courants, notamment pour GitHub Pages.
Points forts
- Fournit un protocole étape par étape pour éviter les fusions incomplètes.
- Inclut des solutions spécifiques au cache de GitHub Pages.
- Propose des techniques de dépannage pour les états bloqués (rebase, verrous).
Limites
- Ne couvre pas les stratégies avancées de gestion de conflits complexes.
- Les solutions de cache de GitHub Pages peuvent être temporaires.
- Certaines commandes nécessitent des privilèges administrateur sur le système de fichiers.
Utilisez ce protocole lorsque vous effectuez une fusion entre branches ou que vous rencontrez des problèmes de mise à jour de GitHub Pages.
Ne l'utilisez pas pour des fusions très simples sans historique complexe ou lorsque vous utilisez un workflow de rebase systématique.
Analyse de sécurité
PrudenceThe skill provides legitimate git troubleshooting instructions, but includes commands like `rm`, `reset --hard`, and `taskkill` that can be destructive if misused. There is no indication of exfiltration, code execution from remote sources, or disabling safety mechanisms. The risk is typical for developer tooling documentation.
- •Uses `rm -f` which could delete files if misdirected.
- •Uses `git reset --hard` which can permanently discard changes.
- •Uses `taskkill /f` on Windows, which forcefully terminates processes and may cause data loss.
Exemples
J'ai fusionné une branche feature dans main, mais tous les commits ne sont pas arrivés. Comment puis-je vérifier et corriger cela ?Mon site GitHub Pages ne montre pas les dernières modifications après un merge. Que puis-je faire pour forcer une mise à jour ?Git est bloqué en mode rebase après une tentative de rebase avortée. Comment le réinitialiser proprement ?🚀 Skill: Git Merge Mastery - Evitar Problemas de Merge
Objetivo
Prevenir e resolver problemas comuns de git merge, especialmente com GitHub Pages.
Problemas Comuns Identificados
- Merge incompleto - Commits da feature branch não chegam no main
- Cache do GitHub Pages - HTML antigo persiste mesmo após updates
- Conflitos de arquivos binários - HTML/CSS com conflitos complexos
- Rebase travado - Git em estado inconsistent
📋 Protocolo de Merge Seguro
1. PRÉ-MERGE (Preparação)
# Verificar diferenças entre branches
git diff main..feature/nova-feature --name-only
# Verificar histórico
git log --oneline --graph --all --decorate -10
# Ensure clean working directory
git status
git checkout .
2. MERGE CORRETO (Passo a passo)
# 1. Atualizar main
git checkout main
git pull origin main
# 2. Fazer merge explícito
git merge feature/nova-feature --no-ff -m "feat: merge completo de feature/nova-feature"
# 3. Verificar conflitos
git status
# 4. Resolver conflitos se necessário
git checkout --theirs arquivo-conflitante.html
git add arquivo-conflitante.html
# 5. Finalizar merge
git commit -m "resolve: conflitos do merge"
3. PÓS-MERGE (Validação)
# Verificar se TODOS os commits chegaram
git log --oneline -5
# Verificar arquivos específicos
git show HEAD --name-only
# Testar localmente antes do push
python -m http.server 8000 # Verificar se funciona
🎯 Solução Para GitHub Pages Cache
Quando o GitHub Pages não atualiza:
# 1. Mudar nome do arquivo principal (FORÇA rebuild)
mv docs/index.html docs/dashboard-NOVO.html
# 2. Criar redirect simples
echo "<!DOCTYPE html><html><head><meta http-equiv='refresh' content='0; URL=./dashboard-NOVO.html'></head><body>Redirecting...</body></html>" > docs/index.html
# 3. Commit e push
git add docs/index.html docs/dashboard-NOVO.html
git commit -m "fix: força rebuild GitHub Pages com redirect"
git push
# 4. Após 5min, restaurar nome original
mv docs/dashboard-NOVO.html docs/index.html
git add docs/index.html
git commit -m "fix: restaura nome original após rebuild"
git push
🔧 Troubleshooting de Estados Travados
Git em rebase/interactive mode:
# Abortar rebase
git rebase --abort
# Resetar para estado limpo
git reset --hard origin/main
# Remover locks se necessário
rm -f .git/index.lock
Processos git travados (Windows):
# Matar processos git
taskkill /f /im git*
taskkill /f /im GitHubDesktop.exe
📊 Verificação de Sucesso
Após merge, verificar:
- ✅ GitHub Actions passando
- ✅ GitHub Pages atualizado (aguardar 2-5min)
- ✅ Testar URL atual com Ctrl+Shift+R (hard refresh)
- ✅ Confirmar que todos os arquivos da feature estão no main
⚠️ Checklists de Segurança
ANTES de fazer merge:
- [ ] Backup dos arquivos importantes
- [ ] Verificar diferenças entre branches
- [ ] Testar feature branch localmente
- [ ] Coordenar com time se aplicável
APÓS merge:
- [ ] Verificar se build passa
- [ ] Testar produção
- [ ] Documentar mudanças
- [ ] Informar stakeholders
🚨 Casos Especiais
Merge de grandes refactors:
# Fazer merge gradual
git merge feature/refactor --no-commit
# Verificar arquivo por arquivo
git status
git diff --cached
# Commit apenas quando confirmado
git commit -m "feat: merge seguro de refactor grande"
Rollback seguro:
# Reverter merge específico
git revert -m 1 MERGE_COMMIT_HASH
# Ou reset hard (cuidado!)
git reset --hard COMMIT_ANTERIOR
Lembrete: Sempre prefira merge --no-ff para manter histórico claro e evitar problemas com GitHub Pages!
Expert Next.js App Router
Developpement
Un skill qui transforme Claude en expert Next.js App Router.
Générateur de README
Developpement
Crée des README.md professionnels et complets pour vos projets.
Rédacteur de Documentation API
Developpement
Génère de la documentation API complète au format OpenAPI/Swagger.