Merge 8891fa17ea into da71eaebd2
This commit is contained in:
Glucksberg
GitHub
commit
c973e4ee27
229
skills/fork-manager/SKILL.md
Normal file
229
skills/fork-manager/SKILL.md
Normal file
@ -0,0 +1,229 @@
|
|||||||
|
---
|
||||||
|
name: fork-manager
|
||||||
|
description: Manage forks with open PRs - sync upstream, rebase branches, track PR status, and maintain production branches with pending contributions.
|
||||||
|
metadata: {"moltbot":{"emoji":"🍴","os":["darwin","linux"],"requires":{"bins":["git","gh"]}}}
|
||||||
|
---
|
||||||
|
|
||||||
|
# Fork Manager Skill
|
||||||
|
|
||||||
|
Skill para gerenciar forks de repositórios onde você contribui com PRs mas também usa as melhorias antes de serem mergeadas no upstream.
|
||||||
|
|
||||||
|
## Quando usar
|
||||||
|
|
||||||
|
- Usuário pede para atualizar/sincronizar um fork
|
||||||
|
- Usuário quer saber status dos PRs abertos
|
||||||
|
- Usuário quer fazer rebase das branches de PR
|
||||||
|
- Usuário quer criar uma branch de produção com todos os PRs
|
||||||
|
|
||||||
|
## Configuração
|
||||||
|
|
||||||
|
Configs ficam em `~/.clawdbot/fork-manager/<repo-name>.json`:
|
||||||
|
|
||||||
|
```json
|
||||||
|
{
|
||||||
|
"repo": "owner/repo",
|
||||||
|
"fork": "your-user/repo",
|
||||||
|
"localPath": "/path/to/local/clone",
|
||||||
|
"mainBranch": "main",
|
||||||
|
"productionBranch": "main-with-all-prs",
|
||||||
|
"upstreamRemote": "upstream",
|
||||||
|
"originRemote": "origin",
|
||||||
|
"openPRs": [123, 456],
|
||||||
|
"prBranches": {
|
||||||
|
"123": "fix/issue-123",
|
||||||
|
"456": "feat/feature-456"
|
||||||
|
},
|
||||||
|
"lastSync": "2026-01-28T12:00:00Z"
|
||||||
|
}
|
||||||
|
```
|
||||||
|
|
||||||
|
## Fluxo de Análise
|
||||||
|
|
||||||
|
### 1. Carregar config
|
||||||
|
|
||||||
|
```bash
|
||||||
|
CONFIG_DIR=~/.clawdbot/fork-manager
|
||||||
|
cat "$CONFIG_DIR/<repo>.json"
|
||||||
|
```
|
||||||
|
|
||||||
|
### 2. Navegar para o repositório
|
||||||
|
|
||||||
|
```bash
|
||||||
|
cd <localPath>
|
||||||
|
```
|
||||||
|
|
||||||
|
### 3. Fetch de ambos remotes
|
||||||
|
|
||||||
|
```bash
|
||||||
|
git fetch <upstreamRemote>
|
||||||
|
git fetch <originRemote>
|
||||||
|
```
|
||||||
|
|
||||||
|
### 4. Analisar estado do main
|
||||||
|
|
||||||
|
```bash
|
||||||
|
# Commits que upstream tem e origin/main não tem
|
||||||
|
git log --oneline <originRemote>/<mainBranch>..<upstreamRemote>/<mainBranch>
|
||||||
|
|
||||||
|
# Contar commits atrás
|
||||||
|
git rev-list --count <originRemote>/<mainBranch>..<upstreamRemote>/<mainBranch>
|
||||||
|
```
|
||||||
|
|
||||||
|
### 5. Verificar PRs abertos via GitHub CLI
|
||||||
|
|
||||||
|
```bash
|
||||||
|
# Listar PRs abertos do usuário
|
||||||
|
gh pr list --state open --author @me --json number,title,headRefName,state
|
||||||
|
|
||||||
|
# Verificar status de um PR específico
|
||||||
|
gh pr view <number> --json state,mergedAt,closedAt,title
|
||||||
|
```
|
||||||
|
|
||||||
|
### 6. Classificar cada PR
|
||||||
|
|
||||||
|
Para cada PR no config, verificar:
|
||||||
|
|
||||||
|
| Estado | Condição | Ação |
|
||||||
|
|--------|----------|------|
|
||||||
|
| **open** | PR aberto no GitHub | Manter, verificar se precisa rebase |
|
||||||
|
| **merged** | PR foi mergeado | Remover do config, deletar branch local |
|
||||||
|
| **closed** | PR fechado sem merge | Verificar motivo, possivelmente remover |
|
||||||
|
| **conflict** | Branch tem conflitos com upstream | Precisa rebase manual |
|
||||||
|
| **outdated** | Branch está atrás do upstream | Precisa rebase |
|
||||||
|
|
||||||
|
Comando para verificar se branch precisa rebase:
|
||||||
|
```bash
|
||||||
|
git log --oneline <upstreamRemote>/<mainBranch>..<originRemote>/<branch> | wc -l # commits à frente
|
||||||
|
git log --oneline <originRemote>/<branch>..<upstreamRemote>/<mainBranch> | wc -l # commits atrás
|
||||||
|
```
|
||||||
|
|
||||||
|
## Comandos do Agente
|
||||||
|
|
||||||
|
### `status` - Verificar estado atual
|
||||||
|
|
||||||
|
1. Carregar config
|
||||||
|
2. Fetch remotes
|
||||||
|
3. Contar commits atrás do upstream
|
||||||
|
4. Listar PRs e seus estados
|
||||||
|
5. Reportar ao usuário
|
||||||
|
|
||||||
|
### `sync` - Sincronizar main com upstream
|
||||||
|
|
||||||
|
```bash
|
||||||
|
cd <localPath>
|
||||||
|
git fetch <upstreamRemote>
|
||||||
|
git checkout <mainBranch>
|
||||||
|
git merge <upstreamRemote>/<mainBranch>
|
||||||
|
git push <originRemote> <mainBranch>
|
||||||
|
```
|
||||||
|
|
||||||
|
### `rebase <branch>` - Rebase de uma branch específica
|
||||||
|
|
||||||
|
```bash
|
||||||
|
git checkout <branch>
|
||||||
|
git fetch <upstreamRemote>
|
||||||
|
git rebase <upstreamRemote>/<mainBranch>
|
||||||
|
# Se conflito: resolver e git rebase --continue
|
||||||
|
git push <originRemote> <branch> --force-with-lease
|
||||||
|
```
|
||||||
|
|
||||||
|
### `rebase-all` - Rebase de todas as branches de PR
|
||||||
|
|
||||||
|
Para cada branch em `prBranches`:
|
||||||
|
1. Checkout da branch
|
||||||
|
2. Rebase no upstream/main
|
||||||
|
3. Push com --force-with-lease
|
||||||
|
4. Reportar sucesso/falha
|
||||||
|
|
||||||
|
### `update-config` - Atualizar config com PRs atuais
|
||||||
|
|
||||||
|
```bash
|
||||||
|
# Buscar PRs abertos
|
||||||
|
gh pr list --state open --author @me --repo <repo> --json number,headRefName
|
||||||
|
|
||||||
|
# Atualizar o arquivo JSON com os PRs atuais
|
||||||
|
```
|
||||||
|
|
||||||
|
### `build-production` - Criar branch de produção com todos os PRs
|
||||||
|
|
||||||
|
```bash
|
||||||
|
cd <localPath>
|
||||||
|
git fetch <upstreamRemote>
|
||||||
|
git fetch <originRemote>
|
||||||
|
|
||||||
|
# Deletar branch antiga se existir
|
||||||
|
git branch -D <productionBranch> 2>/dev/null || true
|
||||||
|
|
||||||
|
# Criar nova branch a partir do upstream
|
||||||
|
git checkout -b <productionBranch> <upstreamRemote>/<mainBranch>
|
||||||
|
|
||||||
|
# Mergear cada PR branch
|
||||||
|
for branch in <prBranches>; do
|
||||||
|
git merge <originRemote>/$branch -m "Merge PR #<number>: <title>"
|
||||||
|
# Se conflito, resolver
|
||||||
|
done
|
||||||
|
|
||||||
|
# Push
|
||||||
|
git push <originRemote> <productionBranch> --force
|
||||||
|
|
||||||
|
# Build
|
||||||
|
bun run build
|
||||||
|
```
|
||||||
|
|
||||||
|
### `full-sync` - Sincronização completa
|
||||||
|
|
||||||
|
1. `sync` - Atualizar main
|
||||||
|
2. `update-config` - Atualizar lista de PRs
|
||||||
|
3. `rebase-all` - Rebase de todas as branches
|
||||||
|
4. `build-production` - Recriar branch de produção
|
||||||
|
5. `bun run build` - Rebuild
|
||||||
|
|
||||||
|
## Relatório para o Usuário
|
||||||
|
|
||||||
|
Após qualquer operação, gerar relatório:
|
||||||
|
|
||||||
|
```markdown
|
||||||
|
## 🍴 Fork Status: <repo>
|
||||||
|
|
||||||
|
### Upstream Sync
|
||||||
|
- **Main branch:** X commits behind upstream
|
||||||
|
- **Last sync:** <date>
|
||||||
|
|
||||||
|
### Open PRs (Y total)
|
||||||
|
|
||||||
|
| # | Branch | Status | Action Needed |
|
||||||
|
|---|--------|--------|---------------|
|
||||||
|
| 123 | fix/issue-123 | ✅ Up to date | None |
|
||||||
|
| 456 | feat/feature | ⚠️ Needs rebase | Run rebase |
|
||||||
|
| 789 | fix/bug | ❌ Has conflicts | Manual resolution |
|
||||||
|
|
||||||
|
### Production Branch
|
||||||
|
- **Branch:** main-with-all-prs
|
||||||
|
- **Contains:** PRs #123, #456, #789
|
||||||
|
- **Status:** ✅ Up to date / ⚠️ Needs rebuild
|
||||||
|
|
||||||
|
### Recommended Actions
|
||||||
|
1. ...
|
||||||
|
2. ...
|
||||||
|
```
|
||||||
|
|
||||||
|
## Notas Importantes
|
||||||
|
|
||||||
|
- Sempre usar `--force-with-lease` em vez de `--force` para push
|
||||||
|
- Sempre fazer backup antes de operações destrutivas
|
||||||
|
- Usar `bun run` em vez de `npm run`
|
||||||
|
- Verificar se há trabalho não commitado antes de operações git
|
||||||
|
- Manter o config atualizado após cada operação
|
||||||
|
|
||||||
|
## Exemplo de Uso
|
||||||
|
|
||||||
|
Usuário: "atualiza meu fork do claude-mem"
|
||||||
|
|
||||||
|
Agente:
|
||||||
|
1. Lê config de `~/.clawdbot/fork-manager/claude-mem.json`
|
||||||
|
2. Executa `status` para entender situação atual
|
||||||
|
3. Se main está atrás, executa `sync`
|
||||||
|
4. Se PRs precisam rebase, executa `rebase-all`
|
||||||
|
5. Atualiza `productionBranch` se necessário
|
||||||
|
6. Executa `bun run build`
|
||||||
|
7. Reporta resultado ao usuário
|
||||||
Loading…
Reference in New Issue
Block a user