DeepSeek Super Agent の試作版を理解する:dsh-superagent の構成と利用上の境界

DeepSeek Harness 公式 dsh-superagent-prototype のイベントフロー、タスク分離、権限モデル、研究試作版を試す際のリスクを解説します。

DeepSeek Harness チームが公開した dsh-superagent-prototype は、GitHub リポジトリのメッセージと、任意で Feishu のメッセージをエージェントのタスクに変換する研究用プロトタイプです。完成した商用 DeepSeek 製品でも、導入すればあらゆる Issue を安全に処理する汎用ボットでもありません。評価する際は、リクエストの選別、権限付与、実行分離の仕組みを先に理解してください。

この記事は公式リポジトリの README、SETUP、設計文書に基づいています。リポジトリ自身が参考用の研究コードと明記し、不具合の可能性があり、本番利用を想定していないと説明しています。コードや設定は変わるため、試す前に現在の文書を確認してください。

Google Trends の中国地域における直近 30 日の比較では、「DeepSeek」の相対指数は同じ比較対象の Python、Claude Code、OpenClaw、Ollama より大幅に高く、「deepseek super agent」「deepseek superagent」などの関連検索語も上昇として表示されました。Trends の 0–100 は地域と期間を選んだ範囲内の相対値であり、検索数や流入数ではありません。本サイトには DeerFlow SuperAgent と DeepSeek のターミナルエージェント記事があります。この記事では dsh-superagent-prototype 固有のイベントモデル、境界、評価方法を補います。

何をするものか、何ではないか

パッケージ名は dsh-superagent です。GitHub イベントを監視し、任意で Feishu も接続するアクティブエージェントの試作版です。ポリシーに照らしてリクエストを評価し、受け付けた依頼を Ticket にまとめ、個別の DeepSeek Harness セッションへ割り当てます。

「アクティブ」は、エージェントが自由に仕事を探すという意味ではありません。プロジェクトの原則では、許可された人から依頼された場合、またはチームが記述したルールで認められた場合にのみ動作します。明確な許可がない自動トリガーは、まず observe モードで、実行せずに予定する動作を記録するよう文書が案内しています。

ホスト型サービスでもありません。実行環境、モデルまたは Harness の設定、リポジトリ権限、メッセージの入口、運用方法は利用者が用意します。組織の本人確認や権限レビューをプロトタイプが代行するわけではありません。

チャットでコードについて質問するだけなら、DeepSeek Harness や別のコーディングアシスタントのほうが簡単です。ターミナルでのコーディング対話については当サイトのDeepSeek-TUIを参照できます。別種の複数ステップエージェントは、研究や実行のオーケストレーションを重視する場合があります。入口、権限、実行方法はそれぞれ異なります。

リクエストが実行タスクになるまで

公式のドメインモデルは Source、Trigger、Thread、Eval、Ticket、Mandate、Assignment、Executor、Channel に分かれています。簡単に言えば、メッセージを受け取り、受理するか判断し、作業票を作り、実行を割り当て、結果を返す流れです。

1
2
3
4
5
6
7
8
9
Source(GitHub / 任意の Feishu)
    └─ Trigger(イベントまたはメッセージ)
         └─ Thread(関連する議論の文脈)
              ├─ Eval(新しい作業依頼かを判定)
              │    ├─ 受理 → Ticket(Mandate 付き作業票)
              │    └─ 無視 / 利用不可 → 記録
              └─ Ticket が購読する文脈の更新
                   └─ Assignment → Executor(個別 DSH セッション)
                        └─ Channel(結果を Source へ返す)

Source と Trigger:入口とイベントを区別する

Source は GitHub リポジトリや有効化した Feishu 接続など、メッセージの送信元です。Trigger は Source が生成した個別のイベントです。Issue、コメント、チャットのメッセージが Trigger になる場合はありますが、メッセージが届いただけでコード実行が必要とは限りません。

