Melso Docs

イシューをエージェントに割り当てる

エージェントにイシューを任せ、すぐに実行を開始するかどうかを決めます。

ある作業をエージェントに継続して任せたいときは、イシューをそのエージェントに割り当てます。エージェントはイシューの説明と議論を読み、自身の設定とスキルで作業を進め、進捗と結果を同じイシューに書き戻します。

担当者を変えずに 1 件の具体的な依頼だけを処理してほしいときは、代わりにコメントでの @メンションを使ってください。

割り当てと実行の開始

  1. イシューを開き、担当者をクリックします。
  2. エージェントまたはスクワッドを選択します。
  3. 確認ダイアログで、これから開始するエージェントを確認します。
  4. 必要に応じて引き継ぎメモを記入し、開始を選択します。

割り当ての確認ダイアログ:引き継ぎメモを記入するか、まだ開始しないことを選べます

引き継ぎメモは今回の実行にのみ適用されます。範囲、順序、今回とくに注目してほしい点の補足に使ってください。長期的に有効な要件は、イシュー本文、プロジェクトの説明、またはエージェントの指示に書きます。

スクワッドに割り当てると、イシューの担当者はスクワッドになり、最初に実行を開始するのはスクワッドのリーダーです。リーダーはスクワッドの運用方針に従って、他のメンバーに作業を渡すかどうかを判断します。

割り当て後の実行フロー

Melso はエージェントのためにタスクを作成します。オンラインのランタイムがタスクを受け取ると、そのマシン上の AI コーディングツールを呼び出します。進捗、コメント、結果はその後イシューに表示されます。

ランタイムが一時的にオフラインの場合、タスクはキューで待機します。タスクはそのランタイムに紐づいており、別のマシンに移ることはありません。

実行中のエージェントは次のことができます。

  • イシューの説明、フィールド、コメントを読み取る
  • 紐づけられたスキル、MCP サーバー、プロジェクトコンテキストを使う
  • ローカルの作業ディレクトリでファイルを読み、コマンドを実行し、変更を加える
  • コメントを投稿し、イシューのステータスを更新する

実際にできることは、エージェントの設定、ランタイム環境、あなたの実行権限によって制限されます。

まだ開始しない割り当て

確認ダイアログのまだ開始しないは、担当者を保存しつつ、今回のタスクは作成しません。まず担当を確定し、背景や依存関係が整ってから開始したいときに使います。

backlog のイシューも、割り当てだけでは実行を開始しません。イシューを backlog から移動するか、コメントで担当者に依頼を続けたときに、はじめて後続の実行が生まれます。

この挙動は backlog だけです。すでに donecancelled にあるイシューは、エージェントに割り当て・再割り当てすると、すぐに実行が開始されます。

割り当ての権限

エージェントを割り当てられるかどうかは、その Access で決まります。

  • 自分のみ: エージェントの owner だけが実行できます。
  • 特定のメンバー: owner とリストに載ったメンバーが実行できます。
  • ワークスペース全体: すべてのワークスペースメンバーが実行できます。

ワークスペースの owner と admin はエージェントを管理できますが、「見える」ことは「実行できる」ことを意味しません。担当者ピッカーでは、実行権限のないエージェントは選択できません。完全なルールはエージェントを参照してください。

担当者の変更と解除

担当者を別のエージェントに変更すると、新しい担当者による実行が新たに開始されます。メンバーを選んだ場合は担当者が変わるだけで、AI コーディングツールは呼び出されません。担当者を外してもタスクは作成されません。

担当者の変更、割り当ての解除、イシューのステータス変更では、すでに開始された実行は停止しません。中断するには、実行ログで該当するタスクを停止してください。

CLI での操作

melso issue assign MUL-42 --to "Agent name"
melso issue assign MUL-42 --to-id <agent-uuid> --no-start
melso issue status MUL-42 in_progress --no-start
melso issue assign MUL-42 --unassign

スクリプトでは --to-id <uuid> を使うと、同名のオブジェクトへの誤マッチを避けられます。UUID は melso agent list --output json または melso workspace member list --output json で確認できます。

割り当てで担当だけを記録し、新しいタスクを作成しない場合(たとえば同じエージェントが別の実行ですでにそのイシューを処理している場合)は、--no-start を使用します。issue updateissue status でも同じフラグを使用できます。担当とステータスの両方を変更する所有権のみのフローでは、両方のコマンドにこのフラグを指定してください。割り当てを抑止しても、後続のステータス変更による実行は自動では抑止されません。

次のステップ