issueの使い方 - 2025SpringHewGameJam/info GitHub Wiki

概要

前回のチーム制作では、タスクの内容にすれ違いが生じることが多々あった(班によるかも)。毎度対面で作業するのであれば都度確認すればよいが、そうもいかないためあらかじめ指示書を作成し、不明瞭な点をなるべく排除したうえでもしあればすぐにコミュニケーションが取れるように今回のチーム制作ではIssueというGitHubに搭載されている機能を活用していく。そのため、基本的にはタスク内容を提示するにしても、やり取りするにしても、取り組むにしてもIssueというものを使えないと何もできなくなるのでここで解説していく。また、後述するProjectという機能を使えばこのIssueに対してラベル分けをすることでガントチャートをほぼ自動で作成することができるため、効率を上げるという意味でも採用とした。

Issueについて

どこから見れるのさ

GitHub上のCodeなどが並んでいるタブの中にIssuesというボタンがあります。あいにくここは情報用のリポジトリなため、メインでゲームを制作しているリポジトリのIssuesを開くようにしてください。
もしすでに内容があれば、具体的なタスクの内容を確認することができます。各タイトルをクリックすると詳細が見れるようになるので、詳細を確認したい場合は気になるタスクを確認してみてね。
また、自分自身が作成する場合でもIssueは作成してください。タスクの状況を管理するために使うので、タスク確認兼指示書だと思って作成してください。自分が作成する場合は指示の内容比較的雑でもまあいいです。

Issueの作り方

  1. 上のタブを押します。
  2. 右側にNew Issueという緑色のボタンがあるので押します。
  3. タスクの種類を聞かれるので近い項目を押します。もし自由系で作成したい場合は一番下のBlank Issueをクリックしてください。基本的に推奨はしません。
  4. でてきた内容に沿って指示を記載してください。誰が見てもわかるように指示の内容は記載してください。互いに齟齬がないようにするためにこのツールを使用するため、伝わりやすいように記載するほうがあとから追加のやり取りがないので好ましいです。
  5. 情報を記載し終わったら下にあるCreateのボタンを押すとIssueが作成できます。
    このIssueは担当者やIssueをラベル分けすることもできるため、この機能も活用しましょう。ひと目で見てわかりやすい指示書になるはずです。
    他にも横にあるProjectsという欄を押すと、タスクの状態や終了日なども設定でき、設定するとProject上でわかりやすい状態で進捗度合いやタスクの種類等を確認できます。

SubIssueについて

すでに作成済みのIssueを見ていると、Create SubIssueというボタンがあると思います。この機能を使うと、そのIssueに対する子のIssueを作成可能です。基本的にはこの機能を利用し、階層構造でタスクを作成してもらうのが好ましいです。この機能を使うと親のIssueからどのタスクが完了していて全体はどれくらいの進捗度か、というのが見れるようになるため小タスクの進行度合いも確認しやすくなります。

Issueの裏技

GitHubにデータをアップロード(commit)するときに、コメントを書く必要がありますね。この際に#Issueの番号と書くことで変更内容をIssueと紐づけることが可能になります。これをつけるとIssueを確認した際、どれくらい作業が進んでいるかがわかるようになるため、基本的に付随する作業をcommitする際はこの機能を使いましょう。