メインコンテンツへスキップ

Documentation Index

Fetch the complete documentation index at: https://docs.qoder.com/llms.txt

Use this file to discover all available pages before exploring further.

QoderWake は、あなたのマシン上で「デジタル従業員」(Wakers)チームを編成できる製品です。各 Waker には役割、名前、ペルソナ、得意分野があり、必要に応じて呼び出して会話したり作業を任せたりできるほか、スケジュールやイベントに基づいて自律的に稼働させることもできます。使えるツール、保持する記憶、アクセスできるリソース、触れさせない領域はすべて構成可能です。 このドキュメントでは、ゼロから QoderWake を立ち上げる流れを案内します:インストール → コンソールを開く → Waker を作成 → タスクを割り当て → Waker を管理。 プロダクト理念:7×24 時間稼働するデジタル従業員、“Always awake, always working.” プロダクトの特徴:安全で制御可能、本番投入可、継続的に進化。 コアコンセプト:従業員の役割(Role)→ デジタル従業員(Agent)→ チーム / 組織(Agent Teams)。 初期ロール:バックエンドエンジニア、フロントエンドエンジニア、テストエンジニア、プロダクトマネージャー、データアナリスト、コンテンツオペレーター、加えて カスタムロール

どのロールの Waker が必要か

現在のベータでは以下のロールが利用できます。最も近いものを選んで作成してください。
ロール役割の特徴
バックエンドエンジニアAPI 開発、データモデリング、サービス連携、パフォーマンス最適化、本番安定性に特化。インクリメンタルデリバリー、テスト検証、規約優先設計のエンジニアリングプラクティスに従います。Bug / Issue を自動分析し、コード修正後に直接 PR を提出します。
フロントエンドエンジニアフロントエンドの UI 設計と実装に特化。コンポーネントアーキテクチャ、ビジュアルの磨き込み、レスポンシブ対応、アクセシビリティ最適化、パフォーマンスチューニングが得意。インクリメンタルデリバリーと根拠ベースの検証で、UX とエンジニアリング品質を両立します。
テストエンジニアCLI ツールおよび Web プロダクト向けの品質保証ロール。テスト計画書、E2E テスト、不具合再現、根拠ベースのレポート作成に注力します。ユニットテストの実行や問題の修正は行いません。
プロダクトマネージャーソフトウェアプロダクト向けの AI ネイティブ PM ロール。目標ドリブンの要件ライフサイクル管理、PRD 生成、ユーザーフィードバック分析、競合調査、リリースコミュニケーションに注力し、外部書き込みには明確な承認ゲートを設定します。
データアナリスト問題定義、指標定義、DingTalk ドキュメント / シート MCP によるデータ収集、データ診断、市場背景の整理、根拠ベースの提案を担う AI ネイティブのデータアナリスト。
コンテンツオペレーターアカウント設計、トレンド分析、コンテンツカレンダー、小紅書(Xiaohongshu)の投稿作成、ビジュアル素材ブリーフ、承認後の公開、コメント運用、効果分析、ブランドコンプライアンス、クロスプラットフォーム書き換えを担う AI ネイティブのコンテンツオペレーター。
カスタム自分の領域で必要な役割の働き方やワークフローを自由に定義できます。MCP や Skill などの構成を任意に追加可能です。

環境準備

QoderWake はローカル展開とクラウド展開の両方に対応しています。デジタル従業員を 7×24 時間稼働させるため、ネットワーク状態の良い、常時稼働可能なデバイスやクラウドデスクトップ環境への配置を推奨します。
Windows 版は近日公開予定で、まだ一般公開していません。当面は macOS または Linux でご利用ください。

ローカル展開

長期間安定稼働できるローカルデバイス(例:Mac mini)への展開を推奨します。
  • macOS:13.0 以上。
  • Linux:Ubuntu 22.04 LTS 以上を推奨。ローカル Web Console を利用するため GUI デスクトップを有効にしてください。

クラウド展開

主流のクラウドデスクトップやクラウドホスト環境に対応しています。ブラウザログインとローカル Web 管理を容易にするため、Alibaba Cloud の無影 Cloud Computer(Enterprise / Personal エディション)を推奨します。
  • Linux:Ubuntu 22.04 以上。GUI デスクトップを有効にしてください。

前提ツール

QoderWake にはソフトウェア開発系のロールが組み込まれています。インストール前に Git 環境を整え、現在のアカウントが対象リポジトリにアクセスできることを確認してください:
  • git がインストールされていること。
  • リポジトリの認証設定が完了していること。
  • clonepullpush を正常に実行できること。
ローカル / クラウドのいずれの環境でも、サインイン、モデル呼び出し、リポジトリアクセスのために外部ネットワーク接続が必要です。プロキシやファイアウォールのある企業ネットワークでは、必要な HTTPS 送信を事前に許可しておいてください。

ステップ 1:QoderWake のインストール

macOS