この区別により、入口ごとに認証とポリシーを管理できます。接続するリポジトリや会話、イベントの検証方法、重複配信の扱いを確認してください。すべての webhook を信頼できる命令として扱うと、意図せず権限を広げてしまいます。

Thread と Eval:文脈をまとめ、受理を判断する

Thread は関連する文脈をまとめます。新しいイベントは、すでに購読している Ticket のスレッドに追加される場合と、新規作業かどうかを Eval が判断する場合があります。無視または処理不能なイベントも記録でき、雑談が自動的にタスクへ変わるのを防ぎます。

チームが決めるべきなのは、誰がエージェントに依頼できるかです。原則文書は、明示的な許可リスト、またはチームが依頼を受け付けると定めた会話を挙げています。実際の範囲はチームが定義します。GitHub や Feishu に対応しているからといって、すべてのリポジトリ利用者やグループ参加者に同じ権限があるわけではありません。

Ticket と Mandate:権限をタスクに結び付ける

Eval が新しい依頼を受理すると、Mandate を持つ Ticket を作成します。Mandate は作業の範囲と根拠を表し、実行側に単独のコメントだけでなく、関連する文脈とポリシー上の制約を渡します。

確認する際は、依頼とポリシーから Mandate がどう作られるか、どのイベントが Ticket を作るか、進行中の作業にポリシー変更がどう届くかを調べます。コードが生成できるかだけでなく、依頼が受理された理由と、権限が実作業を制限しているかを確認してください。

Assignment と Executor:各タスクを個別セッションへ渡す

Assignment は Ticket を Executor に渡します。リポジトリでは個別の DSH セッションで実行すると説明されています。セッション単位で作業が分かれ、状態や結果を確認しやすくなります。ただし、完全なコンテナサンドボックスや強固なセキュリティ分離があるという証明ではありません。分離されるディレクトリ、プロセス、認証情報、ネットワーク能力は、実際の DSH 設定と環境で確認してください。

プロジェクト文書には profile、待ち受けポート、ブランチ接頭辞などの既定値も記載されています。既定値は導入の参考であり、どの環境でも安全だという保証ではありません。既存の DSH 設定、ポート競合、作業ディレクトリ、profile がアクセスできるリポジトリを確認してください。

Channel:依頼元へ結果を返す

Channel は実行結果を Source に返します。プロジェクト原則では、依頼を確認した後の進捗通知を減らし、結果が出たとき、人の判断が必要なとき、続行できないときに再度連絡する方針です。結果を誰が読めるか、失敗情報にパスや機密情報が含まれるかも確認してください。

GitHub と Feishu の入口を設計する

GitHub 入口では、リポジトリの Issue、コメント、合意したイベントを作業依頼にできます。要件、コード変更、レビューを同じ協業文脈に残せるのが利点です。一方、GitHub の本人確認、リポジトリ権限、イベントの送信元、エージェントによる変更のレビューを管理する必要があります。

Feishu はチームの会話から依頼を受けるための任意の入口です。自然言語の文脈が豊富な反面、グループ内で誰が依頼できるか、転送メッセージは許可とみなされるか、会話から特定リポジトリへアクセスできるかなど、権限の境界が曖昧になりがちです。チャットボットを接続しただけで組織全体にコード実行を許可しないでください。

まずは入口を一つだけ有効にし、使い捨てのテストリポジトリ、明確な依頼者リスト、結果の保存場所を用意します。入口が増えるほど、本人確認の対応付け、重複排除、拒否動作、監査経路の検証も増えます。入口に対応していることは、本番運用が成熟していることを意味しません。

最初に observe モードを使う理由

自動トリガーや信頼が確立していないフローでは、SETUP は observe モードから始めるよう案内しています。イベントがどう認識され、何をする予定かを確認しつつ、実行による副作用を避けられます。

無害な例で確認します。許可された人からの明確な依頼、許可リスト外の人からの依頼、無関係なコメント、重複 webhook、リポジトリ文脈のないメッセージを試します。受理すべき依頼が Ticket になり、禁止した依頼は無視または記録され、判定理由を確認できるかを見ます。

