GitHub CLI 2.94.0でgh discussionからDiscussionsの読み書き、gh skillでAgent Skillsの一覧表示ができるようになりました

どうも！オペ部の西村祐二です！

GitHub CLI 2.94.0 では、gh issue のIssue types / sub-issues対応が大きなアップデートですが、もうひとつ見逃せない変更があります。

GitHub Discussionsを扱う gh discussion と、Agent Skills管理を補強する gh skill list / gh skill install --all が追加されました。

CLIやAIエージェントでGitHub上の文脈を読むという意味では、こちらも待望のアップデートかなと思います。この記事では、gh discussion と gh skill 周りを確認します。

今回見るもの

GitHub CLI 2.94.0のうち、この記事で見るのは次の2つです。

試してみる

環境

• macOS / Darwin arm64
• GitHub CLI 2.94.0

gh discussionでDiscussionsを読む

GitHub CLI 2.94.0では、gh discussion command setが追加されました。

GENERAL COMMANDS
  create:        Create a new discussion (preview)
  list:          List discussions in a repository (preview)

TARGETED COMMANDS
  comment:       Add, edit, or delete a comment or a reply on a discussion (preview)
  edit:          Edit a discussion (preview)
  view:          View a discussion (preview)

create、edit、comment までありますが、これらは実データを変更します。まずは読み取りの list / view を確認したうえで、後半でDiscussionsを有効にした自分のリポジトリで create / edit / comment も試します。

公開リポジトリのDiscussionsを一覧してみます。

gh discussion list --repo cli/cli --limit 3

実行結果です。

Issueはバグやタスクとして整理されやすい一方、DiscussionsにはQ&Aや相談、設計の迷い、使い方の質問が残ります。

これをCLIから読めると、「IssueにはないがDiscussionに同じ相談があるか」をターミナルで確認しやすくなります。OSS調査や障害調査では、IssueだけでなくDiscussionも見ることが多いので、入口が gh に揃うのは便利です。

gh discussionで作成・編集・コメントする

create / edit / comment は実データを変更するため、公開リポジトリではなく、Discussionsを有効にした自分のリポジトリ（以下 OWNER/REPO）で試します。

create は --title / --category / --body を渡すと、対話プロンプトなしでDiscussionを作成できます。

gh discussion create --repo OWNER/REPO --title "gh discussion 動作確認 (test)" --category General --body "create 動作確認"

実行結果です。URLが帰ってきます。

https://github.com/<OWNER/REPO>/discussions/<番号>

作成したDiscussionに、comment でトップレベルコメントを追加します。引数にはDiscussion番号（またはURL）を渡します。

gh discussion comment <番号> --repo OWNER/REPO --body "comment 動作確認"

実行結果です。URLが帰ってきます。

https://github.com/<OWNER/REPO>/discussions/<番号>#discussioncomment-99999999

edit でタイトルや本文を更新します。

gh discussion edit <番号> --repo OWNER/REPO --title "gh discussion 動作確認 (edited)" --body "edit 動作確認: 本文更新"

実行結果です。URLが帰ってきます。

https://github.com/<OWNER/REPO>/discussions/<番号>

最後に view で、コメント追加とタイトル・本文の編集が反映されたか確認します。

gh discussion view <番号> --repo OWNER/REPO

実行結果です。

AIエージェントとの相性

gh discussion list / view があると、AIエージェントに調査させる対象が増えます。

たとえば、あるCLIの使い方で詰まったときに、次のような順番で調べさせやすくなります。

1. gh issue list で関連Issueを探す
2. gh discussion list で関連Discussionを探す
3. 見つかったIssueやDiscussionを view して要約する
4. READMEやリリースノートと突き合わせる

GitHub上の情報は、IssueだけではなくDiscussionにも情報がある場合があります。DiscussionがCLIから扱えるようになったことで、エージェントの調査範囲を自然に広げられます。

gh skill listでAgent Skillsを一覧表示する

v2.94.0では、gh skill list も追加されています。

gh skill list

このvaultで実行すると、プロジェクト内の .agents/skills にあるスキルが一覧されました。出力は次のような形です。

以前 GitHub CLI v2.90.0の gh skill を試したときには、インストール済みスキルの一覧表示が弱く、ディレクトリを直接見る必要があると書いていました。

gh skill list が入ったことで、少なくとも「どのスキルが、どのエージェント向けに、どのscopeで入っているか」はCLIで確認しやすくなっています。

install --all と update時のskip挙動

gh skill install --help では、--all も確認できました。

--all                 Install all skills without prompting for skill selection

複数スキルをまとめたリポジトリを取り込むときに、対話選択を挟まず一括導入できます。

gh skill update --help では、metadataのないスキルを --all や非対話モードではskipする挙動も説明されています。

Skills without GitHub metadata ... With --all or in non-interactive mode, they are skipped with a notice.

自作スキルや手動配置スキルが混ざっている環境では、ここが効きます。対話プロンプトで止まらず、CIやエージェント実行でも安全側に倒れる挙動です。

実務でどう扱うか

今回の gh discussion と gh skill の更新は、「GitHub上の文脈」と「エージェントの作業環境」をCLIから扱いやすくする変更です。

OSS調査や障害調査では、Issueだけで終わらせず、Q&Aや相談が集まるDiscussionも合わせて追えると見落としが減ります。人手で当たりを付けるときも、エージェントに調べさせるときも、入口が gh に揃うのは扱いやすいです。

gh skill list は、Agent Skillsを複数ホスト・複数エージェントで共有している環境で便利なコマンドとなります。.agents/skills のような共有ディレクトリでも、どのスキルがどのホスト向けに入っているかをCLIで一覧表示できると、管理がしやすくなります。

注意点

今回確認した範囲での注意点です。

• gh discussion と gh skill はpreviewなので、今後の変更を前提にする
• gh skill list はプロジェクト内のスキルも拾うため、実行ディレクトリによって結果が変わる
• gh skill update --all はmetadataのないスキルをskipするため、手動配置したスキルの更新は別途考える必要がある

まとめ

GitHub CLI 2.94.0では、gh discussion と gh skill も便利なアップデートが入っていました。

gh discussion は、Issueだけでは拾えないQ&Aや相談をCLIから読めるようにします。gh skill list は、Agent Skillsを複数環境で使うときの一覧表示を楽にします。

Issue typesやsub-issuesほど派手ではありませんが、GitHubをブラウザだけでなくCLIやエージェントから扱う流れとして見ると、かなり実用的なアップデートです。

誰かの参考になれば幸いです。

参考リンク:

• GitHub CLI 2.94.0 Release Notes
• GitHub CLI manual