直接ダウンロード: または、ターミナル(アプリケーション内の “Terminal” を検索)を開いて以下を実行:
curl -fsSL https://qoder-ide.oss-ap-southeast-1.aliyuncs.com/qoderwake/install.sh | bash
スクリプトはプラットフォームを検出し、パッケージをダウンロードしてインストール、コマンドエントリを PATH に追加、ブラウザでサインイン、ローカルサービスを起動して Web Console を開きます。コマンドエントリ:~/.qoderwake/bin/qoderwake

Linux

ターミナルを開き、以下を実行します:
curl -fsSL https://qoder-ide.oss-ap-southeast-1.aliyuncs.com/qoderwake/install.sh | bash
インストールスクリプトは次を自動で行います:
  1. Linux の CPU アーキテクチャを検出。
  2. プラットフォームに合った QoderWake パッケージをダウンロードして検証。
  3. QoderWake の本体プログラムとリソースファイルをインストール。
  4. コマンドエントリを作成し PATH への追加を試みます。
  5. ブラウザを開いてサインイン。
  6. サインイン後にローカル常駐サービスを起動 / 再起動。
  7. ローカル Web Console を自動で開きます。
コマンドエントリ:
~/.qoderwake/bin/qoderwake
デフォルトの Web Console アドレス:
http://127.0.0.1:19820

Windows

Windows 版は近日公開予定です。一般公開され次第、本ページに更新内容を反映します。

ステップ 2:コンソールを開く

ブラウザで http://127.0.0.1:19820/ にアクセスします。これが QoderWake のローカル管理コンソールで、Waker 管理、タスク割り当て、権限設定はすべてここで行います。 レイアウト:
  • 左サイドバー:「My Wakers」リスト。作成済み Waker と最終アクティブ時刻を表示。
  • 上部ボタン:「Waker を作成」で新規追加。右側からタスクを作成可能。
  • メインエリア:Waker を選ぶと会話画面が開き、すぐに作業を依頼できます。
  • 右サイドバー:作成済みタスクと現在実行中タスクの詳細。
初回アクセス時はサインイン画面に誘導されます。

ステップ 3:Waker を作成する

左サイドバーの 「Waker を作成」 をクリックします。
  1. ロールテンプレートを選ぶ:各テンプレートにはペルソナ、典型的なワークフロー、コアスキル、初期質問が組み込まれています。「詳細を見る」でプレビュー可能です。
  2. またはロールをカスタマイズ:プリセットが合わない場合は 「カスタムロール」 を選び、ペルソナ・専門領域・働き方をゼロから定義し、スキル・コネクタ・権限を組み合わせます。
  3. 基本情報を入力名前、アバター、紹介文 を入力します。プリセットロールを選択した場合は自動入力されるので、必要に応じて調整します。
  4. 保存保存 をクリックすると Waker が作成されます。初回作成後はガイド付きセットアップが推奨スキルや接続先チャネルを案内します。スキップして後で設定しても構いません。
カスタムロールの効果を高めるため、作成時に役割の位置付け、コア責務、ワークフロー、必要なスキル、MCP 等のツール構成といった情報をできる限り完全に提供してください。

ステップ 4:Waker と仕事を始める

作成した Waker には、会話を開始 するか 自動タスクを設定 するかを選べます。

会話タスク

入力欄に依頼内容を書いて送信すれば、Waker はすぐに着手します。途中で次のような操作ができます:
  • 追加質問・方向修正:いつでも割り込み、Waker はコンテキストを保ったまま継続。
  • ファイル / スクリーンショット添付:どのメッセージにも添付可能。
  • 割り込み停止:方向がずれた場合は停止を指示。
  • 承認 / 却下:ファイル変更、コマンド実行、ネットワーク利用が必要なときは確認カードが表示されます。
  • 質問への回答:Waker が選択肢を提示してきたらカード上で選択。
  • AI モデルの切り替え:会話の途中で上部のドロップダウンから切替可能。
  • 思考プロセスの確認:意思決定前のリーズニングをリアルタイムで確認。
  • 成果物の確認:右側パネルにコードパッチや生成ファイルが随時表示されます。
  • 作業ディレクトリの選択:会話下部からローカルディレクトリを選択。

自動タスク

「毎朝 9 時に実行」や「Issue が立つたびに自動応答」のような繰り返しシナリオに最適です。 Waker 詳細 → トリガータスク → 新規 から、以下を設定します:
  • タスク名と説明:Waker がそれだけ読んで作業できる粒度で記述。
  • AI モデル:使用するモデル。
  • 作業ディレクトリ:実行するローカルディレクトリ、リポジトリ、プロジェクトワークスペース。
  • トリガー方式(最大 5 種類、組み合わせ可):
    • スケジュール:単発 / 周期 / 複雑な周期(毎日 9 時、毎週月曜、毎月 1 日など)。
    • イベント駆動:GitHub リポジトリの Issue / PR / コメント変化を監視。
    • Webhook:外部システムから固定 URL でコールバック。
  • 最大実行回数 / 期限(任意):無限実行を防ぐ上限。
保存すると、設定したペースで自動稼働します。一時停止 / 再開、即時テスト実行、実行履歴の確認はいつでも可能です。

