エージェント

Linear

Linear の Issue を Comma に割り当てるか、コメントで @Comma をメンションします。Comma は Issue 内で回答し、作業をあなたのワークスペースのタスクとして実行して、進捗と結果を Issue に書き戻します。

はじめる前に

• Comma のワークスペース（デスクトップアプリまたは app.comma.surf）。
• Comma を使いたい Linear ワークスペースのアカウント。その Linear ワークスペースで最初に接続した人が Comma をインストールします。これには Linear のワークスペース管理者権限が必要です。以降の人は自分のアカウントを連携するだけです。
• 作業を実行する手段：Comma に接続した自分の Codex や Claude Code、またはクラウド Worker 用の Comma クレジット。Issue 内で回答するだけなら Worker は不要です。

Linear を接続する

1. Comma で設定を開き、チャンネルに進んで Linear カードの接続を押します。
2. Linear が、あなたとしてワークスペースを読み取る許可を Comma に与えるよう求めます。これで Comma はあなたがどの Linear ユーザーかを知ります。
3. その Linear ワークスペースに Comma がまだインストールされていなければ、Linear がもう一度確認します。これで Comma が選んだチームのエージェントとしてインストールされます。
4. Comma に戻ると、カードに接続済みと表示され、Linear の組織とあなたのアカウントが示されます。

Issue の実行方法を選ぶ

• タスク完了時。 Issue をそのままにするか、チームにその状態があれば In Review に移すか、Done に移すかを選べます。

Issue を委任する

1. Linear で Issue を Comma に割り当てるか、コメントに @Comma と依頼内容を書きます。
2. Comma は数秒以内に Issue のエージェントセッションで回答します。質問、トリアージ、計画はそこで回答され、タスクは作られません。
3. 実際の作業が必要になると、Comma はタスクを開始します。Issue はチームの最初の「開始済み」状態（多くのチームでは In Progress）に移ります。すでに開始済みか終了済みなら移りません。セッションに Task in Comma のリンクが付き、Worker の進捗と結果がセッションに投稿されます。Worker が開いた pull request もリンクされます。
4. セッションで返信して方向を修正したり、追加を依頼したりできます。現在のタスクが終わってから、Comma は次のタスクを開始します。

停止または終了

• セッションで Stop を押すと、実行中のタスクが終了します。完了済みの作業は残ります。
• Issue を Done または Canceled にするか、Comma 以外に割り当て直すと、実行中のタスクは終了し、Comma がセッションでその旨を伝えます。すでに結果を届けたタスクはそのままです。
• Issue を削除すると、実行中のタスクは終了し、その旨は Comma 内のタスクにのみ記されます。セッションは Issue とともに消えるため、そこには何も投稿されません。

Comma で続ける

すべてのセッションには Open in Comma のリンクが、委任されたタスクには Task in Comma のリンクがあります。Comma では全記録を読む、作業を続ける、結果を確認して承認する、ができます。Comma で書いた内容は Comma に留まり、Linear で尋ねられたことへの Comma の回答だけが Issue に戻ります。

管理と接続解除

• 以下の操作はすべて Linear カードの「管理」メニューにあります。
• Linear のログインが変わったら「再接続」します。確認が表示されます。
• 「接続解除」は自分のアカウントの連携だけを外します。同僚の連携はそのままです。
• 「組織から削除」は Comma をインストールした Comma ワークスペースにのみ表示されます。Linear の管理者も Linear の Settings › Applications から削除できます。