チケットの作成と管理

このガイドでは、チケットの作成と管理の方法を説明します。

チケットを作成する

UI から

ワークスペースのサイドバーでチケットをクリックします。
新規チケットを押します。
次の項目を入力します:
- タイトル — 短い要約。唯一の必須フィールドです。
- 説明 — Markdown。書式設定ツールバーが付いています。
- ステータス — 未着手（既定）またはバックログ。着手済みの状態と終端の状態には、作成時ではなくライフサイクルを通じて到達します。
- 優先度 — なし、緊急、高、中、低。
- 担当者 — 自分自身、またはワークスペース内の任意のエージェント。
- プロジェクト — 任意のグループ化。
作成を押します。または、先に続けて作成をオンにすると、ダイアログが開いたままになり、続けて入力できます。

ダイアログにプロバイダーのピッカーはありません。チケットは、ワークスペースで有効なチケットプロバイダーに対して作成されます。

エージェントから

スペース内のエージェントに依頼します:

遅い回線でのログインタイムアウト問題を修正するチケットを作成してください。

エージェントは create_ticket MCP ツールを呼び出します。このツールの優先度は名前ではなく整数です:

create_ticket(
  workspace_id: "...",
  title: "Fix login timeout on slow connections",
  description: "...",
  priority: 2
)

値	優先度
`0`	なし
`1`	緊急
`2`	高
`3`	中
`4`	低

必須なのは workspace_id と title だけです。description、priority、 assignee（エージェント id）、team_id は任意です。このツールはベンダー同期の書き込みとして分類され、実行前に承認を求めます。

チケットのステータスを更新する

チケットは次のライフサイクルに従います:

backlog → open → inProgress ⇄ blocked
                    ↓   ↑
                 inReview
                    ↓
              done / failed   (terminal)

done、failed、cancelled は終端です。cancelled には、終端以外の任意のステータスから到達できます。done と failed には inProgress または inReview から到達できます。また open は blocked へ直接移動することもできます。UI のステータスピッカーには、failed を除くすべてのステータスが並びます — エージェントはそれを fail_ticket で設定します。

変更するには、次のいずれかを使います:

チケットのプロパティパネルにあるステータス行、
リスト内のチケットの右クリックメニューにあるステータスサブメニュー、
チケットを複数選択した後のフローティングバーにあるステータスチップ。

ステータスの変更は、パイプラインをトリガーできるドメインイベント（TicketStatusChanged、TicketCompleted など）を発行します。パイプライントリガーを設定を参照してください。

チケットを割り当てる

チケットを開きます。
プロパティパネルで担当者を設定します — 自分自身、別のワークスペースメンバー、またはエージェントです。

ラベルを追加する

ラベルは、単一のチケットからではなく、チケットリストから一括で適用します — プロパティパネルにラベルの操作はありません。

チケットリストの行にカーソルを合わせ、そのチェックボックスをオンにします。必要な数だけオンにします。何かが選択されるとフローティングバーが表示されます。
そのバーでラベルチップを開きます。
ラベルを選びます。選択したすべてのチケットのうち、そのラベルを持たないものに追加されます。既存のラベルが消えることはありません。ラベルをクリアはすべてのラベルを削除します。ピッカーには、ワークスペース内のチケットにすでに付いているラベルが並びます。エージェントは update_ticket または tickets.patch を通じて新しい名前を追加できます。

チケットをリンクする

関連は、プロパティパネルのチケットの関連カード、またはリストの右クリックメニューの関連付けるにあります。

チケットを開き、関連カードを見つけます。
その追加コントロールを押し、関連の種類を選びます:

関連	意味
…のサブイシュー	このチケットの親はもう一方のチケットです
…の親	もう一方のチケットはこのチケットの子です
…にブロックされている	このチケットはもう一方によってブロックされています
…をブロック中	このチケットはもう一方をブロックしています
…に関連	対称であり、方向は含みません
…の重複	このチケットはもう一方の重複です

対象のチケットを選びます。

重複先はカードには表示されますが、ピッカーには表示されません — これは …の重複の逆であり、もう一方のチケットから設定します。一覧に表示される各関連はクリックするとリンクされたチケットが開き、ホバーすると削除できます。

親とサブイシューの関連は、リンク行としてではなくチケット自体に保存されるため、親を削除するとその子にカスケードします（後述）が、ブロックと関連のリンクはカスケードしません。

コラボレーターを追加する

コラボレーターはチケット上の名簿です — 誰が、どの立場で関わっているかです。

チケットを開きます。
コラボレーターを追加カードにある人物追加のコントロールを押します。
エージェントを選びます。

3 つのロールは担当者、コラボレーター（既定）、レビュアーです。 UI のピッカーにはワークスペースのエージェントだけが並び、常に既定のロールを書き込みます。人間は行として表示されることはありますが、このメニューには並びません。MCP の add_ticket_collaborator ツールは role を受け取ります。

コラボレーターを追加すると行が書き込まれますが、ドメインイベントは発行されず、スペースへのアクセス権も付与しません。エージェントを会話に参加させるには、代わりにスペースのヘッダーから参加者として追加します — スペースを参照してください。

チケットを削除する

プロパティパネルの下部にあるチケットを削除、右クリックメニュー、または複数選択後のフローティングバーの削除アクションを使います。