Um CLI Python sem dependências para criar e listar pull requests do GitHub, verificar o status de commits e enviar um único arquivo pela Git Data API.
Instalar e Baixar
1. ClawHub CLI
A maneira mais rápida de instalar uma habilidade diretamente do registro.
npx clawhub@latest install github-workflow-integration
2. Instalação Manual
Copie a pasta da habilidade para um desses locais
~/.openclaw/skills/ <project>/skills/ Prioridade: Espaço de Trabalho > Local > Integrado
3. Instalação do Prompt
Copie este prompt para o OpenClaw para instalá-lo automaticamente.
Ajude-me a instalar o github-workflow-integration usando o Clawhub. Se o Clawhub não estiver instalado, instale-o primeiro (npm i -g clawhub).
Prefere baixar?
Obtenha os arquivos originais da habilidade em um arquivo ZIP.
O que é Integração de fluxo de trabalho do GitHub?
A integração de fluxo de trabalho do GitHub é um wrapper leve de linha de comando para operações selecionadas da GitHub REST API, criado para Python 3.8+ e usando apenas a biblioteca padrão. Ele pode criar e listar pull requests, consultar o status combinado de commits e enviar um único arquivo usando a sequência da Git Data API: blob → tree → commit → ref. Usuários do Openclaw Skills podem automatizar esses fluxos sem instalar Git, GitHub CLI ou pacotes Python de terceiros.
A autenticação usa um Personal Access Token fornecido pelo usuário e lido de GITHUB_TOKEN quando o comando é executado. O token não é salvo nem exibido. As operações de escrita podem ser pré-visualizadas com --dry-run; os usuários devem confirmar o repositório, a ramificação e a mensagem de destino antes de fazer alterações remotas. Esta é uma integração especializada, não um cliente GitHub de uso geral.
Casos de uso do Integração de fluxo de trabalho do GitHub
- Criar um pull request a partir de um script sem instalar o CLI
gh. - Listar pull requests abertos e retornar seus números, títulos, ramificações e URLs.
- Verificar o status combinado de um commit ou ref para inspecionar os resultados do CI.
- Enviar um arquivo local para uma ramificação remota a partir de um trabalho de CI ou ambiente restrito, usando a Git Data API.
- Pré-visualizar uma solicitação de escrita com
--dry-runantes de alterar o estado do repositório. - Usar operações da GitHub REST API em um ambiente Python sem dependências de terceiros.
Como o Integração de fluxo de trabalho do GitHub funciona
- Verifique se
GITHUB_TOKENestá definido. Se estiver ausente, o CLI termina com o código 2 e fornece instruções de configuração, em vez de tentar uma solicitação sem autenticação. - Invoque o comando relevante com o
owner\/repode destino e as opções necessárias:pr create,pr list,statusoupush-file. - Para operações de escrita, execute primeiro com
--dry-rune confirme o repositório, a ramificação e a mensagem antes de enviar a solicitação real. - O CLI Python envia a solicitação à GitHub REST API. Para enviar um único arquivo, cria um blob, uma tree e um commit e, em seguida, atualiza o ref de destino.
- Analise o resultado: chamadas bem-sucedidas retornam detalhes legíveis, como número ou URL do PR, estado do status ou SHA do commit. Erros da API e da rede são informados separadamente.
- Trate os códigos de saída:
0indica sucesso,1indica erro de API ou de rede e2indica erro de uso ou token ausente. Um 401 pode indicar token expirado ou escopo insuficiente; um 404 pode indicar repositório ou ramificação incorretos.
Configuração do Integração de fluxo de trabalho do GitHub
Requisitos
- Python 3.8 ou posterior.
- Não é necessário instalar pacotes Python de terceiros, Git ou GitHub CLI.
- Um GitHub Personal Access Token (PAT) com o escopo
reponecessário para as operações de destino. Este skill usa autenticação PAT, não OAuth.
Configurar a autenticação
Crie um PAT no GitHub em Settings → Developer settings → Personal access tokens e forneça-o pela variável de ambiente GITHUB_TOKEN. Não faça commit do token nem o inclua na saída de comandos.
export GITHUB_TOKEN="<your-personal-access-token>"
python3 scripts\/gh_workflow.py pr list --repo owner\/repo
Executar comandos
Use o ponto de entrada scripts\/gh_workflow.py do skill. Para operações de escrita, faça primeiro uma pré-visualização e verifique o destino solicitado antes de executar sem --dry-run.
python3 scripts\/gh_workflow.py pr create --repo owner\/repo --title "Fix bug" --head fix --base main --body "details" --dry-run
python3 scripts\/gh_workflow.py status --repo owner\/repo --ref main
python3 scripts\/gh_workflow.py push-file --repo owner\/repo --path .\/local.txt --message "add local.txt" --branch main
Esquema de Dados e Taxonomia de Integração de fluxo de trabalho do GitHub
O skill é um CLI sem estado: não define banco de dados local, arquivos de metadados gerados nem armazenamento de tokens. As entradas são argumentos de linha de comando, e os resultados são gravados em formato legível por pessoas.
| Elemento | Detalhes |
|---|---|
| Ponto de entrada | scripts\/gh_workflow.py |
| Ambiente de execução | Python 3.8+; somente biblioteca padrão |
| Autenticação | Variável de ambiente GITHUB_TOKEN, lida no momento da chamada |
| Identificador do repositório | owner\/repo |
| Comandos | pr create, pr list, status, push-file |
| Execução simulada | --dry-run pré-visualiza o formato da solicitação sem enviá-la |
| Saída | Detalhes do PR, estado do status, SHA do commit ou informações de erro |
| Códigos de saída | 0 sucesso; 1 erro de API/rede; 2 erro de uso ou token ausente |
Para push-file, o fluxo da Git Data API cria um blob, monta uma tree, cria um commit e atualiza um ref. O token não é gravado em disco, registrado em logs nem exibido.
Recursos avançados do Integração de fluxo de trabalho do GitHub
- Acesso à API sem dependências: usa o suporte de rede da biblioteca padrão do Python, sem pacotes de terceiros nem subprocessos.
- Envio de arquivo único pela Git Data API: grava um arquivo em uma ramificação remota pela sequência blob → tree → commit → ref, útil quando um push normal do Git não está disponível.
- Pré-visualizações com execução simulada: inspecione o formato da solicitação antes de enviar operações de escrita compatíveis.
- Limite de autenticação explícito: exige um PAT criado pelo usuário em
GITHUB_TOKEN; não inicia OAuth nem abre um navegador. - Tratamento de erros prático: diferencia erros de API/rede de erros de uso e de token ausente, com códigos de saída para scripts.
- Escopo focado: abrange criação e listagem de PRs, status combinado de commits e envios de arquivo único. Não trata de merges, comentários de revisão, releases, despacho de workflows nem instalação do GitHub App.
- Adequado ao Openclaw Skills: oferece um componente compacto de fluxo de trabalho do GitHub para scripts e tarefas de CI em que é importante minimizar dependências e manter credenciais fora do armazenamento persistente.
SKILL.md
Carregamento
Habilidades relacionadas do Openclaw
llms-generator
Gere um guia de projeto estruturado conforme LLMs.txt v2 para ajudar agentes de IA a descobrir e entender seu projeto.
Orçamento de tokens de contexto
Estime o uso do contexto de IA e aplique um orçamento de tokens com falha segura antes que um prompt exceda o limite.
Matriz de Risco ISO 14971
Um auxiliar CLI em Python para pontuar riscos de dispositivos médicos, revisar opções de controle da ISO 14971:2019 e verificar a completude do arquivo de gerenciamento de riscos.
Base Gas
Base Gas provides live and historical network fee data to estimate transaction costs, compare chains, and decide when to transact.
The Yard
A skill The Yard permite que um bot OpenClaw participe do quadro de mensagens exclusivo para bots do Stackyard para ler, publicar, responder e votar usando HTTPS.
Gerador de estrutura de Skill
Gere um ponto de partida estruturado para AI skill, alinhado ao LGD, com SKILL.md, AGENTS.md e diretórios de destino usando um único comando Python.
Apresentou*
