dsh-superagent-prototype

1. プロジェクト概要

dsh-superagent-prototypeは、単一のGitHubリポジトリに対する認可済みのリクエストを追跡可能な作業に変換し、各タスクを専用のDeepSeek Harnessセッションとディレクトリで実行して、結果を元の会話に返すオープンソースのTypeScript製コーディングエージェントプロトタイプです。リポジトリREADME

2. 背景と位置づけ

本プロジェクトは、DeepSeek Harnessチームの日常的な開発作業から生まれました。その使命は、チームメンバーからの注意を最小限に抑えつつ、有用なエンジニアリング成果を届けることです。作業は明示的なリクエストまたは文書化されたチームルールを通じて開始され、コミュニケーションは実行可能な質問と使用可能な結果に焦点を当てます。設計思想

際立った特徴は、持続的なチームワークフローに重点を置いている点です。リクエスト、認可、実行、フォローアップ、納品が、1つのリポジトリを中心にまとめてモデル化されています。このため、対話型のコーディングセッションを超えたリポジトリエージェントを探求する開発者にとって有用ですが、本プロジェクトは比較性能のベンチマークを公開していません。ドメインモデル

メンテナは、これを公式のDeepSeek製品や本番運用可能なサービスではなく、研究用コードであると明言しています。公開プロトタイプは内部実装や付随する研究記事とは異なり、その記事で論じられているアイデアの一部は今後の方向性として残っています。プロジェクトの状態

3. 機能カテゴリ

以下の件数は、各カテゴリに列挙された具体的な機能またはリソースを表すものであり、公式な総機能数を示すものではありません。

コラボレーションとイベント取り込み

🔌 リポジトリとチャットの入力 — 代表的な機能4件

• 設定されたリポジトリに対するGitHub通知の取り込み。
• 任意のFeishu/Larkボット連携。
• 既存の作業にフォローアップの文脈を届けるスレッド購読。
• リクエストに関連付けられた会話へのチャネルベースの返信。

目的: チームの会話を実行可能な作業に結びつけつつ、それを継続するために必要な文脈を保持すること。ドメインモデル

認可と自発的な作業

🛡️ ポリシー制御 — 代表的な機能5件

• 各ソースに対する許可送信者リスト。
• スコープ、送信者のメンバーシップ、エージェントが宛先になっているかどうかに基づく受付テーブル。
• 推測された自発的リクエストに対する文書化されたルール。
• 3つの受付モード: オフ、観察、自動。
• 作業がどの権限の下で受け入れられたかを記録するチケットマンデート。

目的: 作業を開始する許可と、単に文脈を提供するだけのメッセージとを区別すること。認可ガイド

タスク実行

⚙️ 実行ライフサイクル — 代表的な機能4件

• 各チケットに対する専用の実行者セッション。
• Gitワークツリーを含む、タスクディレクトリ用の設定可能な準備コマンド。
• ワーカーの同時実行数とモデル設定。
• 中断された割り当ての復旧と再試行の処理。

目的: 作業項目を実行ターンや再起動をまたいで独立して追跡・管理できるようにすること。実行ガイド

人による監督

📊 オペレータパネル — 6つのタブ、代表的な例5件

• 概要タブは、人による対応が必要な作業を強調表示します。
• ソースタブは、連携の健全性と配信の問題を示します。
• トリガータブは、スレッド、受信イベント、購読を表示します。
• 評価タブは、判断、理由、一致したルールを記録します。
• 実行タブは、チケットの状態、ワーカーの活動、介入制御を公開します。

目的: 未処理の判断とワークフロー履歴を可視化すること。6番目のタブである設定では、ソース、評価、実行、プロンプト、デプロイを構成します。パネルガイド

カスタマイズと拡張

🧩 拡張リソース — 代表的なリソース4件

• 編集可能なチームプロンプトのセクション。
• 同梱のGitHubおよびFeishuスキル。
• DeepSeek Harnessプロファイル設定の例。
• 追加のソースプラグインを実装するためのクックブック。

目的: チームが指示とイベント連携を自らのリポジトリワークフローに適合できるようにすること。プロンプトガイド、ソースクックブック

4. 主なハイライト

