QoderWake CN を使用すると、ローカルマシン上に Waker と呼ばれるデジタル従業員のチームを構築できます。各 Waker は、特定のロール、名前、ペルソナ、スキルセットを持っています。チャットを通じて対話したり、タスクを割り当てたり、スケジュールやイベントに応じて自動的に作業させたりすることができます。Waker の機能、ツール、メモリ、権限はすべて完全に設定可能です。
このガイドでは、QoderWake CN をゼロからセットアップする方法について説明します。ツールのインストール、コンソールの起動、最初の Waker の作成、タスクの割り当て、チームの管理までを網羅しています。
プロダクト理念：24時間365日稼働するデジタル従業員、「常に覚醒し、常に働く」
プロダクトの特長：安全で制御可能、本番環境に対応、継続的に進化
基本概念：ロール → エージェント → エージェントチーム
初期ロール：バックエンドエンジニア、フロントエンドエンジニア、テストエンジニア、プロダクトマネージャー、データアナリスト、コンテンツオペレーション。さらに、カスタムロールの作成もサポートしています。
どのロールが必要ですか？
現在の招待制ベータ版には、以下のロールが含まれています。ニーズに最も合うものを選択してください。
ロール | 説明 |
バックエンドエンジニア | API 開発、データモデリング、サービス統合、パフォーマンス最適化、オンライン安定性を専門とします。インクリメンタルデリバリー、テスト検証、規則第一の設計などのエンジニアリングプラクティスに従います。エージェントはバグや issue を自動的に分析し、コードを修正して PR を提出します。 |
フロントエンドエンジニア | フロントエンド UI の設計と実装に重点を置きます。コンポーネントアーキテクチャ、ビジュアル言語の洗練、レスポンシブデザイン、アクセシビリティ最適化、パフォーマンスチューニングに優れています。インクリメンタルデリバリー、階層的検証、証拠に基づく検証を遵守し、ユーザーエクスペリエンスとエンジニアリング品質のバランスを取ります。 |
テストエンジニア | 一般的なコマンドラインツールや Web プロダクトの品質保証を提供します。テスト計画書の作成、エンドツーエンドテストの実施、不具合の再現、証拠に基づくレポートの生成に重点を置きます。単体テストの実行や問題の修正は行いません。 |
プロダクトマネージャー | ソフトウェアプロダクト向けの AI ネイティブなプロダクトマネジメントロールです。目標駆動型のフルライフサイクル要件管理、PRD (製品要求仕様書) の生成、ユーザーフィードバック分析、競合調査、リリースに関するコミュニケーションに重点を置きます。外部への書き込み操作には明確な承認ゲートを設定します。 |
データアナリスト | AI ネイティブなデータアナリストで、問題の明確化、メトリクスの定義、DingTalk ドキュメントやスプレッドシートからの MCP に基づくデータ収集、データ診断、市場コンテキスト分析、証拠に基づく推奨事項に重点を置きます。 |
コンテンツオペレーション | AI ネイティブなコンテンツオペレーションロールで、アカウントのポジショニング、トレンドの洞察、コンテンツカレンダー管理、Xiaohongshu (小紅書) の投稿作成、ビジュアル素材のブリーフィング、承認後の公開、コメントへの対応、パフォーマンスレビュー、ブランドコンプライアンスの確保、コンテンツのマルチプラットフォーム展開に重点を置きます。 |
カスタム | ロールのワークフローと働き方を自分で定義します。MCP やスキルなど、任意の構成をアタッチできます。 |
環境準備
QoderWake CN は、ローカルデプロイメントとクラウドデプロイメントの両方をサポートしています。24時間365日の最適な運用を実現するため、専用のローカルマシンやクラウドデスクトップなど、常時稼働し、安定したネットワーク接続を持つデバイスへのデプロイを推奨します。
Windows 版はまだ公開されていませんが、近日中にリリース予定です。現時点では、macOS または Linux で QoderWake CN をご利用ください。
ローカルデプロイメント
信頼性の高い24時間365日の運用を確保するため、Mac mini のような安定して長時間稼働するローカルデバイスへのデプロイを推奨します。
macOS：13.0 以降。
Linux：Ubuntu 22.04 LTS 以降を推奨します。ローカルの Web コンソールを使用するには、GUI デスクトップ環境が必要です。
クラウドデプロイメント
主要なクラウドデスクトップおよびクラウドサーバー環境をサポートしています。ブラウザベースの便利なログインとローカル Web 管理のため、Elastic Desktop Service (Enterprise 版または Personal 版) の利用を推奨します。
Linux：Ubuntu 22.04 以降。ローカルの Web コンソールを使用するには、GUI デスクトップ環境が必要です。
前提条件
このプロダクトには、ソフトウェア開発用に事前設定されたいくつかのデジタル従業員のロールが付属しています。インストールする前に、Git 環境がセットアップされており、ご利用のユーザーアカウントがターゲットのコードリポジトリにアクセスできることを確認してください。
gitがインストールされていること。リポジトリの認証が設定されていること。
clone、pull、push操作を正常に実行できること。
ローカルおよびクラウドのデプロイメント環境では、ユーザーログイン、AI モデルの呼び出し、コードリポジトリへのアクセスなどの機能のために、外部ネットワークへのアクセスが必要です。企業ネットワーク、プロキシ、またはファイアウォールの内側にいる場合は、必要なアウトバウンドの HTTPS トラフィックが許可されていることを確認してください。
ステップ 1：QoderWake CN のインストール
macOS
QoderWake CN 公式サイト にアクセスして、インストールパッケージをダウンロードします。
または、ターミナルを開いて次のコマンドを実行します。
curl -fsSL https://ide.qoder.com.cn/qoderwake-cn/install.sh | bashこのスクリプトは、プラットフォームを自動的に検出し、インストールパッケージをダウンロードして検証し、メインプログラムとリソースファイルをインストールします。さらに、コマンドエントリポイントを PATH に追加し、ブラウザを起動してログインを促し、ローカルのバックグラウンドサービスを開始して、Web コンソールを開きます。コマンドエントリポイントは ~/.qoderwake-cn/bin/qoderwake です。
Linux
ターミナルを開いて次のコマンドを実行します。
curl -fsSL https://ide.qoder.com.cn/qoderwake-cn/install.sh | bashインストールスクリプトは、自動的に以下の処理を行います。
Linux の CPU アーキテクチャを検出します。
ご利用のプラットフォーム用の QoderWake CN インストールパッケージをダウンロードして検証します。
QoderWake CN のメインプログラムとリソースファイルをインストールします。
コマンドエントリポイントを作成し、
PATHへの追加を試みます。ブラウザを起動してログインを促します。
ログイン後、ローカルのバックグラウンドサービスを開始または再起動します。
ローカルの Web コンソールを開きます。
コマンドエントリポイント：
~/.qoderwake-cn/bin/qoderwake-cnデフォルトの Web コンソールアドレス：
http://127.0.0.1:19830Windows
Windows 版は近日中にリリース予定です。正式リリース後、このページは更新されます。
ステップ 2：コンソールの起動
ブラウザを開き、http://127.0.0.1:19830/ にアクセスします。これは QoderWake CN のローカル管理コンソールで、Waker の管理、タスクの割り当て、権限の設定ができます。
インターフェイスの概要：
左サイドバー：「マイ Waker」リストが表示され、作成済みのすべての Waker とその最終アクティビティ時刻が示されます。
上部ボタン：「Waker の作成」をクリックして新しい Waker を追加します。右上で新しいタスクを作成できます。
メインエリア：Waker を選択すると、デフォルトでチャットインターフェイスが開き、直接タスクを割り当てることができます。
右サイドバー：作成済みのタスクや現在実行中のタスクの詳細を表示します。
初めてアクセスすると、ログインを求められます。画面の指示に従ってプロセスを完了してください。
ステップ 3：Waker の作成
左側の [Waker の作成] ボタンをクリックします。
ロールテンプレートの選択：各ロールテンプレートには、事前定義されたペルソナ、典型的なワークフロー、コアスキルセット、デフォルトのプロンプトが付属しています。「詳細を表示」をクリックしてプレビューできます。
またはカスタムロールの作成：事前設定されたロールがニーズに合わない場合は、「カスタムロール」を選択します。Waker のペルソナ、専門知識、働き方をゼロから定義し、スキル、コネクター、権限を設定できます。
基本情報の入力：Waker の名前、アバター、プロフィールを入力します。事前設定されたロールを選択した場合、この情報は自動的に入力されますが、必要に応じて編集できます。
保存：[保存] をクリックして Waker を作成します。Waker を作成すると、オンボーディングガイドが表示され、追加すべきスキルや接続すべきチャンネルが提案されます。これはスキップして後で設定することもできます。
カスタムロールで最良の結果を得るには、作成時に包括的な情報を提供してください。これには、ロールのポジショニング、主な責務、ワークフロー、必要なスキル、MCP 構成などのツール機能が含まれます。
ステップ 4：Waker との作業開始
Waker を作成した後、対話型タスクを開始するか、自動タスクを作成することができます。
対話型タスク
入力ボックスにリクエストを入力して送信します。Waker がタスクの作業を開始します。このプロセス中に、以下の操作が可能です。
フォローアップの質問や方向性の修正：いつでも介入でき、Waker はコンテキストに基づいて作業を続行します。
ファイルやスクリーンショットの添付：会話のどの時点でも添付ファイルを追加できます。
中断：Waker が脱線した場合に停止させます。
操作の承認：Waker がファイルの変更、コマンドの実行、インターネットへのアクセスを必要とする場合、一時停止して承認を求めます。[許可] または [拒否] をクリックします。
Waker の質問に回答：選択が必要な場合、Waker は入力を促します。表示されたカード上で直接選択します。
AI モデルの切り替え：現在のモデルのパフォーマンスが低い場合やコストを削減したい場合、上部のドロップダウンメニューから別のモデルに切り替えて会話を続けることができます。
思考プロセスの表示：Waker が決定を下す前の推論をリアルタイムで確認できます。
アーティファクトの表示：右側のパネルには、コードパッチや新しいファイルなど、Waker が生成した出力がリアルタイムで表示されます。
作業ディレクトリの選択：チャットの下部で、Waker が操作するローカルディレクトリを選択できます。
自動タスク
自動タスクは、「1日1回実行」や「リポジトリの変更に自動的に応答する」といったシナリオに最適です。
[Waker 詳細] → [トリガータスク] → [新規] に移動して、以下を設定します。
タスク名と説明：Waker が何をすべきかを理解するのに役立ちます。
AI モデル：使用するモデルを選択します。
作業ディレクトリ：タスクが実行されるローカルディレクトリ、リポジトリ、またはプロジェクトワークスペース。
トリガーメソッド (最大5つ、組み合わせ可能)：
スケジュール実行：1回限り、定期的、または複雑なスケジュール (例：毎日午前9時、毎週月曜日、毎月1日) で実行します。
イベント駆動：GitHub リポジトリの issue、PR、またはコメントの変更をリッスンします。
最大実行回数 / 終了日 (オプション)：タスクが無期限に実行されるのを防ぎます。
保存後、Waker はスケジュールに従って自動的に実行されます。いつでもタスクを一時停止または有効化したり、テストのために即時実行したり、実行履歴を表示したりできます。
ステップ 5：Waker の管理
Waker の詳細ページに移動して、その構成を表示および調整します。
セクション | 説明 |
ホーム | Waker のアバター、ステータス、作成からの日数、トリガータスク数、対話型タスク数、アクティビティヒートマップを表示します。 |
プロジェクト | Waker が作業するコードリポジトリまたはローカルディレクトリをバインドします。1つのプロジェクトには複数のソース (ディレクトリまたはリポジトリ) を含めることができます。プロジェクトのメモリは、Waker 個人のメモリとは別に管理されます。 |
トリガータスク | この Waker の自動タスクを追加、削除、変更、または一時停止します。 |
対話型タスク | 過去の会話を確認し、チャットを続行します。 |
メモリ | Waker があなたやプロジェクトについて持つ長期的な知識を表示および編集します。メモリは、会話中の自動キャプチャ、手動編集、定期的なシステムレビューと重複排除によって蓄積されます。すべてのメモリはローカルに保存され、クラウドにはアップロードされません。 |
スキル | 公式の Qoder CN スキルマーケットプレイスから新しいスキルをインストールしたり、ローカルマシンからカスタムスキルをアップロードしたり、既存のスキルを有効または無効にしたりします。組み込みスキルはアンインストールできません。 |
コネクター | GitHub、Jira、GitLab などの外部ツールやサービスと統合します。 |
権限 | ツール保護：組み込みのセキュリティルールに基づいてツールパラメーターを検証し、コマンドインジェクション、リソースの不正使用、コード実行、ネットワークの不正使用、機密ファイルへのアクセス、権限昇格などの脅威を防ぎます。ファイル保護：ローカルファイルへの読み取りおよび書き込みアクセスを制御します。組み込みツール：各組み込みツールに対して「許可 / 確認 / 拒否」ポリシーを設定します。高リスク操作の場合は、承認カードが表示されます。 |
Waker の構成
メモリ管理
各 Waker は、あなたやそのプロジェクトに関する知識を蓄積するための独自の長期記憶を持っています。メモリは3つのソースから得られます。
自動キャプチャ：Waker は会話から重要な情報を自動的に保存します。
手動入力：メモリページに移動して、エントリを直接編集できます。
システムレビュー：システムは定期的にメモリエントリを整理し、重複排除します。
[Waker 詳細] → [メモリ] に移動して、すべてのメモリエントリを閲覧、検索、編集します。メモリはローカルに保存され、クラウドにはアップロードされません。
スキル
スキルは、Waker が対話型タスクまたは自動タスク中に使用できる専門的な機能パッケージです。
スキルマーケットプレイス：公式の Qoder CN スキルマーケットプレイスからインストールします。
スキルのアップロード：ローカルマシンからカスタムスキルをインポートします。
組み込みスキル：システムに付属しており、アンインストールできません。
[Waker 詳細] → [スキル] に移動して、インストール済みのスキルを表示したり、マーケットプレイスを検索したり、カスタムスキルをアップロードしたりします。
コネクター
コネクターは、Waker を外部のツールやサービスに接続するブリッジです。コネクターは手動で追加できます。
プロジェクト
プロジェクトは Waker のワークスペースを定義します。[Waker 詳細] → [プロジェクト] に移動して、以下の操作を行います。
ローカルディレクトリまたは Git リポジトリをバインドします。
1つのプロジェクトには複数のソース (ディレクトリまたはリポジトリ) を含めることができます。
プロジェクトには、Waker 個人のメモリとは別の独自のメモリがあります。
権限管理
権限は、Waker ができることとできないことを制御します。[Waker 詳細] → [権限] に移動して、2つの主要な保護カテゴリと、組み込みツールのポリシーを設定します。
ツール保護：組み込みのセキュリティルールに基づいてツールパラメーターを検証します。高リスクのルールがトリガーされた場合、ユーザーの権限付与を要求します。ルールのカテゴリは次のとおりです。
コマンドインジェクション：
rmやmvなどの危険な操作を検出します。リソースの不正使用：フォーク爆弾、システムの再起動などの脅威を検出します。
コード実行：
curl | bashなどのリモート実行パターンを検出します。ネットワークの不正使用：リバースシェルやローカルループバックアクセスを検出します。
機密ファイルへのアクセス：重大なシステムファイルへのアクセスを検出します。
権限昇格：
sudoの使用などの権限昇格の試みを検出します。
ファイル保護：Waker のローカルファイルへの読み取りおよび書き込みアクセスを制御します。
組み込みツール：Waker が利用できる各組み込みツールに対して、許可 / 確認 / 拒否ポリシーを設定します。
Waker のアクションがセキュリティルールに抵触すると、承認カードが表示され、操作を許可または拒否できます。
例：バグの自動修正
この問題には2つの方法でアプローチできます。
方法 A：手動で対話を開始する：コンソールを開き、バックエンドエンジニアのロールを持つ Waker を選択します。チャットボックスに「このエラーの根本原因を突き止め、最小限の修正を提供してください」と入力し、エラーメッセージを添付します。Waker は問題を分析し、根本原因を特定して、解決策を提案します。確認すると、修正を適用し、PR を提出します。コマンドの実行やファイルの変更前には、承認を求められます。
方法 B：自動タスクを設定する：[Waker 詳細] → [トリガータスク] → [新規] に移動します。トリガーメソッドとして「イベント」を選択し、GitHub リポジトリの issue の変更をリッスンするように設定します。タスクの説明には、「新しいバグ issue が作成されたら、自動的に分析し、修正を含む PR を作成してください」と記述します。保存後、リポジトリに新しいバグ issue が現れるたびに、Waker は自動的に分析と修正プロセスを開始します。
フィードバック
問題が発生した場合や、プロダクト機能に関する提案がある場合は、コンソールの右下隅にある フィードバック ボタンをクリックして送信してください。いただいたフィードバックには迅速に対応いたします。