Openclaw向けGitLab スキル

単一の Python コマンドラインツールから GitLab プロジェクト、Issue、マージリクエスト、CI/CD パイプラインを管理します。

weiguang1017
v0.1.1
Oct 8, 2026
0
2.7k
0

インストール&ダウンロード

1. ClawHub CLI

レジストリから直接スキルをインストールする最速の方法です。

npx clawhub@latest install gitlab-devops-skill

2. 手動インストール

スキルフォルダを以下のいずれかの場所にコピーしてください

グローバル
~/.openclaw/skills/
ワークスペース
<project>/skills/

優先順位:ワークスペース > ローカル > バンドル

3. プロンプトのインストール

このプロンプトをOpenClawにコピーするだけで、自動的にインストールされます。

Clawhubを使って gitlab-devops-skill をインストールして。Clawhubがインストールされていない場合は、先にインストールしてください(npm i -g clawhub)。

ダウンロードをご希望ですか?

ZIPアーカイブで生のスキルファイルを取得します。

GitLab スキル とは?

GitLab Skills を使うと、AI コーディングエージェントは GitLab REST API v4 と同梱の scripts/gitlab_cli.py コマンドラインインターフェースを通じて GitLab を操作できます。プロジェクトの検索と確認、Issue やマージリクエストの一覧表示または作成、条件を満たす MR のマージ、GitLab.com または互換性のあるセルフホストインスタンスでの CI/CD パイプラインの確認や実行に利用できます。

開発者向けワークフローを支援する Openclaw Skills の一つとして、信頼性の高い自動化とスクリプト作成のため、コマンド結果を JSON で返します。認証情報は環境変数または任意のローカル設定ファイルから読み込まれます。書き込み操作を実行する前に、対象プロジェクトとブランチをユーザーが確認する必要があります。

GitLab スキル のユースケース

  • 検索語でプロジェクトを探すか、数値 ID または group/subgroup/project パスを使ってプロジェクトを確認します。
  • オープン中の Issue を確認するか、バグやタスクを追跡する Issue を作成します。
  • マージリクエストを一覧表示する、ソースブランチからターゲットブランチへの MR を作成する、または準備が整った MR をマージします。
  • ブランチまたは ref のパイプライン状況を確認し、パイプラインが正常に完了したか判断します。
  • プロジェクトに .gitlab-ci.yml ファイルがある場合、指定した ref でパイプラインを実行します。
  • AI エージェント、ターミナルのワークフロー、またはスクリプトから GitLab.com やセルフホスト GitLab のタスクを自動化します。

GitLab スキル の仕組み

  1. GITLAB_URL と GITLAB_TOKEN 環境変数、または ~/.devops-skills/gitlab.json から GitLab インスタンスの URL と API トークンを読み込みます。
  2. 対応するコマンドとプロジェクト識別子を指定して scripts/gitlab_cli.py を実行します。数値のプロジェクト ID または group/subgroup/project のようなパスを使用します。
  3. コマンドを実行する前に /api/v4/version で GitLab のバージョンを確認します。バージョン確認を明示的にスキップしない限り、GitLab 9.0 未満のインスタンスは拒否されます。
  4. 要求された操作を GitLab REST API v4 に送信します。読み取り操作ではプロジェクト、Issue、MR、またはパイプライン情報を取得し、書き込み操作では Issue や MR の作成、MR のマージ、またはパイプラインの実行を行います。
  5. 結果を stdout に JSON で返します。失敗した場合はゼロ以外のステータスで終了します。マージおよびパイプライン操作には、GitLab のプロジェクト、ブランチ、MR、CI 設定に関する要件が適用されます。

GitLab スキル のセットアップ

  1. ユーザー設定 → アクセストークンで GitLab アクセストークンを作成し、api スコープを付与します。
  2. GitLab URL とトークンを環境変数に設定するか、~/.devops-skills/gitlab.json の任意の設定ファイルを使用します。トークンをコマンドライン引数に直接指定しないでください。
  3. requests 依存パッケージをインストールした Python 環境を使用します。スキルのドキュメントでは、利用可能な場合は指定された絶対 Python パスで CLI を呼び出すことを推奨しています。
  4. プロジェクト ID またはパスを指定して CLI コマンドを実行します。書き込み操作の前に、対象プロジェクトとブランチをユーザーに確認してください。