• 自発的な実行を有効にする前に観察する。 デフォルトの観察モードは、推測された作業が受け入れられるかどうかを、作業を作成せずに記録するため、オペレータはまず自らのルールを評価できます。認可
• リクエストから結果まで追跡可能な作業。 トリガー、判断、チケット、割り当ては、エージェントが何を受け入れ、どのように進捗したかを理解するための共通の語彙を提供します。ドメインモデル
• 実行コンテキストの分離。 各チケットには独自のセッションと作業ディレクトリがあり、Gitワークツリーによって独立したリポジトリのチェックアウトを提供できます。これらはワークフローの境界であり、OSのセキュリティサンドボックスではありません。実行、デプロイ
• 注意を集中させる監督。 パネルはブロックされた作業と対応可能な問題を優先し、必要に応じて詳細な履歴を利用できます。パネル
• 拡張可能なイベントソース。 クックブックでは、イベントの変換、返信の配信、認可の統合、ソースのライフサイクル動作について説明しています。クックブック

5. 役割別のユースケース

以下は、文書化されたワークフローの潜在的な応用例であり、専用の組み込み機能を主張するものではありません。

役割	実用的な用途
一般開発者	リポジトリの会話から範囲を限定したバグ修正や機能作業を委任し、結果の変更やプルリクエストをレビューする。
DevOps/SRE	専用のエージェントプロファイルを運用し、健全性を監視し、リポジトリのCIイベントに対するルール認可の応答を試す。
セキュリティエンジニア	送信者の権限、実行資格情報、実行時の分離をレビューし、通常のリポジトリリクエストを通じて範囲を限定した修復作業を割り当てる。
データ/研究科学者	イベントのルーティング、ポリシー評価、タスクの復旧を研究する、または研究用リポジトリでのコード変更を委任する。
プロジェクトマネージャー	判断待ちのチケットをレビューし、要求された成果を明確にし、監督パネルを通じて作業を追跡する。

基盤となる仕組みは、ドメインモデル、パネルガイド、デプロイガイドに文書化されています。

6. はじめに

パス1: 必要なものを見つける

READMEから始め、次に9つの番号付きドキュメントを思想からソースクックブックまで順に読んでください。実装をナビゲートするにはアーキテクチャを、運用の詳細にはデプロイを参照してください。

パス2: インストールと統合

推奨される開始点は、エージェント支援によるSETUP.mdです。コーディングエージェントに次の指示を与えてください:

Read SETUP.md in this repository and set up dsh-superagent with me.

前提条件には、22.x系のNode.js 22.19以降またはNode.js 24以降、pnpm、Git 2.32以降、Python 3.8以降、tmux、GitHub CLI 2.48以降、github.com上のリポジトリ、およびDeepSeek Harnessで設定されたモデルプロバイダーが含まれます。Feishuにはさらにボットの設定とlark-cliが必要です。

既存のsuperagentプロファイルがない新規インストールの場合、デプロイガイドは次の手順を提供します(リポジトリURLは入力済みです):

npm install -g @deepseek-ai/[email protected]
git clone https://github.com/deepseek-ai/dsh-superagent-prototype.git dsh-superagent
cd dsh-superagent
pnpm install
pnpm build
dsh superagent --from-default-profile web --dump-config > /dev/null
dsh plugin --profile superagent add "link:$PWD"

プロファイル作成コマンドは既存のプロファイルを置き換えるため、アップグレードには再利用しないでください。開始する前に、残りのデプロイ手順に従ってください: 専用のエージェント用GitHubアカウントとCLI資格情報を設定し、プロファイル設定の例を記入し、ソース、ポリシー、実行、チームプロンプトを設定します。インストールコマンドだけではセットアップは完了しません。

パス3: 貢献する

動作を変更する前にアーキテクチャガイドを読んでください。連携を追加する場合は、ドキュメントとテストの要件を含むソース拡張クックブックに従ってください。

開発用チェックアウトから、リポジトリの型チェック、テスト、ビルドをまとめて実行します:

pnpm check

レビュー済みのツリーには独立したCONTRIBUTING.mdは含まれていません。提案する変更には、文書化された開発ワークフローとGitHubのプルリクエストインターフェースを使用してください。

7. プロジェクト構成

dsh-superagent-prototype/
├── README.md                  # Overview and documentation index
├── SETUP.md                   # Agent-assisted setup workflow
├── LICENSE                    # MIT license
├── docs/                      # Nine ordered design and operation documents
├── examples/
│   └── profile.cordis.patch.yml
├── prompts/                   # Agent instructions and team sections
├── skills/                    # GitHub and Feishu skills
├── locale/                    # English and Chinese interface resources
├── scripts/
│   └── dsh-superagent          # Service lifecycle helper
├── src/
│   ├── index.ts               # Bundle entry point
│   ├── core/                  # Domain engine and lifecycle rules
│   ├── app/                   # Runtime, storage, API, and orchestration
│   ├── executor/              # Harness execution adapter
│   ├── sources/               # GitHub, Feishu, and Source infrastructure
│   └── client/                # Web supervision interface
├── tests/                     # Domain, integration, and interface tests
├── cordis.patch.yml           # Bundle plugin configuration
└── package.json               # Dependencies, compatibility, and scripts

