ウィジェット堂 - Notion 向けウィジェット・動くアイコン・スタートページ・マイページ

デスクトップ版 Agents プロジェクト:マネージャーとボード

ウィジェット堂デスクトップ版の Agents プロジェクト:目標を伝えると、マネージャーがリポジトリを読んで課題を提案し、選んだものを複数のエージェントが並行して作業し、自動でレビューしてあなたの承認を待ちます。対応が必要なことは一か所にまとまります。

プロジェクトは 常駐するマネージャー と ボード でできています。あなたは目標を伝え、提案を選び、結果を承認するだけ。計画・割り当て・進捗の確認・レビューはマネージャーとワーカーが行います。

プロジェクトを作る

  1. デスクトップ版のサイドバーで エージェント を開き、プロジェクト(または上部のターゲットアイコン)をクリックします。
  2. 目標を書きます。例:「設定画面をダークモードに対応し、ライトとダークのスクリーンショットで確認」。
  3. リポジトリを選びます(git リポジトリが必要です。最近使ったものが表示されます)。
  4. 始め方を選びます:
    • まず提案、私が選ぶ(初期設定):計画は「提案」に入り、選んだものから開始します。
    • すぐに開始:最初のバッチを計画でき次第すぐに割り当てます。
    • 自動運転 も同時にオンにできます(下記)。
  5. プロジェクトを作成(⌘↵)をクリックします。エージェントや同時実行数、チェックコマンドを変えるには 詳細設定… を使います。

初期設定:Claude Code がマネージャー。ワーカーはファイルを編集できますが、コマンドはターミナルで確認します。課題ごとに独立したワークツリーとブランチを使い、同時に最大 3 件。チェックコマンドが通った小さな変更(20 ファイル / 600 行以下、機密ファイルなし)はローカルのベースブランチへ自動でマージし、大きな変更やチェックが通らないものは「レビュー待ち」であなたの承認を待ちます(1.23.7 から。プロジェクト設定ですべて確認待ちにもできます)。

左側:マネージャーとの会話

  • マネージャーはリポジトリのルール、ドキュメント、過去の課題、各ワーカーの状況を読み、進捗を報告し、「なぜ時間がかかっているの」といった質問にも答えます。
  • 次のバッチの提案 はチェックリストで表示され、「選択を開始」でまとめて開始、「残りは見送り」で片付けられます。
  • 判断が必要なときは はっきり質問 します(黄色のカード)。質問は「対応が必要」にも表示されます。
  • メッセージ内の課題番号(WF-3 など)、PR、ブランチ、ドキュメント名はクリックできます。
  • 入力欄の下の「この Mac / このパソコン」は実行場所です。「クラウド」は近日対応です。

右側:課題ボード

課題にはプロジェクトの接頭辞と番号(WF-12 など)が付きます。状態は 提案 · 待機 · 作業中 · 対応が必要 · レビュー待ち · 完了 · 見送り です。

  • リスト:「対応が必要 → レビュー待ち → 作業中 → 待機 → 提案」の順に並び、作業中の行にはターミナルの最新行と進捗バーが表示されます。
  • ボード:カードをドラッグして状態を変えます。「待機」に置くと開始、「レビュー待ち」から「完了」へ移すと承認してマージ、「見送り」に置くと取り消し。許可されない移動(提案から完了へ直接など)は理由を表示します。
  • ライブラリ:マネージャーのメモ(概要・決定事項・教訓)、日次レポート、変更された Markdown ドキュメント、PR、ブランチ、レビューの根拠とテスト結果。
  • 各課題に成果物を表示します:PR、ブランチ、コミット数、変更行数、変更ドキュメント、チェックの合否、費用。
  • 検索はタイトル、ファイル、ブランチが対象です。

課題パネル

課題をクリックするとパネルが開きます:現在のステップ、止まっている理由と解決方法、マネージャーのレビュー、ワーカーの報告、受け入れ基準、所要時間と費用、変更ファイル、スクリーンショットや録画の根拠、ターミナルの最新出力、関連するやり取り。操作:

  • 承認してマージ:ベースブランチにマージします(メインフォルダーがベースブランチにあり、未コミットの変更がないこと)。
  • 差し戻す:直してほしい点を書くと、そのままワーカーに送ります。
  • 続けさせる / ワーカーに伝える:ワーカーが空いたら届きます。
  • ターミナルを開く:承認待ちのワーカーへすぐ移動します。
  • チャットに送る:「メッセージ」を開き、課題をカードとして友だちやグループに送れます。

対応が必要

サイドバー上部の 対応が必要 に、すべてのプロジェクトであなたを待っているものをまとめます:マネージャーの質問、レビュー待ち、止まっている課題、待機中の単独タスク、選ぶ提案。サイドバーのバッジも同じ件数で、新しいものはシステム通知でお知らせします。

マネージャーのメモ

各プロジェクトには プロジェクト概要、決定事項、教訓とルール の 3 つのドキュメントがあります。毎回の計画と各ワーカーに自動で渡され、ライブラリで直接編集できます。見送るときに書いた理由は教訓に追加され、似た提案は繰り返しません。

自動運転