予定動作が記録されたことを安全の証明と考えてはいけません。テストを見落としたり、権限を誤解したり、悪意あるリポジトリ内容に従ったりする可能性があります。実行前にツール権限、ワークスペース分離、ネットワークと認証情報へのアクセス、人によるコードレビューを確認してください。

設定と権限を確認する

コードリポジトリにアクセスするため、最初の試験は最小権限から始めます。公式 SETUP は、必要な権限だけを持つ専用の GitHub agent アカウントを推奨しています。個人の日常的な管理者アカウントと分け、資格情報を失効・ローテーションする方法も準備してください。

モデルの認証情報、GitHub のログイン情報、Feishu アプリの秘密情報をチャットに貼ったり、リポジトリにコミットしたりしないでください。SETUP は、ログインやアプリ秘密情報の入力が必要な手順を、操作者自身の端末またはアプリで行うよう求めています。現在の資格情報の保存方法とファイル権限を確認し、共有ワークスペースに読める秘密情報を置かないでください。

次の項目を順に確認します。

  1. 本人確認:どの GitHub ユーザーや Feishu 会話がタスクを作れるか。認証に失敗した場合はどうなるか。
  2. リポジトリ範囲:agent アカウントがアクセスできるリポジトリ、ブランチ、組織リソースは何か。テスト用から始められるか。
  3. 書き込み権限:直接 push、ブランチ作成、Pull Request 作成が可能か。すべて人がレビューするか。
  4. 実行分離:DSH セッションのディレクトリ、プロセス、認証情報は分離されるか。ホスト上の他ファイルへアクセスできるか。
  5. ネットワーク:任意の宛先へ接続できるか。依存関係の導入やビルドで何のコードが実行されるか。
  6. 監査:Trigger から Ticket、Assignment、実行結果、返信まで追跡できるか。ログに秘密情報が残らないか。
  7. 停止方法:リスナー停止、GitHub 権限失効、Feishu 無効化、実行中セッション終了をどう行うか。

回答を得てから、観察から実行へ移るか判断します。専用アカウントだけでは、ワークスペースや資格情報が分離されている証明にはなりません。

初期評価に必要な環境

現在のリポジトリ文書では Node.js、pnpm、Git、tmux、Python、GitHub CLI、対応する DSH などが依存要件として挙げられています。パッケージ情報は新しい Node バージョンも要求しています。バージョン、alpha 依存関係、導入手順は変わるため、古い記事のコマンドをそのまま実行しないでください。

試す場合は、現在の README と SETUP を読み、リンクされた原則文書も確認してください。SETUP では導入を意図的に制限しています。指定文書を読み、一度環境を調査して回答を集めてから計画を作ります。操作者が計画を確認するまでは実行しません。これにより、資格情報の取得や環境変更を早まるリスクを抑えられます。

テスト環境では、少なくとも次を確認してください。

  • 実行するユーザー環境で Node、pnpm、Git、tmux、Python、gh、dsh を呼び出せる。
  • gh は専用 agent アカウントで認証され、個人の高権限アカウントを誤用していない。
  • 選んだ DSH profile が既存設定と衝突せず、ポートと作業ディレクトリがローカル方針に合う。
  • 対象リポジトリはテスト専用で、内容を破棄または復元できる。
  • モデルと認証情報の提供元がチーム要件に合い、秘密がメッセージやログに出ない。
  • 本人確認とアプリ権限をレビューするまでは、任意の Feishu 連携を無効にする。

不明な項目があれば、文書確認または観察にとどめてください。動作させるためだけに組織権限を広げたり、個人の秘密情報を渡したりしないでください。

評価に向くタスク

初回は影響が小さく、確認しやすい作業を選びます。たとえばテストリポジトリの明確な Issue を説明する、小さなドキュメントを補う、範囲を限定した修正案を作るといった内容です。変更可能な場所、触れてはいけないディレクトリ、必要なチェック、成果物の返し方を指定します。