export GITLAB_URL="https://gitlab.com"  # セルフホスト GitLab の場合はそのインスタンス URL を使用
export GITLAB_TOKEN="<access-token>"    # api スコープが必要

PY="$HOME/.workbuddy/binaries/python/envs/default/bin/python"

# requests がない場合は、同じ Python 環境にインストールします:
"$PY" -m pip install requests

"$PY" scripts/gitlab_cli.py list-projects --search app
"$PY" scripts/gitlab_cli.py get-project group/app
"$PY" scripts/gitlab_cli.py list-issues group/app --state opened
"$PY" scripts/gitlab_cli.py create-issue group/app --title "Bug" --description "..."
"$PY" scripts/gitlab_cli.py list-mrs group/app --state opened
"$PY" scripts/gitlab_cli.py create-mr group/app --source feat --target main --title "Add feature"
"$PY" scripts/gitlab_cli.py merge-mr group/app 42
"$PY" scripts/gitlab_cli.py list-pipelines group/app --ref main
"$PY" scripts/gitlab_cli.py trigger-pipeline group/app --ref main

この CLI は REST API v4 を使用し、GitLab.com と GitLab 9.0 以降のセルフホストインスタンスに対応しています。詳細な設定、フィールド、トラブルシューティングについては references/USAGE.md を参照してください。

GitLab スキル のデータスキーマとタクソノミー

このスキルは GitLab API リソースを使用し、ローカルデータベースや生成されたプロジェクトファイルについては記載していません。CLI の応答は JSON として stdout に出力され、失敗はゼロ以外の終了コードで示されます。

リソースまたはファイル 用途
scripts/gitlab_cli.py プロジェクト、Issue、MR、パイプライン操作用の同梱 Python CLI。
~/.devops-skills/gitlab.json GitLab 接続設定用の任意のローカル設定ファイル。
references/USAGE.md 詳細な設定、フィールド、トラブルシューティングのドキュメント。
GitLab プロジェクト 数値 ID または URL エンコードされた group/subgroup/project パスで対象を識別します。
Issue プロジェクトごとに一覧表示または作成でき、作成時にはタイトルと説明を指定します。
マージリクエスト 一覧表示、ソースブランチとターゲットブランチからの作成、または条件を満たす場合の MR 番号によるマージが可能です。
パイプライン プロジェクトと ref ごとに一覧表示できます。プロジェクトに .gitlab-ci.yml がある場合は ref で実行できます。

接続メタデータには GitLab インスタンスの URL とアクセストークンが含まれます。トークンは CLI 引数として渡さず、環境変数またはローカル設定に保存してください。

GitLab スキル の高度な機能

  • REST API v4 を通じて GitLab.com と GitLab 9.0 以降のセルフホストインスタンスに対応し、プロジェクトパスは CLI がエンコードします。
  • コマンド実行前に GitLab のバージョンを確認します。必要に応じて GITLAB_SKIP_VERSION_CHECK=1 または DEVOPS_SKILLS_SKIP_VERSION_CHECK=1 を設定すると確認を省略できます。
  • JSON を stdout に出力し、失敗時にはゼロ以外の終了コードを使用するため、後続の自動化に適しています。
  • プロジェクト、Issue、マージリクエスト、CI/CD パイプラインにわたる読み取りと書き込みのワークフローをカバーします。
  • 書き込み操作(Issue や MR の作成、MR のマージ、パイプラインの実行)には、対象プロジェクトとブランチについてユーザーの確認が必要です。MR はマージ可能である必要があり、パイプラインの実行には .gitlab-ci.yml ファイルが必要です。

SKILL.md


ローディング

関連するOpenclawのスキル

METADATA

Github Stars: 0
forks: 0

特徴*