プロジェクト上部の 自動運転 をオンにすると、バッチが終わるたびにマネージャーが目標に向けて次のバッチを計画し、すぐに開始します(Loops はこのスイッチになりました):

  • 提案はまず絞り込まれます。目標と無関係なもの、判断待ちの問題、教訓で除外したもの、変更不要と判断済みのものは割り当てません。
  • ワーカーの「変更不要」が 2 回続くと 1 回計画し直し、それでも同じなら理由を示して止まります。
  • 1 日の件数と推定費用に上限があります(初期設定は 6 件・5 ドル、プロジェクト設定で変更可)。あなたのエージェントのプランを使います。
  • レビューに合格した小さな変更(20 ファイル / 600 行以下、チェック通過、CI・デプロイ・秘密情報のファイルに触れない)はローカルのベースブランチへ自動でマージし、それ以外はあなたの承認を待ちます。プッシュはしません。プロジェクト設定ですべて確認待ちにもできます。

事前許可するコマンド

プロジェクト設定に「事前許可するコマンド」の一覧(1 行に 1 つの接頭辞)があります。一致するコマンドはターミナルで確認せずに実行し、それ以外は従来どおり承認を求めます。

  • 新しいプロジェクトには読み取りとビルド系のコマンドを最初から入れます:git status、git diff、git log、リポジトリのテスト・lint・型チェック・ビルド。
  • プッシュ、削除、パッケージ追加、履歴の変更、; | && などを含むコマンドは追加できません。
  • ワーカーが安全なコマンドで何度も止まると、マネージャーが追加を提案します。提案は「対応が必要」に表示され、「許可」を押したときだけ有効になります。
  • 現在は Claude Code に対応しています。Codex などは引き続きターミナルで確認します。

シグナル

シグナルは定期的にリポジトリを確認し、問題を見つけると根拠リンク(CI の実行ページなど)付きの課題を自動で作ります:

  • CI の失敗(GitHub Actions。このパソコンで gh のログインが必要)
  • チェックコマンドの失敗(初期設定はプロジェクトのチェックコマンド)
  • Lighthouse の低下(「URL 最低点」を入力。例:https://example.com 90)
  • Sentry の新しい問題(sentry-cli のログインが必要)
  • リストの未完了項目(リポジトリ内のリストファイルを入力)

シグナルはプロジェクト設定で個別にオン・オフできます。同じ問題は二重に作らず、見送ったものは再提案せず、修正後に再発したものは作り直します。自動運転がオンならすぐ開始し、オフなら「提案」に入ります。上部の「シグナル N 件」ボタンですぐに確認できます。

速く、安定して:ワーカーの動き方

デスクトップ版 1.23.7 以降が必要です。 ワーカーが Claude Code のときは、ネイティブの headless で実行します。開始前にマネージャーが完全な指示を 1 つ書き、ワーカーはそれを一気にやり切ります。実行中、そのセッションには何も差し込みません。マネージャーの言葉もバックグラウンドのイベントも転送せず、ワーカー同士のメッセージもできません(以前は互いに待ち合い、承認も必要でした)。「ワーカーにひとこと」で送った内容は、今回の実行が終わってから渡します。

  • 終わったら自動で仕上げ:プロジェクトのチェックコマンドが通り、変更があればレビュー通過として課題のブランチにコミットします。小さな変更(20 ファイル / 600 行以内、機密ファイルなし)は既定でベースブランチにマージします(プロジェクト設定で「確認してから」に変更できます)。チェックコマンドがない、または通らない課題だけをマネージャーが詳しく確認します。
  • 止まって待たない:明らかに途中で止まった場合(「続けますか?」と聞いている、計画だけ)は、同じセッションで自動的にもう一度実行します(最大 3 回)。ワーカーの報告が BLOCKED で始まる場合は、すぐ「確認が必要」に入ります。
  • 1 件ごとの上限:既定は 200 万トークン(キャッシュ読み込みを除く)または実行 30 分。上限に達したら止めて仕上げ(今の変更を残して報告)、さらに超えたら今の変更でレビューします。調査の課題は 10 分までで、結論のドキュメントを出します。コンテキストが 16 万トークンを超えると、次の実行は前回の要約を持って新しいセッションで続けます。どれもプロジェクト設定で変更でき、ワーカーのモデルと推論の強さも選べます。
  • 時間の使い道が見える:課題パネルの「時間の内訳」で、待機、モデルの思考、テスト、ビルド、承認待ち、回答待ち、レビューを分けて表示し、割り込みの回数、トークン、コンテキストの大きさも出します。プロジェクトの上部には今日の成果数、マージ数、使ったトークン、1 件あたりの平均時間、最初の成果までの時間、待ち時間の割合を表示します。50 万トークン以上使ってもまだ変更がない課題は赤で示します。
  • マネージャーは「1 件 15〜30 分、明確な確認コマンド、必ず成果物がある」単位で課題を分け、「調査・確認・調整」だけの大きな課題は作りません。依存のない課題はすぐ並行で始めます(新しいプロジェクトは同時 3 件)。

日次レポート

毎朝(現地時間 8 時以降)、動きのあったプロジェクトに進捗レポートを作ります:完了したこと、レビュー待ち、止まっていること、次にやること、本日の費用。ライブラリに保存され、会話にもリンクが入ります。ライブラリの「今すぐレポート作成」でも作れます。

キーボード

j / k で移動、Enter で開く、Esc でパネルを閉じる、/ で検索、c でマネージャーと会話、1〜3 でリスト / ボード / ライブラリ、⌘K(Windows・Linux は Ctrl K)で任意のプロジェクト・課題・操作へ移動します。

安全性

  • マネージャーはリポジトリを読むだけで、ファイル編集やコマンド実行はしません。各ワーカーは自分のワークツリーで編集し、プッシュはしません。
  • マージ先はローカルのベースブランチだけです。プッシュとリリースは常にあなたが行います。
  • プロジェクトの記録、会話、ドキュメントはこのパソコンだけに保存します。

最終更新:2026年11月18日