本番デプロイ、権限管理、依存関係更新、データ移行を最初の試験にしないでください。エージェントに自分の変更を承認またはマージさせないでください。評価目的は自動化率ではなく、全体の流れを理解、レビュー、中止できるかの確認です。

試験後は、依頼、判定、Mandate、実際の変更、テスト結果、返信を照合します。範囲を超えて実行した場合は、再試行の前にポリシーと境界を修正します。

よくある問題と調査方法

メッセージを送ってもタスクが作られない

Source が接続されているか、イベントが届いたか、依頼者がポリシーに合うか、新規作業と認識されたかを確認します。該当 Thread や記録で、無視、利用不可、文脈不足と判定されていないか調べます。受理問題の解決として全員に管理者権限を付与しないでください。

Ticket はできたが実行されない

Ticket に実行可能な Mandate があるか、Assignment が作成されたか、Executor と DSH profile が使えるかを確認します。次に実行環境の依存関係とセッションログを調べます。受理は依頼がタスクになったことを示すだけで、実行環境の準備完了を意味しません。

関係ないファイルが変更された

後続の自動作業を停止し、調査用にログと diff を保存します。タスクが使ったリポジトリ、ワークスペース、文脈、許可パスを確認してください。分離が不十分なら、まず書き込みを無効にするか資格情報を失効させます。プロンプトでの注意喚起はシステムのパスや権限管理の代わりになりません。

重複イベントで作業が重複する

Source のイベント ID、Thread の分類、購読状態、同一依頼に対する Ticket の有無を確認します。この版のリトライと重複配信の扱いを確認し、使い捨てのイベントで検証してください。重複を隠すために監査記録を削除しないでください。

GitHub または Feishu に結果が戻らない

Executor の最終状態、Channel の紐付け、Source の返信権限を追って確認します。未完了と、完了したが通知に失敗した状態を区別し、失敗時の代替経路を調べます。返信失敗で結果が失われないよう、ログや Ticket から検索できる状態にします。

模擬リクエストで全体を確認する

実際のリポジトリを接続する前に、破壊的変更のないリクエストで各段階を確認します。以下は設計の説明用であり、対応コマンドや内蔵テスト機能が存在するという意味ではありません。

1
2
3
4
依頼者:許可リストにある開発者
Source:使い捨てテストリポジトリの Issue
依頼:src/parser.ts の境界条件だけを説明し、ファイルは変更しない
期待結果:文脈を記録し、読み取り専用の分析を根拠とともに返信する

正しい Source からの Trigger になり、Thread に Issue の題名と関連コメントが入り、Eval が許可された依頼と判断したかを確認します。実行用 Ticket しか表現できず読み取り専用を強制できない場合、自然言語だけで読み取り専用になると考えず、権限層で書き込みを制限してください。

次に Ticket の Mandate に「説明のみ、変更しない」が残っているかを確認します。Assignment の Executor と、セッションが読み書きできるパスを調べます。完了後、Channel の返信に結論、ファイル位置、失敗情報が含まれ、環境変数やローカルパスを漏らしていないか確認します。

各段階の証拠として、イベント ID、判断結果、Ticket 識別子、ポリシー版、実行セッション、最終メッセージを記録します。観測できない段階は内部動作を正しいと仮定せず、試験上のリスクとして扱います。

リクエスト境界の反例

「関連箇所もまとめて直して」のような曖昧な依頼も試します。Eval は受理前に範囲を尋ねるでしょうか。Mandate に対象ディレクトリ、チェック、成果物を定義できるでしょうか。できないなら、エージェントに範囲を広げさせず、人の確認まで保留します。

許可リストにないアカウントから同じ依頼を送ります。期待する動作は受理拒否または記録のみで、Executor は割り当てません。拒否経路は専用リポジトリと架空の内容で試し、本物の資格情報を使い回さないでください。

Thread 作成後にコメントを追加し、元の Ticket の文脈更新になるか、新規タスクと誤判定されるか確認します。同じイベントを再送しても、同じワークスペースへ同時に書き込む Ticket が二つ作られないか検証します。

