このクイックスタートでは、新規アカウントの作成からエージェントが作成した最初のマージリクエストまでを案内します。所要時間は数分程度——そのほとんどはエージェントの作業を待つ時間であり、設定画面をクリックして回る時間ではありません。
はじめる前に
エージェントに作業させたいリポジトリを持つ GitLab グループまたは GitHub 組織への管理者権限が必要です。加えて、初回実行を最もスムーズにするには Linear のワークスペースがあるとよいでしょう。必要なのはそれだけです。ローカルにインストールするものも、あちこちにコピーするキーもありません。
ステップ1 — サインインする
ログインページに移動し、GitLab または GitHub でサインインします。この一度の同意で、ログインと同時に組織のプロビジョニングも行われます。TaskGoblin は、あなたのリモートグループ（GitLab）ごと、またはアプリのインストール（GitHub）ごとに組織を作成するため、ログインした瞬間にリポジトリが接続されています。
GitHub の場合、対象の組織に TaskGoblin の GitHub App をインストールします。このアプリのインストールトークンが、taskgoblin[bot] として投稿するボットの正体です。GitLab の場合、OAuth の同意によってあなたのグループが列挙され、接続されます。
ステップ2 — 課題管理ツールを接続する
組織メニューからインテグレーションを開き、Linear を接続します。これはワンクリックの OAuth 同意で、TaskGoblin が自分に割り当てられた issue を確認し、更新を投稿できるようにするものです。チームが Slack を使っているなら、ここで Slack も接続しておきましょう——どのスレッドからでもゴブリンにメンションできるようになります。
完全な一覧と、それぞれで何が解放されるかについては、インテグレーションを接続するを参照してください。
ステップ3 — エージェントにタスクを割り当てる
では、実際の作業を任せてみましょう。最初のタスクとしては、小さく、明確に説明された変更——文言の修正、小さなリファクタリング、不足しているテストの追加などが最適です。
- Linear の場合： issue を開き、変更内容を明確に記述し、担当者を TaskGoblin に設定します。
- GitHub の場合： issue に
taskgoblinラベルを追加します。 - GitLab の場合： issue を
@taskgoblinボットに割り当てます。
TaskGoblin は自動的にタスクを拾い上げます——割り当てやラベル自体がトリガーです。監視すべきキューも、押すべきボタンもありません。
ステップ4 — 作業を見守る
エージェントはサンドボックスを起動してリポジトリをクローンし、ai-{issue-identifier} という名前のブランチで作業を開始します。作業の進行に合わせて issue に進捗を投稿するため、新しく何かを開かなくても経過を追うことができます。完了すると、コミットしてプッシュし、その issue にリンクしたマージリクエスト（またはプルリクエスト）を開きます。
ステップ5 — レビューして繰り返す
同僚のコードをレビューするのと同じようにマージリクエストをレビューしましょう。修正が必要な場合、新しくチャットウィンドウを開き直す必要はありません——レビューコメントを残して @taskgoblin とメンションするか、issue に返信するだけです。エージェントはこれまでの実行の全コンテキストを保持したまま同じブランチで作業を再開し、フォローアップのコミットをプッシュします。エージェントに作業を戻すあらゆる方法については、エージェントに作業を割り当てるを参照してください。
ここまでで完了したこと
ツールを接続し、チームがすでに使っている場所からタスクを委任し、レビュー可能なマージリクエストを受け取りました——その間、エージェントがあなたのノートパソコンに触れることは一度もありませんでした。これが一連の流れのすべてです。このドキュメントの他の内容は、すべてこの土台の上に積み重なる詳細にすぎません。