gitlab について
GitLabの操作手順をエージェントに示すスキルです。利用可能な認証済みGitLab MCPツールを優先し、使えない場合は`GITLAB_TOKEN`でGitLab APIを利用します。ブランチとマージリクエストの手順も定めています。
主な機能
- 01認証済みGitLab MCPツールを優先
- 02`GITLAB_TOKEN`でGitLab APIを利用
- 03`create_mr`によるマージリクエスト作成
- 04ブランチとプッシュのルール遵守
- 05トークンを使ったリモート設定
活用シーン
- 01MCPツールとAPIの利用方法の選択
- 02依頼された変更のマージリクエスト作成
- 03別ブランチへの作業プッシュ
- 04トークン関連のプッシュ認証問題への対処
MCP 対応
認証済みGitLab MCPツールが利用可能な場合はその使用をエージェントに促します。利用できない場合は、`GITLAB_TOKEN`を使ってGitLab APIを操作する手順を示します。
インストール
コマンドをコピーしてターミナルで実行します。
npx skills add https:/インストール後、Claude Code で/gitlabを入力して読み込まれたか確認します。
同梱ファイル.plugin/plugin.jsonREADME.md
詳細
接続の選択
エージェントの環境で認証済みの GitLab MCP ツールを利用できる場合は、まずそれを使用してください。特定の MCP サーバー名に依存せず、ツールが利用可能かどうかで判断してください。以下のトークンおよび直接 API を使用する手順は、GitLab MCP ツールを利用できない場合、または raw API や curl へのアクセスが明示的に必要な場合にのみ使用してください。
環境変数 GITLAB_TOKEN を利用して、GitLab API とやり取りできます。
GitLab へのプッシュ時に認証の問題（パスワードの入力要求や権限エラーなど）が発生した場合は、古いトークンの有効期限が切れている可能性があります。その場合は、リモート URL に現在のトークンを含めるよう更新してください：git remote set-url origin https://oauth2:${GITLAB_TOKEN}@gitlab.com/username/repo.git
プッシュする手順を以下に示します。ただし、ユーザーから依頼された場合にのみ実行してください：
mainまたはmasterブランチに直接プッシュしないでください。- Git の設定（ユーザー名とメールアドレス）はあらかじめ設定されています。変更しないでください。
openhands-workspaceで始まるブランチにすでにいる場合があります。プッシュする前に、より適切な名前の新しいブランチを作成してください。- まだマージリクエストを作成していない場合は、
create_mrツールを使用して作成してください。 - 独自のブランチまたはマージリクエストを作成したら、その後はそれを更新してください。明示的に依頼された場合を除き、新しいものを作成しないでください。必要に応じて PR のタイトルと説明は更新してもかまいませんが、ブランチ名は変更しないでください。
- ユーザーから別の指定がない限り、ベースブランチには main ブランチを使用してください。
- マージリクエストを作成または更新した後は、リンクを添えてユーザーに短く知らせてください。
- 以上の作業は、できるだけ少ない手順で行ってください。たとえば、次の bash コマンドを実行すれば、1 つの手順で変更をプッシュできます：
git remote -v && git branch # to find the current org, repo and branch
git checkout -b create-widget && git add . && git commit -m "Create widget" && git push -u origin create-widget
Windows PowerShell では、リモート URL に $env:GITLAB_TOKEN を使用してください。また、インストールされているシェルが && に対応していない場合は、git コマンドを個別に実行してください。