Sponsored by APIMart - AI API，99.9% SLA。讓你的 AI 隨時在線。多數模型可省下 20–60% 費用；nanobanana pro API 每次僅需 0.03。

AI 廣告資料庫

Openclaw Skills

GitHub 工作流程整合

適用於 Openclaw 的 GitHub 工作流程整合

零相依 Python CLI，可透過 Git Data API 建立及列出 GitHub 提取要求、檢查提交狀態，以及推送單一檔案。

zhaoxinghua09-cell

v1.0.0

Oct 17, 2026

安裝

基本資訊

Skill.md

安裝與下載

1. ClawHub CLI

從來源直接安裝技能的最快方式。


                  npx clawhub@latest install github-workflow-integration

2. 手動安裝

將技能資料夾複製到以下位置之一

全域模式

~/.openclaw/skills/

工作區

<project>/skills/

優先級：工作區 > 本地 > 內建

3. 提示詞安裝

將此提示詞複製到 OpenClaw 即可自動安裝。


                  請幫我使用 Clawhub 安裝 github-workflow-integration。如果尚未安裝 Clawhub，請先安裝（npm i -g clawhub）。

想要直接下載？

取得包含原生技能檔案的ZIP壓縮檔。

什麼是 GitHub 工作流程整合？

GitHub 工作流程整合是輕量級命令列包裝程式，用於執行選定的 GitHub REST API 操作，以 Python 3.8+ 建置且僅使用標準程式庫。它可建立及列出提取要求、查詢綜合提交狀態，並透過 Git Data API 順序推送單一檔案：blob → tree → commit → ref。Openclaw Skills 使用者無須安裝 Git、GitHub CLI 或第三方 Python 套件，即可自動化這些工作流程。

驗證會使用使用者提供的 Personal Access Token，並在命令執行時從 GITHUB_TOKEN 讀取。Token 不會儲存或列印。寫入操作可透過 --dry-run 預覽；進行遠端變更前，使用者應確認目標儲存庫、分支及訊息。這是專用整合工具，並非通用 GitHub 用戶端。

GitHub 工作流程整合應用場景

無須安裝 gh CLI，即可透過指令碼建立提取要求。
列出尚未關閉的提取要求，並傳回其編號、標題、分支及 URL。
檢查提交或 ref 的綜合狀態，以檢視 CI 結果。
在 CI 工作或受限環境中，使用 Git Data API 將一個本機檔案推送至遠端分支。
變更儲存庫狀態前，使用 --dry-run 預覽寫入要求。
在沒有第三方相依套件的 Python 環境中使用 GitHub REST API 操作。

GitHub 工作流程整合運作原理

檢查是否已設定 GITHUB_TOKEN。如果缺少此變數，CLI 會以代碼 2 結束並提供設定指引，而不會嘗試傳送未經驗證的要求。
使用目標 owner\/repo 及必要選項呼叫相關命令：pr create、pr list、status 或 push-file。
對於寫入操作，先使用 --dry-run 執行，並在傳送實際要求前確認儲存庫、分支及訊息。
Python CLI 會向 GitHub REST API 傳送要求。推送單一檔案時，它會建立 blob、tree 和 commit，然後更新目標 ref。
檢視結果：成功呼叫會傳回人類可讀的詳細資料，例如 PR 編號或 URL、狀態或 commit SHA。API 錯誤和網路錯誤會分別回報。
依退出代碼處理結果：0 表示成功，1 表示 API 或網路錯誤，2 表示使用方式錯誤或缺少 Token。401 可能表示 Token 已過期或權限範圍不足；404 可能表示儲存庫或分支錯誤。

GitHub 工作流程整合設定指南

需求

Python 3.8 或更新版本。
無須安裝第三方 Python 套件、Git 或 GitHub CLI。
具有目標操作所需 repo 範圍的 GitHub Personal Access Token (PAT)。此 skill 使用 PAT 驗證，而非 OAuth。

設定驗證

在 GitHub 的 Settings → Developer settings → Personal access tokens 中建立 PAT，然後透過 GITHUB_TOKEN 環境變數提供。請勿提交 Token 或將其放入命令輸出。

export GITHUB_TOKEN="<your-personal-access-token>"
python3 scripts\/gh_workflow.py pr list --repo owner\/repo

執行命令

使用此 skill 的 scripts\/gh_workflow.py 進入點。對於寫入操作，請先預覽，並在不使用 --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

GitHub 工作流程整合資料結構與分類體系

此 skill 是無狀態 CLI：不會定義本機資料庫、產生的中繼資料檔案或 Token 儲存空間。輸入為命令列引數，結果以人類可讀的輸出寫入。

元素	詳細資料
進入點	`scripts\/gh_workflow.py`
執行環境	Python 3.8+；僅使用標準程式庫
驗證	`GITHUB_TOKEN` 環境變數，於呼叫時讀取
儲存庫識別碼	`owner\/repo`
命令	`pr create`、`pr list`、`status`、`push-file`
試執行	`--dry-run` 預覽要求格式而不傳送要求
輸出	PR 詳細資料、狀態、commit SHA 或錯誤資訊
退出代碼	`0` 成功；`1` API/網路錯誤；`2` 使用方式錯誤或缺少 Token

對於 push-file，Git Data API 工作流程會建立 blob、建置 tree、建立 commit，並更新 ref。Token 不會寫入磁碟、記錄至日誌或回顯。

GitHub 工作流程整合進階特性

零相依 API 存取：使用 Python 標準程式庫的網路功能，不需要第三方套件或子程序。
Git Data API 單一檔案推送：透過 blob → tree → commit → ref 順序，將檔案寫入遠端分支；無法使用一般 Git 推送時特別實用。
試執行預覽：傳送支援的寫入操作前，檢視要求格式。
明確的驗證界線：要求使用者建立 PAT 並放入 GITHUB_TOKEN；不會啟動 OAuth 或開啟瀏覽器。
明確易用的錯誤處理：區分 API/網路錯誤、使用方式錯誤及缺少 Token 錯誤，並提供適合指令碼使用的退出代碼。
專注的功能範圍：涵蓋 PR 建立與列出、綜合提交狀態及單一檔案推送。不處理合併、審查留言、發行版本、工作流程派送或 GitHub App 安裝。
適用於 Openclaw Skills：為指令碼及 CI 工作提供精簡的 GitHub 工作流程元件，適合需要盡量減少相依套件並避免憑證持續儲存的情境。