ステップ 5:Waker を管理する

Waker の詳細ページからは、その Waker に関するすべての設定を確認・調整できます。
セクションできること
ホームアバター、ステータス、入社日数、トリガータスク数、会話タスク数、稼働ヒートマップ。
プロジェクトコードリポジトリやローカルディレクトリを紐付け。1 プロジェクトに複数のソースを含められ、プロジェクト独自の記憶は Waker 個人の記憶と分離されます。
トリガータスク自動タスクの追加 / 編集 / 削除 / 一時停止。
会話タスク履歴を遡って会話を再開。
記憶あなたとプロジェクトに関する長期認知。ソース:会話中の自動沈殿、手動編集、システムによる定期整理。ローカル保存され、クラウドにアップロードされません。
スキルQoder 公式 Skills Marketplace からのインストール、ローカルアップロード、既存スキルの ON/OFF。組み込みスキルはアンインストール不可。
コネクタ外部ツール / サービス(GitHub、Jira、GitLab など)への橋渡し。
権限ツール防護 — 組み込みのセキュリティルールに基づく検証(コマンドインジェクション、リソース乱用、コード実行、ネットワーク乱用、機密ファイルアクセス、権限昇格);ファイル防護 — ローカルファイルへの読み書き権限;組み込みツール — ツールごとに許可 / 確認 / 無効化のポリシーを設定。高リスクなアクションは承認カードを表示。

Waker の設定

記憶

各 Waker は、あなたとプロジェクトについての長期記憶を蓄積します。記憶のソースは 3 つあります。
  • 自動沈殿:会話の中で記憶しておくべきと Waker が判断した情報を自動で書き込み。
  • 手動編集:記憶ページから直接編集可能。
  • システム整理:定期的にシステムが整理・重複排除を行います。
Waker 詳細 → 記憶 で全エントリを閲覧 / 検索 / 編集できます。記憶はローカルに保存され、クラウドにアップロードされません。

スキル(Skill)

スキルは、会話やトリガータスクの中で Waker が呼び出せる専用能力パッケージです。
  • スキルマーケット:Qoder 公式の Skills Marketplace からインストール。
  • アップロード:ローカルからカスタムパッケージを取り込み。
  • 組み込みスキル:標準搭載でアンインストール不可。
Waker 詳細 → スキル で、インストール済みスキルの確認、マーケット検索、カスタムスキルのアップロードができます。

コネクタ(Connector)

コネクタは、Waker と外部ツール / サービスをつなぐ橋です。手動で追加できます。

プロジェクト

プロジェクトは Waker のワークスペースです。Waker 詳細 → プロジェクト から:
  • ローカルディレクトリや Git リポジトリを紐付け。
  • 1 プロジェクトに複数のソース(複数のディレクトリ / リポジトリ)を含めることが可能。
  • プロジェクト独自の記憶を持ち、Waker 個人の記憶とは分離されます。

権限管理

権限は、Waker の動ける範囲をコントロールします。Waker 詳細 → 権限 には 2 つの大区分と組み込みツールのポリシーがあります。 ツール防護:組み込みのセキュリティルールに基づいてツール呼び出しのパラメータを検証し、高リスクなアクションは承認リクエストを要求します。ルールカテゴリ:
  • コマンドインジェクションrmmv などの破壊的操作を検出。
  • リソース乱用:fork 爆弾やシステム再起動などを検出。
  • コード実行curl | bash のようなリモート実行を検出。
  • ネットワーク乱用:リバースシェルやローカルループバックアクセスを検出。
  • 機密ファイルアクセス:システムの重要ファイルへのアクセスを検出。
  • 権限昇格sudo などの権限昇格を検出。
ファイル防護:ローカルファイルに対する Waker の読み書き権限をコントロールします。 組み込みツール:Waker が利用できる組み込みツールごとに 許可 / 確認 / 無効化 のポリシーを設定できます。 セキュリティルールに該当するアクションが発生すると、承認カードが表示され、許可 / 拒否を選択できます。

シナリオ:自動 Bug 修正

2 通りの進め方があります。 方法 A — 手動で会話を開始:コンソールを開き、バックエンドエンジニア ロールの Waker を選択します。チャット欄に 「このエラーの根本原因を調査し、最小限の修正案を提示して」 と入力し、エラー情報を貼り付けます。修正案を確認したら適用させ、PR を提出させます。コマンドの実行やファイル変更が必要になるたびに、Waker が確認を求めてきます。 方法 B — 自動タスクで処理Waker 詳細 → トリガータスク → 新規 に進みます。トリガー方式を 「イベント」 にし、GitHub リポジトリの Issue 変化を監視するよう設定。タスク説明を 「新しい Bug Issue が立った際は、自動で分析して修正 PR を提出すること」 と記述します。保存後、リポジトリに新しい Bug Issue が立つたびに自動で分析と修正を開始します。

フィードバック

問題に遭遇した、あるいは機能に関するフィードバックがある場合は、コンソール右下のフィードバックボタンから送信してください。可能な限り早く対応・解決します。