評価記録を残す

初回評価の版または日付、テスト環境、有効にした入口、許可リスト、権限範囲、停止手段を簡潔に記録します。依存関係やプロトタイプを更新した後も、記憶に頼らず挙動を比較できます。

各例について入力、期待結果、実際の結果、証拠の場所を記録してください。少なくとも次を確認します。

  • 許可された依頼が正しい Thread に入り、明確な Mandate を持つ。
  • 未許可ユーザーが作業を割り当てられず、拒否を監査できる。
  • 無関係なメッセージがコード作業に昇格しない。
  • 重複イベントで書き込みタスクが密かに増えない。
  • DSH が利用できない場合、成功を装わず Ticket に追跡可能な失敗が残る。
  • エージェントの diff とテスト結果を人が独立して確認できる。
  • 通知失敗後も結果を見つけられ、補償として再実行しない。
  • 入口を無効化または資格情報を失効した後は、新しいイベントで実行を始められない。

これらはその環境で試した例の結果にすぎず、すべての入力に対する安全性の証明ではありません。リポジトリにプロンプトインジェクション、悪意あるビルドスクリプト、資格情報を読む hook がないか特に確認します。コードエージェントは一般にリポジトリの内容を信頼できない入力として扱うべきです。

合格基準を外から確認できる形にする

「エージェントが依頼を理解した」は測りにくい表現です。許可依頼で想定どおりの Ticket が作られる、禁止依頼に Executor が割り当てられない、Mandate が許可範囲と一致する、出力をセッションまで追跡できる、マージ前に人が変更を確認できる、運用者が停止してアクセスを失効できる、といった条件のほうが確認しやすくなります。

権限を広げる前にこれらを条件にしてください。検証できない分離の保証は未確認のままです。プロジェクト名や設定コメントから成立を推測しないでください。

本サイトの関連テーマとの違い

SuperAgent は複数ステップのタスクエージェントを指す広い呼び方で、単一の製品名ではありません。長期タスクエージェントはローカルでの調査や実行のオーケストレーションを重視する場合があります。DeepSeek-TUI はターミナルでのコーディング対話とツール利用を扱い、dsh-superagent-prototype は協業ツールからの依頼をポリシー経由で独立実行タスクにする流れが中心です。

比較ではモデル名だけでなく、ワークフロー、入口、実行環境、成熟度を見ます。どちらもコードエージェントを呼び出していても、イベントトリガー、本人確認ルール、セッションのライフサイクル、運用責任は異なることがあります。

チームの課題が個人の対話型コーディングなら、まずターミナルツールを試します。調査や長期タスクの編成なら DeerFlow の境界を確認します。リポジトリの会話を監査可能な Ticket に接続したい場合に、この試作版を詳しく調べる価値があります。

どのような人が調査に向くか

イベント駆動のコードエージェントがチーム依頼を制御されたタスクに変える仕組みを研究する開発者やプラットフォームエンジニア向けです。読みやすいドメイン概念、ポリシーの入口、実行フローは、権限、通知ノイズ、人との引き継ぎを議論する材料になります。

すぐに安定した企業向け自動化サービスが必要な場合や、レビューなしに本番リポジトリへ継続的に書き込ませたい場合、この試作版をその役割に使うべきではありません。コードと依存関係を調べ、隔離環境で試し、監視、更新、バックアップ、インシデント対応をチームの要件に合わせて整えてください。

まとめ

dsh-superagent-prototype の主眼は「DeepSeek が別の自律コーディング製品を出した」ということではありません。外部メッセージ、権限ポリシー、Ticket、個別 Harness 実行を追跡可能な流れにする試みです。研究用プロトタイプであり、コードと権限が自分の環境に適切かは導入者が判断します。

さらに調べる場合は、公式 README、SETUP、理念文書、ドメインモデルの順で読んでください。まず最小のテストリポジトリでイベント判定を観察し、分離と権限を確認してから、限定的な実行を検討します。

関連リソース