Openclaw向けGitHub Projects v2 Skill

GitHub CLI を介して GitHub Projects v2 の backlog、ステータス更新、および issue のライフサイクルをシームレスに管理するように設計された AI agent skill です。

freddydk
v1.0.0
Jun 5, 2026
3
510
0

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

1. ClawHub CLI

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

npx clawhub@latest install git-hub-projects-v2

2. 手動インストール

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

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

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

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

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

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

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

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

GitHub Projects v2 Skill とは?

GitHub Projects v2 skill は、AI 開発 agent に、公式の gh CLI を通じてボード、タスク backlog、およびフィールドをプログラムで直接管理する専門的な能力を提供します。GitHub の堅牢で最新のプロジェクトアーキテクチャとシームレスにインターフェースすることにより、この skill はアクティブなコード変更とプロジェクト管理の追跡の間のギャップを埋めます。

Openclaw Skills エコシステム内でこの skill を使用すると、AI agent は人間のコンテキスト切り替えを強制することなく、受信 ticket を動的にトリアージし、issue パラメータを修正し、スプリントのタイムラインを構築し、子 issue を epic マイルストーンにリンクできます。これは、日常的なアジャイルセレモニーやプロジェクトボードのグルーミングワークフローを自動化したいチームにとって、不可欠なコンポーネントとして機能します。

GitHub Projects v2 Skill のユースケース

  • 特定の開発者やマイルストーンに割り当てられたオープンな issue をターミナルから直接トリアージおよびフィルタリングします。
  • 開発の進捗状況に基づいて、プロジェクトのフィールドステータス、イテレーション、ストーリーポイント、およびカスタムフィールド値を動的に更新します。
  • issue を自動的に作成し、指定されたプロジェクトボードに追加し、コメントを介して進捗状況の更新を注入することにより、issue の追跡を自動化します。
  • 詳細な epic およびサブタスクのブレイクダウン追跡のために、親子 issue 関係を構築します。

GitHub Projects v2 Skill の仕組み

  1. Authentication Verification: agent は認証ステータスを確認し、GitHub CLI を介して必要なプロジェクトスコープを要求します。
  2. Target Node Discovery: skill は、構造変更に必要な特定のプロジェクトおよびアイテムノドの GraphQL ID を取得します。
  3. Querying and Filtering: skill は、ステータス、割り当て、またはカスタムメタデータフィールドなどのターゲットフィルターを使用して、既存の backlog をクエリします。
  4. Mutation Implementation: skill はフィールドを更新し、選択値を変更し、ステータスカラムを変更し、または外部の issue URL を追加します。
  5. Relationship Linkage: skill は CLI 拡張機能または生 の GraphQL API コールを活用して、子 issue を介して構造的階層を構築します。

GitHub Projects v2 Skill のセットアップ

GitHub CLI (gh) がインストールされ、認証されていることを確認してください。この skill には、v2 ボードを管理するために project スコープが必要です。

# Verify your current authentication status and scopes
gh auth status

# Refresh your authentication tokens to append the required project scope
gh auth refresh -s project

# (Optional) Install the sub-issue extension if managing issue hierarchies
gh extension install yahsan2/gh-sub-issue

GitHub Projects v2 Skill のデータスキーマとタクソノミー

この skill は、識別 token と構造化された CLI 出力を使用してパラメータを管理します。人間が読める数字とバックエンドの GraphQL ノードの間でデータがどのようにマッピングされるかを理解することが重要です:

Data Component CLI Reference Type Formats / Examples Purpose
Project Number Short Identifier (Integer) 1, 42 標準的なプロジェクトボードのアクションに使用されます
Project ID GraphQL Node ID PVT_kwDOA... アイテム編集の mutation に必要です
Item Node ID GraphQL Node ID PNI_lADOA... ボード内の単一のアイテムを一意に参照します
Field Node ID GraphQL Node ID PVTF_lADO... Status や Priority などの設定 schema を参照します

GitHub Projects v2 Skill の高度な機能

  • Granular Item Editing: アイテム全体の Single-Select、イテレーション(スプリント)、日付、および数値フィールドをプログラムで操作します。
  • Sub-Issue Hierarchy Support: 高度な GraphQL mutation または CLI 拡張機能を使用して、ネイティブの親子 issue マッピングをオーケストレートします。
  • JSON Output Integration: jq パースと組み合わせた生の JSON ペイロード応答を生成することにより、下流のスクリプト作成およびデータ処理パイプラインを効率化します。

SKILL.md


ローディング

関連するOpenclawのスキル

METADATA

Github Stars: 0
forks: 0

特徴*