ダンジョンズ＆デスクトップ：GitHub Copilot CLI で手動生成型ローグライクを構築する

GitHub Copilot CLI チャレンジに熱中してしまい、少し疑問符がつくような決断を下しました：自分のコードベースをローグライクダンジョンに変えてしまったのです。 きっかけはシンプルなプロンプトでした。「現在のリポジトリを受け取り、BSP [省略] を用いて生成されたダンジョンを持つプレイ可能なローグライクダンジョンにする Go 言語製の GitHub CLI エクステンションを作成せよ」。そして /yolo と入力しました。 その結果が「GitHub Dungeons」です。これはコードベースからダンジョンを生成するターミナルゲームです。部屋、通路、敵はすべてあなたのリポジトリから構築され、ターミナル内で直接描画されます。矢印キーで移動し、バグと戦い、出口を探します。すべてのリポジトリが異なるマップを生み出し、すべてのコミットがレイアウトを再形成します。そして HP がゼロになると、最初からやり直しです。 ![image](https://github.blog/wp-content/uploads/2026/05/Screenshot-2026-05-01-at-3.53.00-PM.png?resize=1024%2C432)  豆知識： /yolo（「You Only Live Once」の略）は Copilot CLI のコマンドです（/allow-all のエイリアス）。ローグライクがパーマデス（一度死んだらゲームオーバー）を中心に構築されていることを考えると、まさにふさわしい名前ですね。本当に人生は一度きりなのです。 ローグライクは 1980 年代の『Rogue』などのゲームにそのルーツがあります。ターミナルベースのアドベンチャーで、各プレイごとに新しいダンジョンが生成され、死んだら最初からやり直すというものです。 この「手動生成（プロシージャラルジェネレーション）」、「パーマデス」、そしてテキストベースインターフェース（後に「ベルリン解釈」といった概念で形式化されました）の組み合わせにより、このジャンルは驚くほど現代的に感じられ、コマンドラインとの相性が抜群です。 GitHub Dungeons はその伝統に倣っています。これは Go で書かれていますが、私は普段は Go を使いません。しかし Copilot との連携により、構文よりも振る舞いに集中できました。 手続き型生成とは何か？ 手続き型生成（あるいは「procgen」というクールな子供たちが呼ぶ名前）は、手作業でデザインするのではなく、アルゴリズムによってコンテンツを作成する方法です。ゲームにおいては、通常、一定のルールと少しのランダム性を用いて、実行時にレベル、マップ、敵、アイテムなどが生成されることを意味します。 つまり、一つのダンジョンをデザインするのではなく、多くのものを生成するシステムをデザインするのです。 それがローグライクに繰り返しプレイできる理由を与えます： すべてのプレイが異なる レイアウトは毎回変化する 何かが 何かが GitHub Dungeons では、このシステムはあなたのリポジトリと結びついています。レイアウトは最新のコミットによってシードされるため、同じコードは同じダンジョンを生成し、変更を加えるたびにそれが形を変えます。 では、実際のリポジトリがどのようにしてダンジョンになるのでしょうか？ 高レベルでは、GitHub Dungeon のレイアウトは、Binary Space Partitioning（BSP）を使用して生成されます。これはリポジトリの最新のコミット SHA によってシードされます（BSP については後ほど詳しく説明します）。つまり、同じコードベースは一貫したレイアウトを生成しますが、コードが変化するにつれて進化し続けます。 実際には： 同じコミットは常に同じマップを生成する 異なるリポジトリからは構造的に明確に異なるレイアウトが生まれる コードが変化するにつれ、ダンジョンもそれとともに進化する これは手続き型生成ですが、あなたのコードベースと直接結びついています。それがこのアイデアです。 実際に興味深かったのは、それを構築することでした。 Copilot CLI で構築する GitHub Copilot CLI を使用することは、最初からすべてを書くのではなく、動作を記述することを意味しました。大きな違いをもたらしたコマンドの一つが /delegate です。インラインでコードを生成するだけでなく、/delegate はクラウド上で実行されている GitHub の Copoid コーディングエージェントにタスクを引き渡します。 私は望むものを平易な英語で説明し、開始すると、それが独立して作業している間に他のことをしていても大丈夫でした。完了すると、結果を含むプルリクエストが開かれます。 例えば、/delegate Make each level progressively harder e.g. on level 2 there are extra baddies, but more health potions と入力しました。 Copilot は非同期で堅牢な最初のバージョンを生成し、そこから私はそのプルリクエストを確認・調整してバランスが適切になるまで続けました。プレイヤーが無敵になるチートコードを追加するなど、他の機能にも同じアプローチを取りました（なぜしないのか）。 さらに、ダンジョンの生成方法を説明するためにドキュメントと ASCII アートの図を追加する小さなヘルパーである「ダンジョン書記」エージェントを Copilot に生成させました。これはターミナル型ローグライクにとって非常にブランドに合っていると感じられました。 Copilot を使用すること（特に /delegate とともに）は、私が望むことを何でも実行してくれる NPC の軍隊を持っているようなものです。 リー・ライリー、ダンジョンマスター このように作業を進める（機能の説明を行い、Copilot に任せて、生成されたプルリクエストをレビューする）ことで、エッジケースやボイラープレートに費やす時間を減らし、プレイヤー体験に集中できるようになりました。これには、プレイヤーが発見できるイースターエッグの追加も含まれます。Copilot と反復作業を行うことで、実装の詳細に頻繁に切り替えるのではなく、ゲームデザインの思考モードを維持できました。ビルドとスケルトン構築の大部分を Copilot が担当してくれたおかげで、メカニズムの設計やアイデアのテスト、そして実際に何がゲームをおもしろくするかを考えるというフローから離れることなく作業を進めることができました。 手動生成されたダンジョン（BSP 使用） 各ダンジョンデザインの核心には、バイナリー空間分割（Binary Space Partitioning: BSP）と呼ばれる技法があります。これは、友人や同僚を感心させたい場合に、ミドルアウト圧縮と共に casually に言及できる素晴らしいテクニックです。一見すると難しそうに聞こえますが、その考え方は驚くほどシンプルです：空間をより小さなチャンクに分割し続け、接続可能な部屋をいくつか得るまで繰り返します。 なぜ BSP がローグライクに適しているのか ローグライクでは、以下のような感覚を持つマップが必要です： 構造化されている（完全にランダムな無意味なものではない） 再プレイ性がある（毎回異なる内容になる） ナビゲート可能である（行き止まりや不可能なレイアウトがない） BSP はこの点で絶妙なバランスを提供します。以下のような特徴があります： 清潔で長方形の部屋 接続性の保証 有機的な感覚を与えるのに十分なランダム性 仕組みは以下の通りです… 1. 大きな空の空間から始める すべては一つの大きな長方形として始まります：それがあなたのダンジョン全体です。 ![image](https://github.blog/wp-content/uploads/2026/05/Screenshot-2026-05-01-at-3.53.09-PM.png?resize=1024%2C431) 2. 再帰的に分割する 空間を 2 つの領域に分割します。 ![image](https://github.blog/wp-content/uploads/2026/05/Screenshot-2026-05-01-at-3.53.33-PM.png?resize=1024%2C434) その後、さらに分割を繰り返します。 ![image](https://github.blog/wp-content/uploads/2026/05/Screenshot-2026-05-01-at-3.53.44-PM.png?resize=1024%2C433) さらに繰り返します。 各分割は水平方向または垂直方向のいずれかで行われます。 3. 領域が小さくなりすぎたら停止する 部屋を配置できなくなるほど領域が小さくなるまで、分割を続けます。 これにより、「リーフ（葉）」と呼ばれる最終的な建築ブロックとなる多数の領域が生成されます。 ![image](https://github.blog/wp-content/uploads/2026/05/Screenshot-2026-05-01-at-3.53.54-PM.png?resize=1024%2C433) 4. 各領域を部屋に変換する 各リーフは部屋になりますが、完全に整列させるわけではありません。サイズと位置にわずかなランダム性を加えます。 ![image](https://github.blog/wp-content/uploads/2026/05/Screenshot-2026-05-01-at-3.54.03-PM.png?resize=1024%2C434) このわずかなランダム性が、すべてがグリッド状になりすぎるのを防ぐ要因となります。 5. 廊下で部屋をつなぐ 次に、ツリーを逆方向にたどりながら兄弟ノード同士をリンクすることで、部屋同士をつなぎます。 ![image](https://github.blog/wp-content/uploads/2026/05/Screenshot-2026-05-01-at-3.54.12-PM.png?resize=1024%2C435) ![image](https://github.blog/wp-content/uploads/2026/05/Screenshot-2026-05-01-at-3.54.22-PM.png?resize=1024%2C433) 各接続は L 字型になります。 6. 最終結果：構造化されたカオス これらをすべて組み合わせると、以下のようなものが完成します: ![image](https://github.blog/wp-content/uploads/2026/05/Screenshot-2026-05-01-at-3.54.28-PM.png?resize=1024%2C433) 部屋は意図的に配置されている 廊下によってすべての場所が到達可能になる 毎回異なるランダム性（ただし、シード値を使えば再現可能） なぜこれがこれほどうまく機能するのか BSP（Binary Space Partitioning：二分空間分割）について私が気に入っている点は、設計されたように感じられるのに、実際にはそうではないという点です。 これは手動生成の2つの大きな問題を回避します。すなわち、純粋なランダム性による混乱と、硬直したグリッドによる予測可能性（および退屈さ）です。その代わりに、その中間にある何か、そして時には美しいものが得られます。 インストール方法と遊び方 自分のコードベースがダンジョンとしてどのように見えるかを確認したい場合、すでに GitHub Copilot CLI がインストールされていれば、以下を実行できます: gh extension install leereilly/gh-dungeons その後、gh dungeons を実行して、征服の準備ができているカスタムダンジョンに変換します。ヒーローの操作には、WASD キー、矢印キー、または Vim キーを使用してください。 あなたの目標は、隠された扉を見つけて、5 つのレベルにわたって敵から脱出（そして攻撃！）することです。視界を制限する「霧のかかった戦争（fog of war）」や、自動攻撃機能、キル数や征服したレベル数の統計を追跡できる機能など、おもしろい機能を追加しました。これら以外にも、自分で発見しなければならない機能が多数あります。 危険区域！ 無謀な気分なら、「クレイジーモード」でプレイしてみてください。ゲーム全体をクリアするまでセーブされた変更を削除する pre-commit フックを設定できます。 ⚠️ 警告：リポジトリにこれがどのような影響を与えるかを完全に理解していない限り、この操作は行わないでください。保存された作業が失われ、おそらく精神的な安定も損なわれることになります。 # プリコミットフックの作成 cat > .git/hooks/pre-commit << 'EOF' #!/bin/bash gh dungeons if [ $? -ne 0 ]; then echo "You died! Your changes have been stashed into oblivion..." git stash && git stash drop stash@{0} exit 1 fi EOF # 実行可能権限を付与 chmod +x .git/hooks/pre-commit # 明確に言っておきますが、ダンジョン攻略に失敗した場合、この機能を有効化するとすべての未コミットの変更は失われます。冒険者よ。 （編集者の注：どうか、どうか、どうかこれは行わないでください。失われた作業について当方は一切責任を負いません。ただし、リー氏にはその責任があります。） これを持って旅立とう これは捨て台詞のような実験から始まりましたが、GitHub Copilot CLI に対する私の考え方を一変させました。 私は素早く MVP（Minimum Viable Product：実用最小限の製品）を構築し、重要な部分について反復改善を行うことができました。そして、BSP 生成や、少し呪われたような Yendor の YAML ファイルに定義されたモンスターや移動ロジックといった重労働は Copilot に任せることができました。 記事「Dungeons & Desktops: Building a procedurally generated roguelike with GitHub Copilot CLI」は、もともと The GitHub Blog で公開されました。

ダンジョンズ＆デスクトップ：GitHub Copilot CLI で手動生成型ローグライクを構築する

背景や根拠まで確認しますか？

調べる

選ぶ

サイト

背景や根拠まで確認しますか？

ニュースの次に確認する

調べる

選ぶ

サイト