ガイド · 2026 年 11 月 10 日更新 · Cameron Voss および West Mao 著
GitHub で DeepSeek SuperAgent を設定する：Issue からプルリクエストまで（2026年11月）
専用エージェント アカウントから小規模でレビュー可能なプル リクエストまでの実用的なルート。
専用環境でプロトタイプを実行し、GitHub リポジトリとエージェント専用アカウントを接続します。信頼できる依頼者だけを許可し、小さな Issue を依頼しましょう。チケット、ブランチ、テスト、プルリクエストは自分で確認します。Observe モードでも、明示的な依頼によって作業は開始されます。
DeepSeek SuperAgent は、DeepSeek Harness に基づいて構築された研究プロトタイプであり、正式な DeepSeek 製品や運用準備が整ったソフトウェアではありません。別途構成されたモデルプロバイダーが必要です。このガイドは、公開されているドキュメントに従っています。この記事ではエンドツーエンドの導入を実行していません。
最初の便利なタスクは、数分で確認できるほど小さいものです。テスト リポジトリの README にある 1 つの古いコマンドを修正します。以下の例は試用プランであり、記録された実行ではありません。エージェントは質問をしたり、チェックに失敗したり、プル リクエストを作成しなかったりする場合があります。
GitHub に接続する前に何が必要ですか?
公開されたデプロイ ガイドでは、Node.js 22.19 以降または 24 以降、pnpm、Git 2.32 以降、Python 3.8 以降、tmux、GitHub CLI 2.48 以降、互換性のある DeepSeek Harness インストール、および構成されたモデル プロバイダーが必要です。ドキュメントでは、その例として @deepseek-ai/dsh@0.2.1-rc.3 をピン留めしています。別のバージョンを選択する前に、プロトタイプの現在の engines.dsh 範囲を確認してください。このプロジェクトは、github.com 上のリポジトリをターゲットとしています。 GitHub Enterprise Server は、文書化されたソースではサポートされていません。
| 準備する | 重要な理由 |
|---|---|
| 別個の OS アカウントまたは分離ホスト | ワーカーは、サービス アカウントのオペレーティング システムのアクセス許可で実行されます。個人認証情報や無関係なファイルは手の届かない場所に保管してください。 |
| テスト リポジトリ | 本番環境の秘密や展開権限のない小さなリポジトリを使用します。チケットごとのワークツリー用にローカル クローンを保持します。 |
| 専用の GitHub ユーザー | エージェントには、独自のユーザー ID とリポジトリ アクセスが必要です。文書化されたソースは、そのアカウントの通知を読み取ります。 |
| 信頼できるリクエスタ | 許可リストにある自分の GitHub ログインから始めます。自動マージをオフのままにし、ブランチ保護を使用します。 |
| モデル プロバイダ | Harness で動作するプロバイダを設定します。モデル料金とホスティング料金は、MIT ライセンスのコードとは別です。 |
GitHub ID と OS アカウントはさまざまな問題を解決します。 GitHub 認証情報を別にしても、ワーカーがその OS アカウントでアクセスできるファイルを読み取ることができなくなります。
ランタイムとエージェントのアカウントはどのように準備しますか?
- サービスを実行する環境に必要なツールをインストールします。
node -v、pnpm -v、git --version、python3 --version、tmux -V、gh --version、dsh --versionでバージョンを確認します。 - エージェントの専用 GitHub ユーザーにテスト リポジトリへのアクセスを許可します。個人アカウントではなく、そのアカウントにエージェントの GitHub CLI ラッパーに署名し、返されるログインを確認します。
- サービス環境内に
deepseek-ai/dsh-superagent-prototypeリポジトリのクローンを作成して構築します。プロジェクトのSETUP.mdでは、エージェント支援セットアップについて説明しています。導入ガイドには手動の手順が記載されています。 - 新規インストールの場合のみ別の SuperAgent Harness プロファイルを作成し、バンドルをインストールし、プロファイルの状態ディレクトリとパネルを設定します。 既存のプロファイルを再作成しないでください。文書化されたプロファイル作成コマンドによってその構成が置き換えられます。
- サービスを開始し、
scripts/dsh-superagent statusを確認します。最初の起動では、セットアップ情報が欠落していることが予想されます。タスクを送信する前に解決してください。
新しいプロファイルの場合、公開された展開例では次のシーケンスが使用されます。リポジトリと前提条件を確認した後、分離されたサービス環境内で実行します。 REPOSITORY_URL をパブリック deepseek-ai/dsh-superagent-prototype リポジトリの URL に置き換えます。
npm install -g @deepseek-ai/dsh@0.2.1-rc.3
git clone REPOSITORY_URL dsh-superagent
cd dsh-superagent
pnpm install && pnpm build
# New profile only: this replaces an existing superagent profile.
dsh superagent --from-default-profile web --dump-config > /dev/null
dsh plugin --profile superagent add "link:$PWD"公開された手動セットアップには、examples/profile.cordis.patch.yml に基づくマシン構成が必要です。サービスを開始する前に、絶対 stateDir とパネルのローカル バインド設定を設定します。実行中の設定にプレースホルダをコピーするのではなく、チェックアウトしたリポジトリ内のサンプルと現在のデプロイメント ガイドを確認してください。
scripts/dsh-superagent start
scripts/dsh-superagent status問題、チャット記録、およびリポジトリに秘密を含めないでください。意図したログイン フローを通じて認証情報を設定し、独自の環境でアカウントと権限を確認します。
Issue をチケットに変えるには何を設定しますか？
[SuperAgent] パネルで、リポジトリとエージェントの CLI ラッパーを使用して GitHub ソースを構成します。ポリシーの下で、要求者の GitHub ログインを許可リストに追加します。チェックアウト ソースと各チケットに独自のワークツリーを与える準備コマンドを使用して実行を構成します。ワークツリーは変更を整理した状態に保ちます。これはセキュリティ サンドボックスではありません。
推論されたアクティビティの受け入れモードとして observe から開始し、自動マージを無効のままにします。ソースが準備完了と報告し、ステータスでセットアップが欠落していると報告されなくなっていることを確認します。パネルは、後のバージョンでは異なる表現を使用する可能性があります。トラブルシューティングの前に、インストールされているバージョンを記録してください。
最初の GitHub Issue には何を書きますか？
許可されたリクエスタ アカウントから、エージェントに宛てたコメントを追加します。名前をエージェントの実際のログイン名に置き換えます。
@agent-login Please update the README installation example to match the current package name. Limit the change to the README, run the relevant documentation check, and open a pull request for human review. Do not merge.これは明示的なリクエストです。受け入れられた場合、推論された作業が observe にあるときでも実行できます。文書化されているデフォルトのポーリング間隔は 1 分ですが、チケットまたは PR は保証されません。問題の本文を編集してメンションを追加しても何も起こらない場合は、代わりにメンションをコメントとして投稿してください。
チケットとプルリクエストをどう確認しますか？
- 概要を開いてチケットを探します。問題、リクエスタ、タスクの説明が意図したものと一致していることを確認します。
- チケットがキューに入れられているか、作業中か、ブロックされているか、レビュー待ちであるかを検査します。質問またはブロックされたステータスには担当者が必要です。修正が完了したという証拠ではありません。
- 提案されたブランチと PR を開きます。変更されたファイル、コミット ID、および正確な差分を確認します。シークレットや無関係な変更が追加されていないことを確認します。
- 関連するチェックを個別に実行または検査します。必要に応じて、既存のスレッドで修正を依頼してください。リクエストは元のタスクのスコープ内に留めてください。
- 適切なリポジトリ権限を持つ人のみが、この最初のトライアルでレビューされた結果を承認し、マージする必要があります。
チケットが表示されない場合はどうすればよいですか?
| 症状 | 最初のチェック |
|---|---|
| メンションに対する応答がない | ソースが有効になっていて、処理が一時停止されておらず、リクエスタが許可されていることを確認してください。編集した問題の本文ではなく、新しいコメントを使用してください。 |
| エージェント CLI がアカウントを読み取ることができません。 | 設定されたラッパーを確認し、そのラッパーを専用エージェント アカウントに署名します。 |
| エージェントが読み取りまたはプッシュできません。 | リポジトリ名とエージェント アカウントの実際のアクセスを確認してください。 |
| コマンドを準備する失敗しました | チケットエラーの読み取り。クローン パス、ワークツリーの宛先、および Git 設定を確認してください。 |
| ステータスが 3 を返します | サービスはセットアップを待機しています。再起動を繰り返す代わりに、不足している要件を確認してください。 |
Coding Planでこのプロトタイプを実行できますか?
SuperAgent は、Harness で設定されたモデル プロバイダーを使用します。このプロトタイプがこのサイトのCoding Planで動作するかどうかは検証されていないため、このワークフローのプランを購入する前に、エンドポイント、モデル、認証の互換性を確認してください。 セットアップとコストのガイドから始めるか、利用可能なCoding Planを比較してください。
よくある質問
Observe モードは、許可されたユーザーのリクエストを停止しますか?
いいえ。推定された候補者に対する肯定的な決定を受け入れずに記録します。明示的なリクエストは引き続き可能です。
1 つのインスタンスで複数のリポジトリをカバーできますか?
公開プロトタイプは、1 つの GitHub リポジトリについて文書化されています。マルチリポジトリの適応は、評価する別のプロジェクトとして扱います。
プルリクエストがあればタスクの成功を証明できますか？
いいえ。差分とテストの結果を確認し、マージする前に問題に対する変更を検証します。