アーキテクチャはドメインルールを実行アダプターや連携アダプターから分離し、クライアントがオペレータ向けのパネルを提供します。ソースツリーとアーキテクチャガイドを参照してください。

8. 関連エコシステム

• DeepSeek Harness: エージェントセッション、ツール、モデル連携、Webインターフェースを提供するホストランタイムです。公式ホームページはランタイムのリポジトリと開発者ドキュメントにリンクしています。その汎用機能を、本プロトタイプが実装する機能と混同しないでください。
• Cordis: Harnessエコシステムと本バンドルの設定で使用されるプラグインアーキテクチャです。本プロジェクトのパッケージマニフェストに、HarnessとCordisの互換性要件が記載されています。
• GitHubとGitHub CLI: エージェントのIDとリポジトリ操作に使用される、リポジトリコラボレーションプラットフォームとコマンドインターフェースです。
• Feishu/Larkとlark-cli: リクエストの受信と返信の返却のための任意のチャット連携です。アカウントの設定はデプロイに文書化されています。
• Gitワークツリーとtmux: デプロイワークフローに示されているように、タスクのチェックアウトの準備とサービスプロセスの管理を行う補完的なツールです。

9. ライセンス

本リポジトリはMITライセンスを使用しており、著作権はDeepSeek Harness Teamに帰属します。

• ✅ 商用および私的利用、改変、複製、配布、サブライセンス、およびコピーの販売が許可されています。
• ✅ 改変版は、必要な通知が含まれている限り、あなたが選択した条件で配布できます。
• ❌ ソフトウェアのコピーまたは実質的な部分から著作権および許可の通知を省略することはできません。
• ℹ️ 本ソフトウェアは無保証で提供され、ライセンスは作者の責任を否認します。
• ℹ️ 本プロトタイプのライセンスは、外部サービス、モデルプロバイダー、依存関係の条件に代わるものではありません。

10. FAQ

Q: これは公式の本番運用可能なDeepSeekサービスですか?

A: いいえ。READMEはこれを参考用の研究プロトタイプと位置づけています。採用する前にその実装をレビューし、適合させてください。

Q: 自発モードとは、エージェントが任意の作業を開始するということですか?

A: 推測された作業には、設定された受付経路、評価、一致する文書化されたルール、および自動モードが必要です。観察モードは、実行せずに受け入れの可能性を記録します。明示的なリクエストは3つのモードすべてで利用できます。認可を参照してください。

Q: 1つのインスタンスで複数のリポジトリやGitHub Enterprise Serverを管理できますか?

A: 文書化されたスコープは1インスタンスにつき1つのGitHubリポジトリであり、デプロイにはgithub.comが必要です。GitHub Enterprise Serverは明示的に対象外です。デプロイを参照してください。

Q: ワーカーディレクトリは安全なサンドボックスですか?

A: いいえ。管理対象セッションはオペレータのOSユーザーとして完全なアクセス権で実行され、資格情報ラッパーはプロセスを分離せずにアカウントを選択します。分離が必要な場合、デプロイガイドはエージェントの資格情報のみを含む専用のOSアカウントを推奨しています。権限と分離を参照してください。

Q: Feishuは必須ですか? また別の連携を追加できますか?

A: Feishuは任意です。GitHubが中核となるリポジトリ連携であり、クックブックでは、ポリシー、文脈、配信動作を含む別のソースを実装する方法を説明しています。

11. クイックリンク

• プロジェクトリポジトリ
• READMEとプロジェクトの状態
• 公式プロジェクトドキュメント
• エージェント支援によるセットアップ
• 手動デプロイとトラブルシューティング
• 貢献ガイダンス: アーキテクチャと開発ワークフロー
• ソース拡張ガイド
• プルリクエストとコードレビュー
• DeepSeek Harnessホームページとコミュニティプラグインへのリンク
• MITライセンス

レビュー済みのREADMEには、独立した貢献ガイドや専用のプロジェクトディスカッションフォーラムへのリンクはありません。参加のための文書化された出発点として、リポジトリと上流のホームページを使用してください。

12. まとめ

dsh-superagent-prototypeは、リポジトリの会話、明示的な認可、持続的なタスク実行、人による監督を組み合わせるための具体的な参考例を世界中の開発者に提供します。リポジトリコーディングエージェントを研究し、DeepSeek Harnessエコシステムを拡張するチームや研究者にとって有用であり、その研究用実装は運用に供する前にレビューと適合が必要であることが想定されています。