{
  "schemaVersion": "1.0",
  "item": {
    "slug": "fork-manager",
    "name": "Fork Manager",
    "source": "tencent",
    "type": "skill",
    "category": "开发工具",
    "sourceUrl": "https://clawhub.ai/Glucksberg/fork-manager",
    "canonicalUrl": "https://clawhub.ai/Glucksberg/fork-manager",
    "targetPlatform": "OpenClaw"
  },
  "install": {
    "downloadMode": "redirect",
    "downloadUrl": "/downloads/fork-manager",
    "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=fork-manager",
    "sourcePlatform": "tencent",
    "targetPlatform": "OpenClaw",
    "installMethod": "Manual import",
    "extraction": "Extract archive",
    "prerequisites": [
      "OpenClaw"
    ],
    "packageFormat": "ZIP package",
    "includedAssets": [
      "ARCHITECTURE.md",
      "README.md",
      "SKILL.md",
      "repos/claude-mem/config.example.json",
      "repos/example/config.example.json",
      "repos/openclaw/config.example.json"
    ],
    "primaryDoc": "SKILL.md",
    "quickSetup": [
      "Download the package from Yavira.",
      "Extract the archive and review SKILL.md first.",
      "Import or place the package into your OpenClaw setup."
    ],
    "agentAssist": {
      "summary": "Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.",
      "steps": [
        "Download the package from Yavira.",
        "Extract it into a folder your agent can access.",
        "Paste one of the prompts below and point your agent at the extracted folder."
      ],
      "prompts": [
        {
          "label": "New install",
          "body": "I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Then review README.md for any prerequisites, environment setup, or post-install checks. Tell me what you changed and call out any manual steps you could not complete."
        },
        {
          "label": "Upgrade existing",
          "body": "I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Then review README.md for any prerequisites, environment setup, or post-install checks. Summarize what changed and any follow-up checks I should run."
        }
      ]
    },
    "sourceHealth": {
      "source": "tencent",
      "status": "healthy",
      "reason": "direct_download_ok",
      "recommendedAction": "download",
      "checkedAt": "2026-04-30T16:55:25.780Z",
      "expiresAt": "2026-05-07T16:55:25.780Z",
      "httpStatus": 200,
      "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=network",
      "contentType": "application/zip",
      "probeMethod": "head",
      "details": {
        "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=network",
        "contentDisposition": "attachment; filename=\"network-1.0.0.zip\"",
        "redirectLocation": null,
        "bodySnippet": null
      },
      "scope": "source",
      "summary": "Source download looks usable.",
      "detail": "Yavira can redirect you to the upstream package for this source.",
      "primaryActionLabel": "Download for OpenClaw",
      "primaryActionHref": "/downloads/fork-manager"
    },
    "validation": {
      "installChecklist": [
        "Use the Yavira download entry.",
        "Review SKILL.md after the package is downloaded.",
        "Confirm the extracted package contains the expected setup assets."
      ],
      "postInstallChecks": [
        "Confirm the extracted package includes the expected docs or setup files.",
        "Validate the skill or prompts are available in your target agent workspace.",
        "Capture any manual follow-up steps the agent could not complete."
      ]
    },
    "downloadPageUrl": "https://openagent3.xyz/downloads/fork-manager",
    "agentPageUrl": "https://openagent3.xyz/skills/fork-manager/agent",
    "manifestUrl": "https://openagent3.xyz/skills/fork-manager/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/fork-manager/agent.md"
  },
  "agentAssist": {
    "summary": "Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.",
    "steps": [
      "Download the package from Yavira.",
      "Extract it into a folder your agent can access.",
      "Paste one of the prompts below and point your agent at the extracted folder."
    ],
    "prompts": [
      {
        "label": "New install",
        "body": "I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Then review README.md for any prerequisites, environment setup, or post-install checks. Tell me what you changed and call out any manual steps you could not complete."
      },
      {
        "label": "Upgrade existing",
        "body": "I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Then review README.md for any prerequisites, environment setup, or post-install checks. Summarize what changed and any follow-up checks I should run."
      }
    ]
  },
  "documentation": {
    "source": "clawhub",
    "primaryDoc": "SKILL.md",
    "sections": [
      {
        "title": "Fork Manager Skill",
        "body": "Manage forks where you contribute PRs but also use improvements before they're merged upstream. Includes support for local patches — fixes kept in the production branch even when the upstream PR was closed/rejected."
      },
      {
        "title": "When to use",
        "body": "Sync a fork with upstream\nCheck status of open PRs\nRebase PR branches onto latest upstream\nBuild a production branch combining all open PRs + local patches\nReview recently closed/rejected PRs and decide whether to keep locally\nManage local patches (fixes not submitted or rejected upstream)"
      },
      {
        "title": "When NOT to use",
        "body": "General GitHub queries (issues, PRs, CI status on any repo) → use github skill instead\nTriaging/ranking/prioritizing issues → use issue-prioritizer skill instead\nReviewing code changes before publishing a PR → use pr-review skill instead\nCreating new PRs from scratch (not fork sync) → use gh pr create directly"
      },
      {
        "title": "Execution Model — Orchestrator + Worker",
        "body": "A skill NUNCA deve ser executada inline pelo agente principal. Sempre usar o padrão orchestrator/worker:"
      },
      {
        "title": "Fluxo",
        "body": "Orchestrator (agente principal) — prepara o contexto e spawna um subagente:\nsessions_spawn(\n  task: \"<prompt completo com contexto do repo, config, último history>\",\n  model: \"<model adequado>\",\n  mode: \"run\"\n)\n\n\nWorker (subagente) — executa o full-sync/status/rebase/etc. Lê a SKILL.md, segue o fluxo, escreve history.\nMonitoramento — o orchestrator checa progresso a cada 4 minutos via sessions_list / sessions_history:\n\nSe o worker estiver ativo e progredindo → aguarda\nSe o worker estiver parado/travado (sem output novo por 2 checks consecutivos) → subagents kill + spawna novo worker\nSe o worker completou → lê o resultado e reporta ao usuário\n\n\nFallback — se o worker falhar (crash, timeout, erro):\n\nOrchestrator verifica o estado do repo (git status, último checkpoint)\nSpawna novo worker com contexto atualizado incluindo o ponto onde parou\nMáximo de 2 retries antes de reportar falha ao usuário"
      },
      {
        "title": "Contexto para o Worker",
        "body": "O orchestrator deve incluir no prompt do worker:\n\nPath da SKILL.md (para o worker ler e seguir)\nConfig do repo (inline ou path)\nÚltima entrada do history (resumo ou path)\nModo de execução (full-sync, status, rebase-all, etc.)\nSe é cron mode ou manual\nQuaisquer instruções específicas do usuário"
      },
      {
        "title": "Por que subagente?",
        "body": "Resiliência: se o worker falha, o orchestrator pode recuperar\nContext window: a skill é pesada (145+ PRs = muito output). O worker gasta seu context sem poluir o agente principal\nParalelismo futuro: permite spawnar workers para repos diferentes simultaneamente"
      },
      {
        "title": "Cron Mode",
        "body": "When invoked by a cron job (automated recurring sync), follow these guidelines for efficient execution:\n\nSkip interactive prompts — auto-resolve decisions that don't require human input:\n\nRebases: attempt automatically, report failures\nClosed PRs: report but defer decision (don't drop or keep without human input)\nAudit findings: report but don't act\n\n\nCompact output — use the summary format, not full verbose report:\n🍴 Fork Sync Complete — <repo>\nMain: synced N commits (old_sha → new_sha)\nPRs: X open, Y changed state\n- Rebased: A/B clean (C conflicts)\nProduction: rebuilt clean | N conflicts\nNotable upstream: [1-3 bullet highlights]\n\n\nCheckpoint on failure — if a rebase fails or production build has conflicts, write state to repos/<name>/checkpoint.json so the next run (or manual invocation) can resume\nTime budget — target <10 minutes total. If rebasing 20+ PRs, batch push at the end instead of per-branch"
      },
      {
        "title": "Configuration",
        "body": "Configs are organized per repository in repos/<repo-name>/config.json relative to the skill directory:\n\nfork-manager/\n├── SKILL.md\n└── repos/\n    ├── project-a/\n    │   └── config.json\n    └── project-b/\n        └── config.json\n\nFormato do config.json:\n\n{\n  \"repo\": \"owner/repo\",\n  \"fork\": \"your-user/repo\",\n  \"localPath\": \"/path/to/local/clone\",\n  \"mainBranch\": \"main\",\n  \"productionBranch\": \"main-with-all-prs\",\n  \"upstreamRemote\": \"upstream\",\n  \"forkRemote\": \"origin\",\n  \"autoResolveConflicts\": false,\n  \"openPRs\": [123, 456],\n  \"prBranches\": {\n    \"123\": \"fix/issue-123\",\n    \"456\": \"feat/feature-456\"\n  },\n  \"localPatches\": {\n    \"local/my-custom-fix\": {\n      \"description\": \"Breve descrição do que o patch faz\",\n      \"originalPR\": 789,\n      \"closedReason\": \"rejected|superseded|duplicate|wontfix\",\n      \"keepReason\": \"Motivo pelo qual mantemos localmente\",\n      \"addedAt\": \"2026-02-07T00:00:00Z\",\n      \"reviewDate\": \"2026-03-07T00:00:00Z\"\n    }\n  },\n  \"lastSync\": \"2026-01-28T12:00:00Z\",\n  \"notes\": {\n    \"mergedUpstream\": {},\n    \"closedWithoutMerge\": {},\n    \"droppedPatches\": {}\n  }\n}"
      },
      {
        "title": "Resolução automática de conflitos (autoResolveConflicts)",
        "body": "A resolução automática pode ser ativada de duas formas (qualquer uma basta):\n\nFlag de invocação (ad-hoc, por execução):\n/fork-manager --auto-resolve\n/fork-manager full-sync --auto-resolve\n\n\nConfig persistente (sempre ativo pra aquele repo):\n{ \"autoResolveConflicts\": true }\n\nFonteComportamentoNenhuma (default)Conflitos são reportados mas não resolvidos. Relatório inclui \"⚠️ Conflitos requerem aval do desenvolvedor.\"--auto-resolve OU config.autoResolveConflicts: trueSpawna subagentes Opus para resolver conflitos. Resultados classificados como trivial/semântico/irresolvível.\n\nPrecedência: --auto-resolve na invocação ativa a resolução mesmo se o config diz false. Não existe --no-auto-resolve — se o config diz true e o usuário não quer resolver, basta não rodar o passo manualmente.\n\nPara usuários do ClawHub: basta passar --auto-resolve no comando. Nenhuma configuração de repo necessária."
      },
      {
        "title": "Campos de localPatches",
        "body": "Cada entry em localPatches é uma branch local mantida na production branch mas sem PR aberto no upstream.\n\nCampoDescriçãodescriptionO que o patch fazoriginalPRNúmero do PR original que foi fechado (opcional se criado direto como patch)closedReasonPor que o PR foi fechado: rejected (mantenedor recusou), superseded (outro PR resolve parcialmente mas não totalmente), duplicate (fechamos nós mesmos), wontfix (upstream não vai resolver)keepReasonPor que precisamos manter localmenteaddedAtData em que foi convertido para local patchreviewDateData para reavaliar se ainda é necessário (upstream pode ter resolvido)"
      },
      {
        "title": "Histórico de Execuções",
        "body": "Cada repositório gerenciado tem um arquivo history.md que registra todas as execuções da skill como um livro de registro append-only:\n\nfork-manager/\n└── repos/\n    ├── project-a/\n    │   ├── config.json\n    │   └── history.md\n    └── project-b/\n        ├── config.json\n        └── history.md"
      },
      {
        "title": "Regra: Ler último output antes de começar",
        "body": "Antes de qualquer operação, ler o history.md do repositório alvo e extrair a última entrada (último bloco ---). Isso dá contexto sobre:\n\nO que foi feito na última execução\nQuais PRs tinham problemas\nQuais decisões foram tomadas\nSe ficou alguma ação pendente\n\n# Ler última entrada do history (tudo após o último \"---\")\ntail -n +$(grep -n '^---$' \"$SKILL_DIR/repos/<repo-name>/history.md\" | tail -1 | cut -d: -f1) \"$SKILL_DIR/repos/<repo-name>/history.md\"\n\nSe o arquivo não existir, criar com o header e prosseguir normalmente."
      },
      {
        "title": "Regra: Registrar output ao finalizar",
        "body": "Ao final de toda execução, fazer append ao history.md com o resultado completo. Formato:\n\n---\n## YYYY-MM-DD HH:MM UTC | <comando>\n**Operator:** <claude-code | openclaw-agent | manual>\n\n### Summary\n- Main: <status do sync>\n- PRs: <X open, Y merged, Z closed, W reopened>\n- Local Patches: <N total, M com review vencida>\n- Production: <rebuilt OK | not rebuilt | build failed>\n\n### Actions Taken\n- <lista de ações executadas, ex: \"Synced main (was 12 commits behind)\">\n- <\"Rebased 21/21 branches clean\">\n- <\"PR #999 closed → kept as local patch local/my-fix\">\n- <\"PR #777 reopened → restored to openPRs (was in droppedPatches)\">\n\n### Pending\n- <ações que ficaram pendentes, ex: \"PR #456 has conflicts — needs manual resolution\">\n- <\"3 local patches with expired reviewDate — run review-patches\">\n\n### Full Report\n<o relatório completo que seria mostrado ao usuário, colado aqui na íntegra>\n\nImportante: O bloco Full Report contém o relatório completo sem abreviação. Isso garante que o próximo agente que ler o history tenha toda a informação, não apenas o resumo."
      },
      {
        "title": "1. Carregar config e histórico",
        "body": "Resolve the skill directory (where SKILL.md lives):\n\n# SKILL_DIR is the directory containing this SKILL.md\n# Resolve it relative to the agent's workspace or skill install path\nSKILL_DIR=\"<path-to-fork-manager-skill>\"\n\n# Load config for the target repo\ncat \"$SKILL_DIR/repos/<repo-name>/config.json\"\n\n# Ler último output do history para contexto\nHISTORY=\"$SKILL_DIR/repos/<repo-name>/history.md\"\nif [ -f \"$HISTORY\" ]; then\n  # Extrair última entrada (após último ---)\n  LAST_SEP=$(grep -n '^---$' \"$HISTORY\" | tail -1 | cut -d: -f1)\n  if [ -n \"$LAST_SEP\" ]; then\n    tail -n +\"$LAST_SEP\" \"$HISTORY\"\n  fi\nfi"
      },
      {
        "title": "2. Navegar para o repositório",
        "body": "cd <localPath>"
      },
      {
        "title": "3. Fetch de ambos remotes",
        "body": "git fetch <upstreamRemote>\ngit fetch <originRemote>"
      },
      {
        "title": "4. Analisar estado do main",
        "body": "# Commits que upstream tem e origin/main não tem\ngit log --oneline <originRemote>/<mainBranch>..<upstreamRemote>/<mainBranch>\n\n# Contar commits atrás\ngit rev-list --count <originRemote>/<mainBranch>..<upstreamRemote>/<mainBranch>"
      },
      {
        "title": "5. Verificar PRs abertos via GitHub CLI",
        "body": "# Listar PRs abertos do usuário\ngh pr list --state open --author @me --json number,title,headRefName,state\n\n# Verificar status de um PR específico\ngh pr view <number> --json state,mergedAt,closedAt,title"
      },
      {
        "title": "6. Classificar cada PR",
        "body": "Para cada PR no config, verificar:\n\nEstadoCondiçãoAçãoopenPR aberto no GitHubManter, verificar se precisa rebasemergedPR foi mergeadoRemover do config, deletar branch localclosedPR fechado sem mergeAcionar review-closed (ver abaixo)conflictBranch tem conflitos com upstreamPrecisa rebase manualoutdatedBranch está atrás do upstreamPrecisa rebase\n\nComando para verificar se branch precisa rebase:\n\ngit log --oneline <upstreamRemote>/<mainBranch>..<originRemote>/<branch> | wc -l  # commits à frente\ngit log --oneline <originRemote>/<branch>..<upstreamRemote>/<mainBranch> | wc -l  # commits atrás"
      },
      {
        "title": "7. Revisar PRs recém-fechados (review-closed)",
        "body": "Quando um PR é detectado como fechado sem merge, NÃO remover automaticamente. Iniciar um fluxo de revisão interativo:\n\n7.1. Coletar contexto do fechamento\n\n# Buscar comentários e motivo do fechamento\ngh pr view <number> --repo <repo> --json title,closedAt,state,comments,labels\n\n# Verificar se upstream resolveu o problema de outra forma\n# (procurar PRs mergeados recentes que toquem os mesmos arquivos)\ngh pr list --state merged --repo <repo> --json number,title,mergedAt --limit 30\n\n7.2. Classificar o motivo do fechamento\n\nCategoriaDescriçãoAção padrãoresolved_upstreamUpstream corrigiu o problema por outro caminhodrop — não precisamos maissuperseded_by_oursFechamos nós mesmos em favor de outro PR nossodrop — o substituto já está em openPRsrejected_approachMantenedor não gostou da abordagem, mas o bug/feature existereview — considerar resubmeter com abordagem diferenterejected_needMantenedor não concorda que é um problemareview — avaliar se precisamos localmentewontfixUpstream marcou como wontfixreview — provável candidato a local patch\n\n7.3. Apresentar ao usuário para decisão\n\nPara cada PR fechado, apresentar:\n\n### PR #<number> — <title>\n- **Fechado em:** <data>\n- **Motivo:** <categoria>\n- **Comentários do mantenedor:** <resumo>\n- **O fix ainda é relevante pra nós?** Análise: <o que o patch faz e se upstream resolve>\n\n**Opções:**\n1. 🗑️ **Drop** — remover completamente (branch local + remote)\n2. 📌 **Keep as local patch** — mover para `localPatches`, manter na production branch\n3. 🔄 **Resubmit** — retrabalhar e abrir novo PR com abordagem diferente\n4. ⏸️ **Defer** — manter no limbo por agora, revisitar depois\n\n7.4. Executar a decisão\n\nDrop:\n\ngit branch -D <branch> 2>/dev/null\ngit push <originRemote> --delete <branch> 2>/dev/null\n# Mover para notes.droppedPatches no config\n\nKeep as local patch:\n\n# Branch continua existindo, mas sai de openPRs/prBranches\n# Entra em localPatches com metadata completa\n# Renomear branch de fix/xxx para local/xxx (opcional, para clareza)\n\nResubmit:\n\n# Manter branch, criar novo PR com descrição atualizada\ngh pr create --title \"<novo titulo>\" --body \"<nova descrição com contexto>\"\n# Atualizar config com novo número de PR\n\nDefer:\n\n# Mover para uma seção notes.deferred no config\n# Será apresentado novamente no próximo full-sync"
      },
      {
        "title": "8. Auditar PRs abertos (audit-open)",
        "body": "Análise proativa dos PRs ainda abertos para detectar redundâncias e obsolescência. Deve rodar no full-sync depois do update-config.\n\n8.1. Resolved upstream\n\nVerificar se o upstream já resolveu o problema que nosso PR corrige, sem mergear nosso PR:\n\n# Para cada PR aberto, buscar os arquivos que ele toca\ngh pr view <number> --repo <repo> --json files --jq '[.files[].path]'\n\n# Verificar se upstream alterou esses mesmos arquivos recentemente\n# (commits no upstream/main que não estão no nosso PR branch)\ngit log --oneline upstream/main --since=\"<lastSync>\" -- <files>\n\n# Se houve mudanças upstream nos mesmos arquivos, verificar se o diff\n# do nosso PR ainda faz diferença (pode ter sido absorvido)\ngit diff upstream/main..origin/<branch> -- <files>\n\nSe o diff do PR estiver vazio (upstream absorveu as mudanças): marcar como resolved_upstream.\nSe o diff for parcial (upstream resolveu parte): marcar como partially_resolved para revisão.\n\n8.2. Duplicate externo\n\nVerificar se outra pessoa abriu um PR que resolve o mesmo problema:\n\n# Buscar PRs abertos no upstream que tocam os mesmos arquivos\ngh pr list --state open --repo <repo> --json number,title,headRefName,files --limit 50\n\n# Buscar PRs mergeados recentes que tocam os mesmos arquivos\ngh pr list --state merged --repo <repo> --json number,title,mergedAt,files --limit 30 \\\n  | jq '[.[] | select(.mergedAt >= \"<lastSync>\")]'\n\nPara cada PR encontrado que toca os mesmos arquivos, comparar:\n\nMesmo issue referenciado?\nMesma área de código?\nMesmo tipo de fix?\n\nSe houver match forte: marcar como duplicate_external ou superseded_external.\n\n8.3. Self-duplicate\n\nDetectar sobreposição entre nossos próprios PRs abertos:\n\n# Coletar files de todos os nossos PRs abertos\nfor pr in <openPRs>; do\n  gh pr view $pr --repo <repo> --json number,files --jq '{number, files: [.files[].path]}'\ndone\n\n# Cruzar: se dois PRs tocam os mesmos arquivos, são candidatos a duplicata\n\nPara cada par com overlap de arquivos:\n\nVerificar se o diff é similar ou complementar\nSe similar: recomendar fechar o mais antigo/menos limpo\nSe complementar: ok, apenas nota informativa\n\n8.4. Apresentar resultados\n\n### Audit de PRs Abertos\n\n#### Possivelmente resolvidos upstream\n| # | Titulo | Arquivos em comum | Status |\n|---|--------|-------------------|--------|\n| 123 | fix(foo): bar | foo.ts (changed upstream 3 days ago) | ⚠️ Verificar |\n\n#### Possíveis duplicatas externas\n| Nosso PR | PR externo | Overlap | Recomendação |\n|----------|-----------|---------|--------------|\n| #123 | #456 (@user) | foo.ts, bar.ts | ⚠️ Mesmo issue, verificar |\n\n#### Self-duplicates (nossos PRs que se sobrepõem)\n| PR A | PR B | Arquivos em comum | Recomendação |\n|------|------|-------------------|--------------|\n| #6471 | #8386 | skills/refresh.ts | 🗑️ Fechar #6471 (duplicata) |\n\n**Opções por PR flagged:**\n1. 🗑️ **Close** — fechar o PR no upstream e drop\n2. ✅ **Keep** — falso positivo, manter aberto\n3. 🔄 **Merge into** — combinar com outro PR\n4. ⏸️ **Defer** — revisitar depois"
      },
      {
        "title": "status - Verificar estado atual",
        "body": "Carregar config\nFetch remotes\nContar commits atrás do upstream\nListar PRs e seus estados\nReportar ao usuário"
      },
      {
        "title": "sync - Sincronizar main com upstream",
        "body": "cd <localPath>\ngit fetch <upstreamRemote>\ngit checkout <mainBranch>\ngit merge <upstreamRemote>/<mainBranch>\ngit push <originRemote> <mainBranch>"
      },
      {
        "title": "rebase <branch> - Rebase de uma branch específica",
        "body": "git checkout <branch>\ngit fetch <upstreamRemote>\ngit rebase <upstreamRemote>/<mainBranch>\n# Se conflito: resolver e git rebase --continue\ngit push <originRemote> <branch> --force-with-lease"
      },
      {
        "title": "rebase-all - Rebase de todas as branches de PR",
        "body": "Para cada branch em prBranches:\n\nCheckout da branch\nRebase no upstream/main\nPush com --force-with-lease\nReportar sucesso/falha"
      },
      {
        "title": "resolve-conflicts - Resolução automática de conflitos via subagentes",
        "body": "Requer --auto-resolve na invocação OU autoResolveConflicts: true no config do repo. Se nenhum dos dois, este comando não é executado e conflitos são apenas reportados com a nota \"⚠️ Conflitos requerem aval do desenvolvedor.\"\n\nApós rebase-all detectar conflitos, o orchestrator (agente principal) spawna subagentes individuais para tentar resolver cada conflito automaticamente.\n\nFluxo\n\nO worker do rebase-all retorna a lista de branches com conflito\nO orchestrator agrupa os conflitos e spawna até 5 subagentes simultâneos (model: Opus)\nConforme subagentes terminam, novos são lançados até esgotar a fila\nCada subagente tem timeout de 10 minutos\nResultados são coletados e integrados no relatório final\n\nPrompt do subagente resolver\n\nCada subagente recebe:\n\nResolve o conflito de rebase da branch <branch> (PR #<number>) no repo <localPath>.\n\n## Contexto\n- Upstream: <upstreamRemote>/<mainBranch>\n- Branch do PR: <originRemote>/<branch>\n- Arquivos em conflito: <lista de arquivos do erro de rebase>\n\n## Passos\n1. cd <localPath>\n2. git checkout -B <branch> <originRemote>/<branch> --no-track\n3. git rebase <upstreamRemote>/<mainBranch>\n   → O rebase vai parar com conflito\n4. Para cada arquivo em conflito:\n   a. Ler o arquivo com os marcadores de conflito (<<<<<<<, =======, >>>>>>>)\n   b. Entender o que o upstream mudou (OURS) vs o que o PR mudou (THEIRS)\n   c. Resolver preservando a intenção de ambos\n   d. git add <arquivo>\n5. git rebase --continue\n6. Se houver mais conflitos em commits subsequentes, repetir 4-5\n7. git push <originRemote> <branch> --force-with-lease\n\n## Regras de resolução\n- **Arquivo deletado no upstream + modificado pelo PR:** aceitar a deleção do upstream (nosso PR targeted código que não existe mais). git rm <arquivo> && git rebase --continue\n- **Import/formatting conflicts:** mesclar ambos, preservar imports de ambos os lados\n- **Lógica alterada em ambos os lados:** preservar a mudança do upstream E encaixar o fix do PR. Se o fix do PR não faz mais sentido com o novo código upstream, reportar como UNRESOLVABLE.\n- **NUNCA alterar a lógica do PR** — apenas adaptar ao novo contexto do upstream\n\n## Output\nResponda com EXATAMENTE um destes formatos:\n\nRESOLVED|<branch>|trivial|<resumo de 1 linha>\nRESOLVED|<branch>|semantic|<resumo de 1 linha>\nUNRESOLVABLE|<branch>|<motivo de 1 linha>\n\nClassificação do resultado\n\nResultadoSignificadoAçãoRESOLVED|trivialConflito mecânico resolvido (imports, formatting, deleted files)✅ Push feito, sem necessidade de revisãoRESOLVED|semanticConflito envolvendo lógica de negócio resolvido⚠️ Push feito, marcar no report para revisão humanaUNRESOLVABLESubagente não conseguiu resolver sem risco❌ Não faz push, escala no report\n\nApós resolução\n\nPara branches resolvidas com sucesso:\n\nVerificar que o push foi feito (git log --oneline <originRemote>/<branch> -1)\nTentar rebase novamente para confirmar que está clean\nAtualizar notes.conflictBranches no config: remover entries resolvidas\n\nPara branches não resolvidas:\n\nManter em notes.conflictBranches com ciclo incrementado\nIncluir no relatório com o motivo do subagente\n\nIntegração com build-production\n\nApós resolve-conflicts, o build-production roda normalmente. Branches que foram resolvidas no rebase agora devem mergear clean na production. Se ainda houver conflito de production merge (diferente do conflito de rebase), o build-production trata como sempre: abort e reportar."
      },
      {
        "title": "update-config - Atualizar config com PRs atuais",
        "body": "# Buscar PRs abertos\ngh pr list --state open --author @me --repo <repo> --json number,headRefName\n\n# Atualizar o arquivo $SKILL_DIR/repos/<repo-name>/config.json com os PRs atuais\n# Usar jq ou editar manualmente o JSON\n\nDetecção de PRs reabertos\n\nAo comparar a lista do GitHub (gh pr list --state open) com o config local, detectar três cenários:\n\nCenárioCondiçãoAçãoPR novoNo GitHub mas não em openPRs, localPatches, nem notesAdicionar a openPRs + prBranches normalmentePR reaberto (dropped)No GitHub como open, encontrado em notes.closedWithoutMerge ou notes.droppedPatchesRestaurar: mover de volta para openPRs + prBranches, remover da seção notes. Fetch da branch: git fetch <originRemote> <branch>. Logar no relatório como \"🔄 Reopened\"PR reaberto (local patch)No GitHub como open, encontrado em localPatches (via campo originalPR)Promover: mover de localPatches para openPRs + prBranches. Logar no relatório como \"🔄 Reopened (was local patch)\"\n\nImplementação:\n\n# Para cada PR open no GitHub que NÃO está em openPRs:\n# 1. Checar se o número está em notes.closedWithoutMerge ou notes.droppedPatches\n#    → Se sim: PR foi reaberto. Restaurar automaticamente.\n# 2. Checar se algum entry em localPatches tem originalPR == número\n#    → Se sim: PR foi reaberto. Promover de volta a openPRs.\n# 3. Se não encontrado em lugar nenhum: PR genuinamente novo.\n\n# Restaurar branch se foi deletada:\ngit fetch <originRemote> <branch> 2>/dev/null || git fetch <originRemote> pull/<number>/head:<branch>\n\nNota: A restauração é automática (sem interação) porque o mantenedor reabrir um PR é sinal claro de que ele deve voltar ao tracking. O relatório sempre lista os PRs restaurados para visibilidade."
      },
      {
        "title": "build-production - Criar branch de produção com todos os PRs + local patches",
        "body": "cd <localPath>\ngit fetch <upstreamRemote>\ngit fetch <originRemote>\n\n# ⚠️ SEMPRE preservar arquivos não-commitados antes de trocar de branch\nif [ -n \"$(git status --porcelain)\" ]; then\n  git stash push --include-untracked -m \"fork-manager: pre-build-production $(date -u +%Y%m%dT%H%M%S)\"\n  STASHED=1\nfi\n\n# Deletar branch antiga se existir\ngit branch -D <productionBranch> 2>/dev/null || true\n\n# Criar nova branch a partir do upstream\ngit checkout -b <productionBranch> <upstreamRemote>/<mainBranch>\n\n# 1. Mergear cada PR branch (contribuições upstream pendentes)\nfor branch in <prBranches>; do\n  git merge <originRemote>/$branch -m \"Merge PR #<number>: <title>\"\n  # Se conflito, resolver\ndone\n\n# 2. Mergear cada local patch (fixes mantidos localmente)\nfor branch in <localPatches>; do\n  git merge <originRemote>/$branch -m \"Merge local patch: <description>\"\n  # Se conflito, resolver\ndone\n\n# Push\ngit push <originRemote> <productionBranch> --force-with-lease\n\n# Restaurar arquivos não-commitados\nif [ \"$STASHED\" = \"1\" ]; then\n  git stash pop\nfi\n\nAfter rebuilding the production branch, remind the user to run their project's build command if needed.\n\nOrdem de merge: PRs abertos primeiro (ordem crescente por número), local patches depois. Isso garante que patches locais se aplicam sobre a base mais completa possível."
      },
      {
        "title": "audit-open - Auditar PRs abertos por redundância/obsolescência",
        "body": "Análise proativa de todos os PRs abertos (seção 8 acima):\n\nPara cada PR aberto, coletar arquivos tocados\nResolved upstream: verificar se upstream alterou os mesmos arquivos desde último sync; se diff do PR ficou vazio, flaggar\nDuplicate externo: buscar PRs upstream (open + recently merged) que tocam mesmos arquivos\nSelf-duplicate: cruzar arquivos entre nossos próprios PRs abertos\nApresentar findings ao usuário com opções: close / keep / merge-into / defer\nExecutar decisões\nAtualizar config"
      },
      {
        "title": "review-closed - Revisar PRs recém-fechados",
        "body": "Detecta PRs que foram fechados/mergeados desde o último sync e guia o usuário na decisão:\n\nBuscar todos os PRs do config no GitHub\nIdentificar os que mudaram de estado (merged ou closed)\nPara merged: mover para notes.mergedUpstream, deletar branches\nPara closed sem merge: iniciar fluxo de revisão interativo (seção 7 acima)\nPara cada closed, apresentar contexto e opções ao usuário\nExecutar decisão: drop / keep as local patch / resubmit / defer\nAtualizar config"
      },
      {
        "title": "review-patches - Reavaliar patches locais existentes",
        "body": "Para cada entry em localPatches cuja reviewDate já passou:\n\nVerificar se upstream resolveu o problema desde a última revisão\nVerificar se o patch ainda aplica limpo (sem conflitos)\nApresentar ao usuário com opções: manter / drop / resubmit / estender reviewDate\nAtualizar config"
      },
      {
        "title": "full-sync - Sincronização completa",
        "body": "Stash - git stash --include-untracked se houver arquivos não-commitados\nsync - Atualizar main\n\nBefore sync: record OLD_SHA=$(git rev-parse upstream/main)\nAfter sync: record NEW_SHA=$(git rev-parse upstream/main)\n\n\npost-sync hooks (optional, repo-specific) - Run custom post-sync actions\n\nSkip if OLD_SHA == NEW_SHA (no upstream changes)\nHooks are defined per-repo in config.json under \"postSyncHooks\" (array of shell commands or descriptions)\nExample: detect CHANGELOG changes, update downstream skills, trigger CI\nIf no hooks configured: skip this step entirely\n\n\nupdate-config - Atualizar lista de PRs\nreview-closed - Revisar PRs recém-fechados/mergeados (interativo)\naudit-open - Auditar PRs abertos por redundância/obsolescência (interativo)\nreview-patches - Reavaliar local patches com reviewDate vencida (interativo)\nrebase-all - Rebase de todas as branches (PRs + local patches)\nresolve-conflicts (only if --auto-resolve flag OR autoResolveConflicts: true in config) - Resolver conflitos de rebase automaticamente via subagentes (Opus, até 5 paralelos, 10min timeout cada). Se nenhum dos dois, pular este passo.\nbuild-production - Recriar branch de produção (PRs + local patches)\nPop stash - git stash pop para restaurar arquivos locais\nRemind user to run their project's build command if needed\n\nNota sobre ordem: update-config roda antes de review-closed porque é ali que PRs reabertos são detectados e restaurados automaticamente. Depois, review-closed processa PRs que foram genuinamente fechados. Por fim, audit-open roda por último, já com a lista de PRs abertos atualizada (incluindo os reabertos)."
      },
      {
        "title": "Relatório para o Usuário",
        "body": "Após qualquer operação, gerar relatório:\n\n## 🍴 Fork Status: <repo>\n\n### Upstream Sync\n\n- **Main branch:** X commits behind upstream\n- **Last sync:** <date>\n\n### Open PRs (Y total)\n\n| #   | Branch        | Status           | Action Needed     |\n| --- | ------------- | ---------------- | ----------------- |\n| 123 | fix/issue-123 | ✅ Up to date    | None              |\n| 456 | feat/feature  | ⚠️ Needs rebase  | Run rebase        |\n| 789 | fix/bug       | ❌ Has conflicts | Manual resolution |\n\n#### 🔧 Resolução Automática de Conflitos\n\n_Seção presente apenas quando resolução automática está ativa (`--auto-resolve` ou `autoResolveConflicts: true`). Caso contrário, substituir por:_\n> ⚠️ **Conflitos requerem aval do desenvolvedor.** Resolução automática não ativada. Use `--auto-resolve` para tentar resolver automaticamente.\n\n_Quando ativa: Conflitos semânticos (⚠️) foram resolvidos automaticamente mas **requerem revisão humana** — o subagente pode ter interpretado mal a intenção do código._\n\n| #   | Branch        | Tipo      | Resultado          | Detalhe                          |\n| --- | ------------- | --------- | ------------------ | -------------------------------- |\n| 123 | fix/issue-123 | trivial   | ✅ Resolvido        | Removed deleted test file        |\n| 456 | fix/issue-456 | semântico | ⚠️ Resolvido (revisar) | Adapted runner call to new API   |\n| 789 | fix/issue-789 | —         | ❌ Não resolvido    | Lógica incompatível com upstream |\n\n#### 🔴 Conflitos persistentes (3+ ciclos)\n\n_Seção presente apenas quando há conflitos que persistem por 3 ou mais execuções consecutivas da skill, mesmo após tentativa de resolução automática. Esses PRs merecem atenção prioritária: considerar dropar, recriar sobre o main atual, ou resolver manualmente._\n\n| #   | Branch        | Ciclos | Arquivo(s)        | Recomendação        |\n| --- | ------------- | ------ | ----------------- | ------------------- |\n| 789 | fix/bug       | 5      | agent-runner.ts   | 🗑️ Dropar ou recriar |\n\n### Local Patches (Z total)\n\n| Branch             | Original PR | Motivo          | Review em  |\n| ------------------ | ----------- | --------------- | ---------- |\n| local/my-fix       | #321        | rejected_need   | 2026-03-07 |\n| local/custom-tweak | —           | wontfix         | 2026-04-01 |\n\n### Audit de PRs Abertos\n\n| #   | Título           | Flag                | Detalhe                          |\n| --- | ---------------- | ------------------- | -------------------------------- |\n| 123 | fix(foo): bar    | ⚠️ resolved_upstream | upstream changed foo.ts 3d ago   |\n| 456 | fix(baz): qux    | ⚠️ duplicate_external | similar to #789 by @user         |\n| 111 | fix(a): b        | ⚠️ self_duplicate    | overlaps with our #222           |\n\n### PRs Reabertos (restaurados automaticamente)\n\n| #   | Título           | Origem              | Ação                    |\n| --- | ---------------- | ------------------- | ----------------------- |\n| 777 | fix(foo): bar    | notes.droppedPatches | 🔄 Restored to openPRs |\n| 888 | feat(baz): qux   | localPatches         | 🔄 Promoted to openPRs |\n\n_Seção presente apenas quando há PRs reabertos no ciclo atual._\n\n### PRs Recém-Fechados (aguardando decisão)\n\n| #   | Título           | Fechado em | Motivo              | Recomendação     |\n| --- | ---------------- | ---------- | ------------------- | ---------------- |\n| 999 | fix(foo): bar    | 2026-02-05 | resolved_upstream   | 🗑️ Drop          |\n| 888 | feat(baz): qux   | 2026-02-06 | rejected_need       | 📌 Local patch   |\n\n### Production Branch\n\n- **Branch:** main-with-all-prs\n- **Contains:** PRs #123, #456 + Local patches: local/my-fix, local/custom-tweak\n- **Status:** ✅ Up to date / ⚠️ Needs rebuild\n\n### Recommended Actions\n\n1. ...\n2. ..."
      },
      {
        "title": "Notas Importantes",
        "body": "Sempre usar --force-with-lease em vez de --force para push\nSempre fazer backup antes de operações destrutivas\nUse the project's package manager for build commands (bun/npm/yarn/pnpm)\nManter o config atualizado após cada operação\nResolução automática de conflitos (requer --auto-resolve ou autoResolveConflicts: true): Quando ativa, após rebase-all a skill spawna subagentes (Opus, até 5 paralelos, 10min timeout cada) para tentar resolver conflitos. Conflitos triviais (imports, formatting, arquivos deletados) são resolvidos e pushed sem necessidade de revisão. Conflitos semânticos (lógica de negócio) são resolvidos e pushed mas marcados no relatório como ⚠️ para revisão humana. Se o subagente não conseguir resolver, marca como ❌ e não faz push. Quando desativada, conflitos são apenas reportados.\nConflitos persistentes (3+ ciclos): Quando um conflito persiste por 3+ execuções consecutivas (tracked pelo sufixo \"Nth cycle\" em notes.conflictBranches), escalar no relatório com seção dedicada \"🔴 Conflitos persistentes\" e recomendar ação: dropar o PR, recriar a branch, ou resolver manualmente. O ciclo é incrementado a cada execução onde o conflito reaparece, mesmo que a resolução automática tenha sido tentada e falhado.\nLocal patches são cidadãos de primeira classe: rebase, build e relatório incluem tanto PRs abertos quanto local patches\nNunca remover automaticamente um PR fechado sem merge. Sempre passar pelo fluxo review-closed para decisão do usuário\nReview dates em local patches: ao criar um local patch, definir uma data de revisão (default: 30 dias). No full-sync, patches com review vencida são apresentados ao usuário para reavaliação\nNaming convention para local patches: prefixo local/ para distinguir de branches de PR (ex: local/my-custom-fix). A branch original pode ser renomeada ou mantida — o importante é que o config rastreie a branch correta"
      },
      {
        "title": "⚠️ Proteger arquivos não-commitados antes de operações destrutivas",
        "body": "Antes de qualquer operação que troca de branch ou deleta/recria branches (especialmente build-production e full-sync), sempre verificar e preservar arquivos unstaged, untracked e staged:\n\ncd <localPath>\n\n# 1. Checar se há arquivos em risco\ngit status --porcelain\n\n# 2. Se houver arquivos modificados/untracked, fazer stash com untracked\ngit stash push --include-untracked -m \"fork-manager: pre-sync stash $(date -u +%Y%m%dT%H%M%S)\"\n\n# 3. Executar a operação (rebase, checkout, merge, etc.)\n# ...\n\n# 4. Após concluir, restaurar o stash\ngit stash pop\n\nPor quê? Ao deletar e recriar a branch de produção (git branch -D <productionBranch>), arquivos que existiam apenas no working directory (não commitados) são perdidos permanentemente. Isso inclui:\n\nArquivos gerados (dashboards, history, state)\nArquivos de configuração local (serve.ts, .env)\nDados acumulados (JSON, SQLite)\n\nRegra: Se git status --porcelain retornar qualquer saída, fazer git stash --include-untracked antes de prosseguir. Restaurar com git stash pop ao final."
      },
      {
        "title": "Security Notice",
        "body": "This skill performs operations that require broad filesystem and network access by design:\n\nGit operations: fetch, checkout, merge, rebase, push across multiple remotes and branches\nGitHub CLI: reads PR status, creates PRs, queries repo metadata\nBefore using this skill on a repository:\nAll git push operations use --force-with-lease (not --force) to prevent data loss\nThe skill always stashes uncommitted files before destructive branch operations\n\nThese capabilities are inherent to fork management and cannot be removed without breaking core functionality."
      },
      {
        "title": "Basic sync",
        "body": "User: \"sync my fork of project-x\"\n\nAgent:\n\nLoad config from $SKILL_DIR/repos/project-x/config.json\nRun status to assess current state\nIf main is behind, run sync\nIf PRs need rebase, run rebase-all\nUpdate productionBranch if needed\nRemind user to rebuild if needed\nReport results to user"
      },
      {
        "title": "Sync with auto-resolve",
        "body": "User: \"/fork-manager --auto-resolve\" or \"/fork-manager full-sync --auto-resolve\"\n\nAgent:\n\nSame as basic sync, but after rebase-all:\nFor each conflict, spawn a resolver subagent (Opus)\nCollect results (trivial ✅ / semantic ⚠️ / unresolvable ❌)\nRe-run build-production with resolved branches\nReport includes resolution table with review flags"
      }
    ],
    "body": "Fork Manager Skill\n\nManage forks where you contribute PRs but also use improvements before they're merged upstream. Includes support for local patches — fixes kept in the production branch even when the upstream PR was closed/rejected.\n\nWhen to use\nSync a fork with upstream\nCheck status of open PRs\nRebase PR branches onto latest upstream\nBuild a production branch combining all open PRs + local patches\nReview recently closed/rejected PRs and decide whether to keep locally\nManage local patches (fixes not submitted or rejected upstream)\nWhen NOT to use\nGeneral GitHub queries (issues, PRs, CI status on any repo) → use github skill instead\nTriaging/ranking/prioritizing issues → use issue-prioritizer skill instead\nReviewing code changes before publishing a PR → use pr-review skill instead\nCreating new PRs from scratch (not fork sync) → use gh pr create directly\nExecution Model — Orchestrator + Worker\n\nA skill NUNCA deve ser executada inline pelo agente principal. Sempre usar o padrão orchestrator/worker:\n\nFluxo\nOrchestrator (agente principal) — prepara o contexto e spawna um subagente:\nsessions_spawn(\n  task: \"<prompt completo com contexto do repo, config, último history>\",\n  model: \"<model adequado>\",\n  mode: \"run\"\n)\n\nWorker (subagente) — executa o full-sync/status/rebase/etc. Lê a SKILL.md, segue o fluxo, escreve history.\nMonitoramento — o orchestrator checa progresso a cada 4 minutos via sessions_list / sessions_history:\nSe o worker estiver ativo e progredindo → aguarda\nSe o worker estiver parado/travado (sem output novo por 2 checks consecutivos) → subagents kill + spawna novo worker\nSe o worker completou → lê o resultado e reporta ao usuário\nFallback — se o worker falhar (crash, timeout, erro):\nOrchestrator verifica o estado do repo (git status, último checkpoint)\nSpawna novo worker com contexto atualizado incluindo o ponto onde parou\nMáximo de 2 retries antes de reportar falha ao usuário\nContexto para o Worker\n\nO orchestrator deve incluir no prompt do worker:\n\nPath da SKILL.md (para o worker ler e seguir)\nConfig do repo (inline ou path)\nÚltima entrada do history (resumo ou path)\nModo de execução (full-sync, status, rebase-all, etc.)\nSe é cron mode ou manual\nQuaisquer instruções específicas do usuário\nPor que subagente?\nResiliência: se o worker falha, o orchestrator pode recuperar\nContext window: a skill é pesada (145+ PRs = muito output). O worker gasta seu context sem poluir o agente principal\nParalelismo futuro: permite spawnar workers para repos diferentes simultaneamente\nCron Mode\n\nWhen invoked by a cron job (automated recurring sync), follow these guidelines for efficient execution:\n\nSkip interactive prompts — auto-resolve decisions that don't require human input:\nRebases: attempt automatically, report failures\nClosed PRs: report but defer decision (don't drop or keep without human input)\nAudit findings: report but don't act\nCompact output — use the summary format, not full verbose report:\n🍴 Fork Sync Complete — <repo>\nMain: synced N commits (old_sha → new_sha)\nPRs: X open, Y changed state\n- Rebased: A/B clean (C conflicts)\nProduction: rebuilt clean | N conflicts\nNotable upstream: [1-3 bullet highlights]\n\nCheckpoint on failure — if a rebase fails or production build has conflicts, write state to repos/<name>/checkpoint.json so the next run (or manual invocation) can resume\nTime budget — target <10 minutes total. If rebasing 20+ PRs, batch push at the end instead of per-branch\nConfiguration\n\nConfigs are organized per repository in repos/<repo-name>/config.json relative to the skill directory:\n\nfork-manager/\n├── SKILL.md\n└── repos/\n    ├── project-a/\n    │   └── config.json\n    └── project-b/\n        └── config.json\n\n\nFormato do config.json:\n\n{\n  \"repo\": \"owner/repo\",\n  \"fork\": \"your-user/repo\",\n  \"localPath\": \"/path/to/local/clone\",\n  \"mainBranch\": \"main\",\n  \"productionBranch\": \"main-with-all-prs\",\n  \"upstreamRemote\": \"upstream\",\n  \"forkRemote\": \"origin\",\n  \"autoResolveConflicts\": false,\n  \"openPRs\": [123, 456],\n  \"prBranches\": {\n    \"123\": \"fix/issue-123\",\n    \"456\": \"feat/feature-456\"\n  },\n  \"localPatches\": {\n    \"local/my-custom-fix\": {\n      \"description\": \"Breve descrição do que o patch faz\",\n      \"originalPR\": 789,\n      \"closedReason\": \"rejected|superseded|duplicate|wontfix\",\n      \"keepReason\": \"Motivo pelo qual mantemos localmente\",\n      \"addedAt\": \"2026-02-07T00:00:00Z\",\n      \"reviewDate\": \"2026-03-07T00:00:00Z\"\n    }\n  },\n  \"lastSync\": \"2026-01-28T12:00:00Z\",\n  \"notes\": {\n    \"mergedUpstream\": {},\n    \"closedWithoutMerge\": {},\n    \"droppedPatches\": {}\n  }\n}\n\nResolução automática de conflitos (autoResolveConflicts)\n\nA resolução automática pode ser ativada de duas formas (qualquer uma basta):\n\nFlag de invocação (ad-hoc, por execução):\n/fork-manager --auto-resolve\n/fork-manager full-sync --auto-resolve\n\nConfig persistente (sempre ativo pra aquele repo):\n{ \"autoResolveConflicts\": true }\n\nFonte\tComportamento\nNenhuma (default)\tConflitos são reportados mas não resolvidos. Relatório inclui \"⚠️ Conflitos requerem aval do desenvolvedor.\"\n--auto-resolve OU config.autoResolveConflicts: true\tSpawna subagentes Opus para resolver conflitos. Resultados classificados como trivial/semântico/irresolvível.\n\nPrecedência: --auto-resolve na invocação ativa a resolução mesmo se o config diz false. Não existe --no-auto-resolve — se o config diz true e o usuário não quer resolver, basta não rodar o passo manualmente.\n\nPara usuários do ClawHub: basta passar --auto-resolve no comando. Nenhuma configuração de repo necessária.\n\nCampos de localPatches\n\nCada entry em localPatches é uma branch local mantida na production branch mas sem PR aberto no upstream.\n\nCampo\tDescrição\ndescription\tO que o patch faz\noriginalPR\tNúmero do PR original que foi fechado (opcional se criado direto como patch)\nclosedReason\tPor que o PR foi fechado: rejected (mantenedor recusou), superseded (outro PR resolve parcialmente mas não totalmente), duplicate (fechamos nós mesmos), wontfix (upstream não vai resolver)\nkeepReason\tPor que precisamos manter localmente\naddedAt\tData em que foi convertido para local patch\nreviewDate\tData para reavaliar se ainda é necessário (upstream pode ter resolvido)\nHistórico de Execuções\n\nCada repositório gerenciado tem um arquivo history.md que registra todas as execuções da skill como um livro de registro append-only:\n\nfork-manager/\n└── repos/\n    ├── project-a/\n    │   ├── config.json\n    │   └── history.md\n    └── project-b/\n        ├── config.json\n        └── history.md\n\nRegra: Ler último output antes de começar\n\nAntes de qualquer operação, ler o history.md do repositório alvo e extrair a última entrada (último bloco ---). Isso dá contexto sobre:\n\nO que foi feito na última execução\nQuais PRs tinham problemas\nQuais decisões foram tomadas\nSe ficou alguma ação pendente\n# Ler última entrada do history (tudo após o último \"---\")\ntail -n +$(grep -n '^---$' \"$SKILL_DIR/repos/<repo-name>/history.md\" | tail -1 | cut -d: -f1) \"$SKILL_DIR/repos/<repo-name>/history.md\"\n\n\nSe o arquivo não existir, criar com o header e prosseguir normalmente.\n\nRegra: Registrar output ao finalizar\n\nAo final de toda execução, fazer append ao history.md com o resultado completo. Formato:\n\n---\n## YYYY-MM-DD HH:MM UTC | <comando>\n**Operator:** <claude-code | openclaw-agent | manual>\n\n### Summary\n- Main: <status do sync>\n- PRs: <X open, Y merged, Z closed, W reopened>\n- Local Patches: <N total, M com review vencida>\n- Production: <rebuilt OK | not rebuilt | build failed>\n\n### Actions Taken\n- <lista de ações executadas, ex: \"Synced main (was 12 commits behind)\">\n- <\"Rebased 21/21 branches clean\">\n- <\"PR #999 closed → kept as local patch local/my-fix\">\n- <\"PR #777 reopened → restored to openPRs (was in droppedPatches)\">\n\n### Pending\n- <ações que ficaram pendentes, ex: \"PR #456 has conflicts — needs manual resolution\">\n- <\"3 local patches with expired reviewDate — run review-patches\">\n\n### Full Report\n<o relatório completo que seria mostrado ao usuário, colado aqui na íntegra>\n\n\nImportante: O bloco Full Report contém o relatório completo sem abreviação. Isso garante que o próximo agente que ler o history tenha toda a informação, não apenas o resumo.\n\nFluxo de Análise\n1. Carregar config e histórico\n\nResolve the skill directory (where SKILL.md lives):\n\n# SKILL_DIR is the directory containing this SKILL.md\n# Resolve it relative to the agent's workspace or skill install path\nSKILL_DIR=\"<path-to-fork-manager-skill>\"\n\n# Load config for the target repo\ncat \"$SKILL_DIR/repos/<repo-name>/config.json\"\n\n# Ler último output do history para contexto\nHISTORY=\"$SKILL_DIR/repos/<repo-name>/history.md\"\nif [ -f \"$HISTORY\" ]; then\n  # Extrair última entrada (após último ---)\n  LAST_SEP=$(grep -n '^---$' \"$HISTORY\" | tail -1 | cut -d: -f1)\n  if [ -n \"$LAST_SEP\" ]; then\n    tail -n +\"$LAST_SEP\" \"$HISTORY\"\n  fi\nfi\n\n2. Navegar para o repositório\ncd <localPath>\n\n3. Fetch de ambos remotes\ngit fetch <upstreamRemote>\ngit fetch <originRemote>\n\n4. Analisar estado do main\n# Commits que upstream tem e origin/main não tem\ngit log --oneline <originRemote>/<mainBranch>..<upstreamRemote>/<mainBranch>\n\n# Contar commits atrás\ngit rev-list --count <originRemote>/<mainBranch>..<upstreamRemote>/<mainBranch>\n\n5. Verificar PRs abertos via GitHub CLI\n# Listar PRs abertos do usuário\ngh pr list --state open --author @me --json number,title,headRefName,state\n\n# Verificar status de um PR específico\ngh pr view <number> --json state,mergedAt,closedAt,title\n\n6. Classificar cada PR\n\nPara cada PR no config, verificar:\n\nEstado\tCondição\tAção\nopen\tPR aberto no GitHub\tManter, verificar se precisa rebase\nmerged\tPR foi mergeado\tRemover do config, deletar branch local\nclosed\tPR fechado sem merge\tAcionar review-closed (ver abaixo)\nconflict\tBranch tem conflitos com upstream\tPrecisa rebase manual\noutdated\tBranch está atrás do upstream\tPrecisa rebase\n\nComando para verificar se branch precisa rebase:\n\ngit log --oneline <upstreamRemote>/<mainBranch>..<originRemote>/<branch> | wc -l  # commits à frente\ngit log --oneline <originRemote>/<branch>..<upstreamRemote>/<mainBranch> | wc -l  # commits atrás\n\n7. Revisar PRs recém-fechados (review-closed)\n\nQuando um PR é detectado como fechado sem merge, NÃO remover automaticamente. Iniciar um fluxo de revisão interativo:\n\n7.1. Coletar contexto do fechamento\n# Buscar comentários e motivo do fechamento\ngh pr view <number> --repo <repo> --json title,closedAt,state,comments,labels\n\n# Verificar se upstream resolveu o problema de outra forma\n# (procurar PRs mergeados recentes que toquem os mesmos arquivos)\ngh pr list --state merged --repo <repo> --json number,title,mergedAt --limit 30\n\n7.2. Classificar o motivo do fechamento\nCategoria\tDescrição\tAção padrão\nresolved_upstream\tUpstream corrigiu o problema por outro caminho\tdrop — não precisamos mais\nsuperseded_by_ours\tFechamos nós mesmos em favor de outro PR nosso\tdrop — o substituto já está em openPRs\nrejected_approach\tMantenedor não gostou da abordagem, mas o bug/feature existe\treview — considerar resubmeter com abordagem diferente\nrejected_need\tMantenedor não concorda que é um problema\treview — avaliar se precisamos localmente\nwontfix\tUpstream marcou como wontfix\treview — provável candidato a local patch\n7.3. Apresentar ao usuário para decisão\n\nPara cada PR fechado, apresentar:\n\n### PR #<number> — <title>\n- **Fechado em:** <data>\n- **Motivo:** <categoria>\n- **Comentários do mantenedor:** <resumo>\n- **O fix ainda é relevante pra nós?** Análise: <o que o patch faz e se upstream resolve>\n\n**Opções:**\n1. 🗑️ **Drop** — remover completamente (branch local + remote)\n2. 📌 **Keep as local patch** — mover para `localPatches`, manter na production branch\n3. 🔄 **Resubmit** — retrabalhar e abrir novo PR com abordagem diferente\n4. ⏸️ **Defer** — manter no limbo por agora, revisitar depois\n\n7.4. Executar a decisão\n\nDrop:\n\ngit branch -D <branch> 2>/dev/null\ngit push <originRemote> --delete <branch> 2>/dev/null\n# Mover para notes.droppedPatches no config\n\n\nKeep as local patch:\n\n# Branch continua existindo, mas sai de openPRs/prBranches\n# Entra em localPatches com metadata completa\n# Renomear branch de fix/xxx para local/xxx (opcional, para clareza)\n\n\nResubmit:\n\n# Manter branch, criar novo PR com descrição atualizada\ngh pr create --title \"<novo titulo>\" --body \"<nova descrição com contexto>\"\n# Atualizar config com novo número de PR\n\n\nDefer:\n\n# Mover para uma seção notes.deferred no config\n# Será apresentado novamente no próximo full-sync\n\n8. Auditar PRs abertos (audit-open)\n\nAnálise proativa dos PRs ainda abertos para detectar redundâncias e obsolescência. Deve rodar no full-sync depois do update-config.\n\n8.1. Resolved upstream\n\nVerificar se o upstream já resolveu o problema que nosso PR corrige, sem mergear nosso PR:\n\n# Para cada PR aberto, buscar os arquivos que ele toca\ngh pr view <number> --repo <repo> --json files --jq '[.files[].path]'\n\n# Verificar se upstream alterou esses mesmos arquivos recentemente\n# (commits no upstream/main que não estão no nosso PR branch)\ngit log --oneline upstream/main --since=\"<lastSync>\" -- <files>\n\n# Se houve mudanças upstream nos mesmos arquivos, verificar se o diff\n# do nosso PR ainda faz diferença (pode ter sido absorvido)\ngit diff upstream/main..origin/<branch> -- <files>\n\n\nSe o diff do PR estiver vazio (upstream absorveu as mudanças): marcar como resolved_upstream. Se o diff for parcial (upstream resolveu parte): marcar como partially_resolved para revisão.\n\n8.2. Duplicate externo\n\nVerificar se outra pessoa abriu um PR que resolve o mesmo problema:\n\n# Buscar PRs abertos no upstream que tocam os mesmos arquivos\ngh pr list --state open --repo <repo> --json number,title,headRefName,files --limit 50\n\n# Buscar PRs mergeados recentes que tocam os mesmos arquivos\ngh pr list --state merged --repo <repo> --json number,title,mergedAt,files --limit 30 \\\n  | jq '[.[] | select(.mergedAt >= \"<lastSync>\")]'\n\n\nPara cada PR encontrado que toca os mesmos arquivos, comparar:\n\nMesmo issue referenciado?\nMesma área de código?\nMesmo tipo de fix?\n\nSe houver match forte: marcar como duplicate_external ou superseded_external.\n\n8.3. Self-duplicate\n\nDetectar sobreposição entre nossos próprios PRs abertos:\n\n# Coletar files de todos os nossos PRs abertos\nfor pr in <openPRs>; do\n  gh pr view $pr --repo <repo> --json number,files --jq '{number, files: [.files[].path]}'\ndone\n\n# Cruzar: se dois PRs tocam os mesmos arquivos, são candidatos a duplicata\n\n\nPara cada par com overlap de arquivos:\n\nVerificar se o diff é similar ou complementar\nSe similar: recomendar fechar o mais antigo/menos limpo\nSe complementar: ok, apenas nota informativa\n8.4. Apresentar resultados\n### Audit de PRs Abertos\n\n#### Possivelmente resolvidos upstream\n| # | Titulo | Arquivos em comum | Status |\n|---|--------|-------------------|--------|\n| 123 | fix(foo): bar | foo.ts (changed upstream 3 days ago) | ⚠️ Verificar |\n\n#### Possíveis duplicatas externas\n| Nosso PR | PR externo | Overlap | Recomendação |\n|----------|-----------|---------|--------------|\n| #123 | #456 (@user) | foo.ts, bar.ts | ⚠️ Mesmo issue, verificar |\n\n#### Self-duplicates (nossos PRs que se sobrepõem)\n| PR A | PR B | Arquivos em comum | Recomendação |\n|------|------|-------------------|--------------|\n| #6471 | #8386 | skills/refresh.ts | 🗑️ Fechar #6471 (duplicata) |\n\n**Opções por PR flagged:**\n1. 🗑️ **Close** — fechar o PR no upstream e drop\n2. ✅ **Keep** — falso positivo, manter aberto\n3. 🔄 **Merge into** — combinar com outro PR\n4. ⏸️ **Defer** — revisitar depois\n\nComandos do Agente\nstatus - Verificar estado atual\nCarregar config\nFetch remotes\nContar commits atrás do upstream\nListar PRs e seus estados\nReportar ao usuário\nsync - Sincronizar main com upstream\ncd <localPath>\ngit fetch <upstreamRemote>\ngit checkout <mainBranch>\ngit merge <upstreamRemote>/<mainBranch>\ngit push <originRemote> <mainBranch>\n\nrebase <branch> - Rebase de uma branch específica\ngit checkout <branch>\ngit fetch <upstreamRemote>\ngit rebase <upstreamRemote>/<mainBranch>\n# Se conflito: resolver e git rebase --continue\ngit push <originRemote> <branch> --force-with-lease\n\nrebase-all - Rebase de todas as branches de PR\n\nPara cada branch em prBranches:\n\nCheckout da branch\nRebase no upstream/main\nPush com --force-with-lease\nReportar sucesso/falha\nresolve-conflicts - Resolução automática de conflitos via subagentes\n\nRequer --auto-resolve na invocação OU autoResolveConflicts: true no config do repo. Se nenhum dos dois, este comando não é executado e conflitos são apenas reportados com a nota \"⚠️ Conflitos requerem aval do desenvolvedor.\"\n\nApós rebase-all detectar conflitos, o orchestrator (agente principal) spawna subagentes individuais para tentar resolver cada conflito automaticamente.\n\nFluxo\nO worker do rebase-all retorna a lista de branches com conflito\nO orchestrator agrupa os conflitos e spawna até 5 subagentes simultâneos (model: Opus)\nConforme subagentes terminam, novos são lançados até esgotar a fila\nCada subagente tem timeout de 10 minutos\nResultados são coletados e integrados no relatório final\nPrompt do subagente resolver\n\nCada subagente recebe:\n\nResolve o conflito de rebase da branch <branch> (PR #<number>) no repo <localPath>.\n\n## Contexto\n- Upstream: <upstreamRemote>/<mainBranch>\n- Branch do PR: <originRemote>/<branch>\n- Arquivos em conflito: <lista de arquivos do erro de rebase>\n\n## Passos\n1. cd <localPath>\n2. git checkout -B <branch> <originRemote>/<branch> --no-track\n3. git rebase <upstreamRemote>/<mainBranch>\n   → O rebase vai parar com conflito\n4. Para cada arquivo em conflito:\n   a. Ler o arquivo com os marcadores de conflito (<<<<<<<, =======, >>>>>>>)\n   b. Entender o que o upstream mudou (OURS) vs o que o PR mudou (THEIRS)\n   c. Resolver preservando a intenção de ambos\n   d. git add <arquivo>\n5. git rebase --continue\n6. Se houver mais conflitos em commits subsequentes, repetir 4-5\n7. git push <originRemote> <branch> --force-with-lease\n\n## Regras de resolução\n- **Arquivo deletado no upstream + modificado pelo PR:** aceitar a deleção do upstream (nosso PR targeted código que não existe mais). git rm <arquivo> && git rebase --continue\n- **Import/formatting conflicts:** mesclar ambos, preservar imports de ambos os lados\n- **Lógica alterada em ambos os lados:** preservar a mudança do upstream E encaixar o fix do PR. Se o fix do PR não faz mais sentido com o novo código upstream, reportar como UNRESOLVABLE.\n- **NUNCA alterar a lógica do PR** — apenas adaptar ao novo contexto do upstream\n\n## Output\nResponda com EXATAMENTE um destes formatos:\n\nRESOLVED|<branch>|trivial|<resumo de 1 linha>\nRESOLVED|<branch>|semantic|<resumo de 1 linha>\nUNRESOLVABLE|<branch>|<motivo de 1 linha>\n\nClassificação do resultado\nResultado\tSignificado\tAção\nRESOLVED|trivial\tConflito mecânico resolvido (imports, formatting, deleted files)\t✅ Push feito, sem necessidade de revisão\nRESOLVED|semantic\tConflito envolvendo lógica de negócio resolvido\t⚠️ Push feito, marcar no report para revisão humana\nUNRESOLVABLE\tSubagente não conseguiu resolver sem risco\t❌ Não faz push, escala no report\nApós resolução\n\nPara branches resolvidas com sucesso:\n\nVerificar que o push foi feito (git log --oneline <originRemote>/<branch> -1)\nTentar rebase novamente para confirmar que está clean\nAtualizar notes.conflictBranches no config: remover entries resolvidas\n\nPara branches não resolvidas:\n\nManter em notes.conflictBranches com ciclo incrementado\nIncluir no relatório com o motivo do subagente\nIntegração com build-production\n\nApós resolve-conflicts, o build-production roda normalmente. Branches que foram resolvidas no rebase agora devem mergear clean na production. Se ainda houver conflito de production merge (diferente do conflito de rebase), o build-production trata como sempre: abort e reportar.\n\nupdate-config - Atualizar config com PRs atuais\n# Buscar PRs abertos\ngh pr list --state open --author @me --repo <repo> --json number,headRefName\n\n# Atualizar o arquivo $SKILL_DIR/repos/<repo-name>/config.json com os PRs atuais\n# Usar jq ou editar manualmente o JSON\n\nDetecção de PRs reabertos\n\nAo comparar a lista do GitHub (gh pr list --state open) com o config local, detectar três cenários:\n\nCenário\tCondição\tAção\nPR novo\tNo GitHub mas não em openPRs, localPatches, nem notes\tAdicionar a openPRs + prBranches normalmente\nPR reaberto (dropped)\tNo GitHub como open, encontrado em notes.closedWithoutMerge ou notes.droppedPatches\tRestaurar: mover de volta para openPRs + prBranches, remover da seção notes. Fetch da branch: git fetch <originRemote> <branch>. Logar no relatório como \"🔄 Reopened\"\nPR reaberto (local patch)\tNo GitHub como open, encontrado em localPatches (via campo originalPR)\tPromover: mover de localPatches para openPRs + prBranches. Logar no relatório como \"🔄 Reopened (was local patch)\"\n\nImplementação:\n\n# Para cada PR open no GitHub que NÃO está em openPRs:\n# 1. Checar se o número está em notes.closedWithoutMerge ou notes.droppedPatches\n#    → Se sim: PR foi reaberto. Restaurar automaticamente.\n# 2. Checar se algum entry em localPatches tem originalPR == número\n#    → Se sim: PR foi reaberto. Promover de volta a openPRs.\n# 3. Se não encontrado em lugar nenhum: PR genuinamente novo.\n\n# Restaurar branch se foi deletada:\ngit fetch <originRemote> <branch> 2>/dev/null || git fetch <originRemote> pull/<number>/head:<branch>\n\n\nNota: A restauração é automática (sem interação) porque o mantenedor reabrir um PR é sinal claro de que ele deve voltar ao tracking. O relatório sempre lista os PRs restaurados para visibilidade.\n\nbuild-production - Criar branch de produção com todos os PRs + local patches\ncd <localPath>\ngit fetch <upstreamRemote>\ngit fetch <originRemote>\n\n# ⚠️ SEMPRE preservar arquivos não-commitados antes de trocar de branch\nif [ -n \"$(git status --porcelain)\" ]; then\n  git stash push --include-untracked -m \"fork-manager: pre-build-production $(date -u +%Y%m%dT%H%M%S)\"\n  STASHED=1\nfi\n\n# Deletar branch antiga se existir\ngit branch -D <productionBranch> 2>/dev/null || true\n\n# Criar nova branch a partir do upstream\ngit checkout -b <productionBranch> <upstreamRemote>/<mainBranch>\n\n# 1. Mergear cada PR branch (contribuições upstream pendentes)\nfor branch in <prBranches>; do\n  git merge <originRemote>/$branch -m \"Merge PR #<number>: <title>\"\n  # Se conflito, resolver\ndone\n\n# 2. Mergear cada local patch (fixes mantidos localmente)\nfor branch in <localPatches>; do\n  git merge <originRemote>/$branch -m \"Merge local patch: <description>\"\n  # Se conflito, resolver\ndone\n\n# Push\ngit push <originRemote> <productionBranch> --force-with-lease\n\n# Restaurar arquivos não-commitados\nif [ \"$STASHED\" = \"1\" ]; then\n  git stash pop\nfi\n\n\nAfter rebuilding the production branch, remind the user to run their project's build command if needed.\n\nOrdem de merge: PRs abertos primeiro (ordem crescente por número), local patches depois. Isso garante que patches locais se aplicam sobre a base mais completa possível.\n\naudit-open - Auditar PRs abertos por redundância/obsolescência\n\nAnálise proativa de todos os PRs abertos (seção 8 acima):\n\nPara cada PR aberto, coletar arquivos tocados\nResolved upstream: verificar se upstream alterou os mesmos arquivos desde último sync; se diff do PR ficou vazio, flaggar\nDuplicate externo: buscar PRs upstream (open + recently merged) que tocam mesmos arquivos\nSelf-duplicate: cruzar arquivos entre nossos próprios PRs abertos\nApresentar findings ao usuário com opções: close / keep / merge-into / defer\nExecutar decisões\nAtualizar config\nreview-closed - Revisar PRs recém-fechados\n\nDetecta PRs que foram fechados/mergeados desde o último sync e guia o usuário na decisão:\n\nBuscar todos os PRs do config no GitHub\nIdentificar os que mudaram de estado (merged ou closed)\nPara merged: mover para notes.mergedUpstream, deletar branches\nPara closed sem merge: iniciar fluxo de revisão interativo (seção 7 acima)\nPara cada closed, apresentar contexto e opções ao usuário\nExecutar decisão: drop / keep as local patch / resubmit / defer\nAtualizar config\nreview-patches - Reavaliar patches locais existentes\n\nPara cada entry em localPatches cuja reviewDate já passou:\n\nVerificar se upstream resolveu o problema desde a última revisão\nVerificar se o patch ainda aplica limpo (sem conflitos)\nApresentar ao usuário com opções: manter / drop / resubmit / estender reviewDate\nAtualizar config\nfull-sync - Sincronização completa\nStash - git stash --include-untracked se houver arquivos não-commitados\nsync - Atualizar main\nBefore sync: record OLD_SHA=$(git rev-parse upstream/main)\nAfter sync: record NEW_SHA=$(git rev-parse upstream/main)\npost-sync hooks (optional, repo-specific) - Run custom post-sync actions\nSkip if OLD_SHA == NEW_SHA (no upstream changes)\nHooks are defined per-repo in config.json under \"postSyncHooks\" (array of shell commands or descriptions)\nExample: detect CHANGELOG changes, update downstream skills, trigger CI\nIf no hooks configured: skip this step entirely\nupdate-config - Atualizar lista de PRs\nreview-closed - Revisar PRs recém-fechados/mergeados (interativo)\naudit-open - Auditar PRs abertos por redundância/obsolescência (interativo)\nreview-patches - Reavaliar local patches com reviewDate vencida (interativo)\nrebase-all - Rebase de todas as branches (PRs + local patches)\nresolve-conflicts (only if --auto-resolve flag OR autoResolveConflicts: true in config) - Resolver conflitos de rebase automaticamente via subagentes (Opus, até 5 paralelos, 10min timeout cada). Se nenhum dos dois, pular este passo.\nbuild-production - Recriar branch de produção (PRs + local patches)\nPop stash - git stash pop para restaurar arquivos locais\nRemind user to run their project's build command if needed\n\nNota sobre ordem: update-config roda antes de review-closed porque é ali que PRs reabertos são detectados e restaurados automaticamente. Depois, review-closed processa PRs que foram genuinamente fechados. Por fim, audit-open roda por último, já com a lista de PRs abertos atualizada (incluindo os reabertos).\n\nRelatório para o Usuário\n\nApós qualquer operação, gerar relatório:\n\n## 🍴 Fork Status: <repo>\n\n### Upstream Sync\n\n- **Main branch:** X commits behind upstream\n- **Last sync:** <date>\n\n### Open PRs (Y total)\n\n| #   | Branch        | Status           | Action Needed     |\n| --- | ------------- | ---------------- | ----------------- |\n| 123 | fix/issue-123 | ✅ Up to date    | None              |\n| 456 | feat/feature  | ⚠️ Needs rebase  | Run rebase        |\n| 789 | fix/bug       | ❌ Has conflicts | Manual resolution |\n\n#### 🔧 Resolução Automática de Conflitos\n\n_Seção presente apenas quando resolução automática está ativa (`--auto-resolve` ou `autoResolveConflicts: true`). Caso contrário, substituir por:_\n> ⚠️ **Conflitos requerem aval do desenvolvedor.** Resolução automática não ativada. Use `--auto-resolve` para tentar resolver automaticamente.\n\n_Quando ativa: Conflitos semânticos (⚠️) foram resolvidos automaticamente mas **requerem revisão humana** — o subagente pode ter interpretado mal a intenção do código._\n\n| #   | Branch        | Tipo      | Resultado          | Detalhe                          |\n| --- | ------------- | --------- | ------------------ | -------------------------------- |\n| 123 | fix/issue-123 | trivial   | ✅ Resolvido        | Removed deleted test file        |\n| 456 | fix/issue-456 | semântico | ⚠️ Resolvido (revisar) | Adapted runner call to new API   |\n| 789 | fix/issue-789 | —         | ❌ Não resolvido    | Lógica incompatível com upstream |\n\n#### 🔴 Conflitos persistentes (3+ ciclos)\n\n_Seção presente apenas quando há conflitos que persistem por 3 ou mais execuções consecutivas da skill, mesmo após tentativa de resolução automática. Esses PRs merecem atenção prioritária: considerar dropar, recriar sobre o main atual, ou resolver manualmente._\n\n| #   | Branch        | Ciclos | Arquivo(s)        | Recomendação        |\n| --- | ------------- | ------ | ----------------- | ------------------- |\n| 789 | fix/bug       | 5      | agent-runner.ts   | 🗑️ Dropar ou recriar |\n\n### Local Patches (Z total)\n\n| Branch             | Original PR | Motivo          | Review em  |\n| ------------------ | ----------- | --------------- | ---------- |\n| local/my-fix       | #321        | rejected_need   | 2026-03-07 |\n| local/custom-tweak | —           | wontfix         | 2026-04-01 |\n\n### Audit de PRs Abertos\n\n| #   | Título           | Flag                | Detalhe                          |\n| --- | ---------------- | ------------------- | -------------------------------- |\n| 123 | fix(foo): bar    | ⚠️ resolved_upstream | upstream changed foo.ts 3d ago   |\n| 456 | fix(baz): qux    | ⚠️ duplicate_external | similar to #789 by @user         |\n| 111 | fix(a): b        | ⚠️ self_duplicate    | overlaps with our #222           |\n\n### PRs Reabertos (restaurados automaticamente)\n\n| #   | Título           | Origem              | Ação                    |\n| --- | ---------------- | ------------------- | ----------------------- |\n| 777 | fix(foo): bar    | notes.droppedPatches | 🔄 Restored to openPRs |\n| 888 | feat(baz): qux   | localPatches         | 🔄 Promoted to openPRs |\n\n_Seção presente apenas quando há PRs reabertos no ciclo atual._\n\n### PRs Recém-Fechados (aguardando decisão)\n\n| #   | Título           | Fechado em | Motivo              | Recomendação     |\n| --- | ---------------- | ---------- | ------------------- | ---------------- |\n| 999 | fix(foo): bar    | 2026-02-05 | resolved_upstream   | 🗑️ Drop          |\n| 888 | feat(baz): qux   | 2026-02-06 | rejected_need       | 📌 Local patch   |\n\n### Production Branch\n\n- **Branch:** main-with-all-prs\n- **Contains:** PRs #123, #456 + Local patches: local/my-fix, local/custom-tweak\n- **Status:** ✅ Up to date / ⚠️ Needs rebuild\n\n### Recommended Actions\n\n1. ...\n2. ...\n\nNotas Importantes\nSempre usar --force-with-lease em vez de --force para push\nSempre fazer backup antes de operações destrutivas\nUse the project's package manager for build commands (bun/npm/yarn/pnpm)\nManter o config atualizado após cada operação\nResolução automática de conflitos (requer --auto-resolve ou autoResolveConflicts: true): Quando ativa, após rebase-all a skill spawna subagentes (Opus, até 5 paralelos, 10min timeout cada) para tentar resolver conflitos. Conflitos triviais (imports, formatting, arquivos deletados) são resolvidos e pushed sem necessidade de revisão. Conflitos semânticos (lógica de negócio) são resolvidos e pushed mas marcados no relatório como ⚠️ para revisão humana. Se o subagente não conseguir resolver, marca como ❌ e não faz push. Quando desativada, conflitos são apenas reportados.\nConflitos persistentes (3+ ciclos): Quando um conflito persiste por 3+ execuções consecutivas (tracked pelo sufixo \"Nth cycle\" em notes.conflictBranches), escalar no relatório com seção dedicada \"🔴 Conflitos persistentes\" e recomendar ação: dropar o PR, recriar a branch, ou resolver manualmente. O ciclo é incrementado a cada execução onde o conflito reaparece, mesmo que a resolução automática tenha sido tentada e falhado.\nLocal patches são cidadãos de primeira classe: rebase, build e relatório incluem tanto PRs abertos quanto local patches\nNunca remover automaticamente um PR fechado sem merge. Sempre passar pelo fluxo review-closed para decisão do usuário\nReview dates em local patches: ao criar um local patch, definir uma data de revisão (default: 30 dias). No full-sync, patches com review vencida são apresentados ao usuário para reavaliação\nNaming convention para local patches: prefixo local/ para distinguir de branches de PR (ex: local/my-custom-fix). A branch original pode ser renomeada ou mantida — o importante é que o config rastreie a branch correta\n⚠️ Proteger arquivos não-commitados antes de operações destrutivas\n\nAntes de qualquer operação que troca de branch ou deleta/recria branches (especialmente build-production e full-sync), sempre verificar e preservar arquivos unstaged, untracked e staged:\n\ncd <localPath>\n\n# 1. Checar se há arquivos em risco\ngit status --porcelain\n\n# 2. Se houver arquivos modificados/untracked, fazer stash com untracked\ngit stash push --include-untracked -m \"fork-manager: pre-sync stash $(date -u +%Y%m%dT%H%M%S)\"\n\n# 3. Executar a operação (rebase, checkout, merge, etc.)\n# ...\n\n# 4. Após concluir, restaurar o stash\ngit stash pop\n\n\nPor quê? Ao deletar e recriar a branch de produção (git branch -D <productionBranch>), arquivos que existiam apenas no working directory (não commitados) são perdidos permanentemente. Isso inclui:\n\nArquivos gerados (dashboards, history, state)\nArquivos de configuração local (serve.ts, .env)\nDados acumulados (JSON, SQLite)\n\nRegra: Se git status --porcelain retornar qualquer saída, fazer git stash --include-untracked antes de prosseguir. Restaurar com git stash pop ao final.\n\nSecurity Notice\n\nThis skill performs operations that require broad filesystem and network access by design:\n\nGit operations: fetch, checkout, merge, rebase, push across multiple remotes and branches\nGitHub CLI: reads PR status, creates PRs, queries repo metadata Before using this skill on a repository:\nAll git push operations use --force-with-lease (not --force) to prevent data loss\nThe skill always stashes uncommitted files before destructive branch operations\n\nThese capabilities are inherent to fork management and cannot be removed without breaking core functionality.\n\nUsage Examples\nBasic sync\n\nUser: \"sync my fork of project-x\"\n\nAgent:\n\nLoad config from $SKILL_DIR/repos/project-x/config.json\nRun status to assess current state\nIf main is behind, run sync\nIf PRs need rebase, run rebase-all\nUpdate productionBranch if needed\nRemind user to rebuild if needed\nReport results to user\nSync with auto-resolve\n\nUser: \"/fork-manager --auto-resolve\" or \"/fork-manager full-sync --auto-resolve\"\n\nAgent:\n\nSame as basic sync, but after rebase-all:\nFor each conflict, spawn a resolver subagent (Opus)\nCollect results (trivial ✅ / semantic ⚠️ / unresolvable ❌)\nRe-run build-production with resolved branches\nReport includes resolution table with review flags"
  },
  "trust": {
    "sourceLabel": "tencent",
    "provenanceUrl": "https://clawhub.ai/Glucksberg/fork-manager",
    "publisherUrl": "https://clawhub.ai/Glucksberg/fork-manager",
    "owner": "Glucksberg",
    "version": "2.0.1",
    "license": null,
    "verificationStatus": "Indexed source record"
  },
  "links": {
    "detailUrl": "https://openagent3.xyz/skills/fork-manager",
    "downloadUrl": "https://openagent3.xyz/downloads/fork-manager",
    "agentUrl": "https://openagent3.xyz/skills/fork-manager/agent",
    "manifestUrl": "https://openagent3.xyz/skills/fork-manager/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/fork-manager/agent.md"
  }
}