Git Data API を通じて GitHub のプルリクエストを作成・一覧表示し、コミット状態を確認して単一ファイルをプッシュする、依存関係ゼロの Python CLI です。
インストール＆ダウンロード
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 から読み取ります。トークンは保存も表示もされません。書き込み操作は --dry-run で事前確認できます。リモートを変更する前に、対象リポジトリ、ブランチ、メッセージを確認してください。これは特定用途向けの統合機能であり、汎用 GitHub クライアントではありません。
GitHub ワークフロー統合 のユースケース
ghCLI をインストールせずに、スクリプトからプルリクエストを作成する。- オープン中のプルリクエストを一覧表示し、番号、タイトル、ブランチ、URL を返す。
- コミットまたは ref の統合状態を確認して CI の結果を調べる。
- Git Data API を使い、CI ジョブまたは制限された環境からローカルファイル 1 つをリモートブランチにプッシュする。
- リポジトリの状態を変更する前に、
--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は使用方法の誤りまたはトークン未設定を示します。401 はトークンの期限切れまたは権限スコープ不足、404 はリポジトリまたはブランチの誤りを示す場合があります。
GitHub ワークフロー統合 のセットアップ
要件
- Python 3.8 以降。
- サードパーティ製 Python パッケージ、Git、GitHub CLI のインストールは不要です。
- 対象操作に必要な
repoスコープを持つ GitHub Personal Access Token (PAT)。この skill は OAuth ではなく PAT 認証を使用します。
認証の設定
GitHub の Settings → Developer settings → Personal access tokens で PAT を作成し、GITHUB_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 です。ローカルデータベース、生成されるメタデータファイル、トークン保存領域は定義しません。入力はコマンドライン引数で、結果は人が読める形式で出力されます。
| 要素 | 詳細 |
|---|---|
| エントリーポイント | 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 使用方法の誤りまたはトークン未設定 |
push-file では、Git Data API ワークフローが blob を作成し、tree を構築し、commit を作成して ref を更新します。トークンがディスクに書き込まれたり、ログに記録されたり、表示されたりすることはありません。
GitHub ワークフロー統合 の高度な機能
- 依存関係不要の API アクセス：Python 標準ライブラリのネットワーク機能を使用し、サードパーティ製パッケージやサブプロセスを必要としません。
- Git Data API による単一ファイルのプッシュ：blob → tree → commit → ref の手順でリモートブランチにファイルを書き込みます。通常の Git プッシュが使えない場合に便利です。
- ドライランのプレビュー：対応する書き込み操作を送信する前に、リクエスト形式を確認できます。
- 明確な認証境界：ユーザーが作成した PAT を
GITHUB_TOKENに設定する必要があります。OAuth を開始したり、ブラウザーを開いたりしません。 - 実用的なエラー処理：API/ネットワークエラーと、使用方法の誤りやトークン未設定のエラーを区別し、スクリプト向けの終了コードを提供します。
- 用途を限定した機能範囲：PR の作成と一覧表示、統合コミット状態、単一ファイルのプッシュに対応します。マージ、レビューコメント、リリース、ワークフローのディスパッチ、GitHub App のインストールには対応しません。
- Openclaw Skills との適合性：依存関係を抑え、認証情報を永続ストレージに残さないことが重要なスクリプトや CI タスク向けに、コンパクトな GitHub ワークフロー構成要素を提供します。
SKILL.md
ローディング
関連するOpenclawのスキル
llms-generator
AIエージェントがプロジェクトを発見して理解できるよう、LLMs.txt v2形式のプロジェクトガイドを生成します。
ISO 14971 リスクマトリクス
医療機器のリスクをスコアリングし、ISO 14971:2019 の管理オプションを確認し、リスクマネジメントファイルの完全性をチェックする Python CLI ヘルパーです。
Base Gas
Base Gas provides live and historical network fee data to estimate transaction costs, compare chains, and decide when to transact.
The Yard
The Yardスキルを使うと、OpenClawボットがStackyardのボット専用掲示板に参加し、HTTPSで閲覧、投稿、返信、投票できます。
Skill スケルトン生成ツール
1つのPythonコマンドで、SKILL.md、AGENTS.md、対象ディレクトリを含む、構造化されたLGD準拠のAI skillスターターを生成します。
豆包ヒューマンシグナル
豆包ヒューマンシグナルは、文章によく見られるAIスタイルのパターンをチェックし、人間らしさを重視した修正の参考となる0～100のスコアを返します。
UDI Validator
規制データベースに提出する前に構造上の問題を検出できるよう、医療機器のUDI文字列をローカルで検証および解析します。
特徴*
