> ## Documentation Index
> Fetch the complete documentation index at: https://cogno.studio/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# 自分のTaskを自分のマシンで続ける

> メンバーのマシンで実行中の自分のTaskを、自分のマシンに移して自分で作業します。

あなたのTaskは、メンバーのマシンを含め、ワークスペースの空いているマシンで実行される
ことがあります。どのマシンで実行されていても、あなたのTaskです。自分で作業したいときや、
作業にあなたのマシンにしかないものが必要なときは、自分のマシンで続けられます。これが
できるのはTaskの担当者だけで、実行は担当者のマシンにだけ移ります。

## 前提条件

* あなたがTaskの担当者であること。
* Taskがメンバーのマシン、またはクラウドプロジェクトの場合はCloud環境で実行中であること。
* あなたのマシンに、そのプロジェクトの準備済みフォルダがあること。
  [マシン](/docs/ja/machines.md)を参照してください。
* Taskが **完了**、**アーカイブ**、**却下** ではないこと。

## 自分のマシンで続ける

あなたのTaskがメンバーのマシンまたはCloud環境で実行中のとき、メッセージ入力欄の上に
**送ると、この実行はあなたのマシンに移り、{メンバー} の {マシン} での実行は止まります。**
(Cloud環境のときは **…Cloud環境での実行は止まります。**)と表示されます。まだ引き継げないときは、
あなたのマシンにそのプロジェクトのフォルダがないなど、その理由が代わりに表示されます。

自分宛ての質問を表示している間は、メッセージ入力欄からその質問への回答を送り、実行は現在のマシンに残ります。選択肢や質問の×ボタンを選んだ場合も同様です。[会話内の質問に答える](/docs/ja/task-sessions.md#会話内の質問に答える)を参照してください。

![送るとあなたのマシンに移り、メンバーのマシンでの実行が止まることを示す、入力欄の上の表示](https://mintcdn.com/genaxis/gC4sypYtPv6IjbOd/images/task-handoff-notice.png?fit=max\&auto=format\&n=gC4sypYtPv6IjbOd\&q=85\&s=7f8de5a57330ace8040a7d4a446aad42)

メンバーのマシンで実行中のあなたのTask

**1. Taskを開く**

デスクトップアプリまたはWebでTaskを開きます。

**2. メッセージを送る**

次にやることを入力して送ります。Cognoがそのプロジェクトのあなたのフォルダへ実行を移し、
説明文と送ったメッセージからあなたのマシンで新しい実行を始めます。前のマシンでの実行は止まります。

デスクトップアプリでは、送信するとすぐにTaskの説明画面から作業画面へ切り替わり、
実行が自分のマシンへ移る間も送ったメッセージが表示されます。移せなかったときは
説明画面に戻り、メッセージは入力欄に戻って、理由が上に表示されます。切り替えのアニメーションはシステムの視差効果を減らす設定に
従います。実行の開始タイミングは変わりません。

## 移るもの

| 移る | 前のマシンに残る |
| - | - |
| Taskの説明 | 前の実行の会話 |
| 前の実行がまだ受け取っていなかったTaskへのメッセージ | 前のマシンがターンの途中で止まったときの、終わらなかったターンの変更 |
| 前の実行が作業していたブランチと、そのコミット（push済みかどうかを問わない） | チェックポイントから除かれるファイル（下記） |
| 前の実行の最後のターンが終わった時点の、コミットしていない変更と新しいファイル | **直接実行** に設定したフォルダの中身すべて |

新しい実行は同じブランチで始まり、コミットしていない変更はコミットしていないまま
置かれます。前のマシンでの実行は1分ほどで止まります。新しい実行は説明から始まります。

## Taskを実行中のマシンが応答しなくなったとき

Cognoが作業中のTaskで、実行中のマシンが10分応答せず、Taskに待っている作業がある
ときは、Taskが止まらないようにCognoが実行を別のマシンへ移します。

* オンラインで、そのプロジェクトの準備済みフォルダがあれば、あなたのマシンが優先です。
* そうでなければ、オンラインで準備済みフォルダのあるメンバーのマシンへ移ります。
* そのようなマシンがオンラインにないときは、Taskはその場で待ちます。

新しい実行には、前のマシンが応答しなくなったこと、前の実行がターンの途中で止まった
可能性があること、メッセージやコメントを送り直す前に送信済みでないか確かめることが
伝えられます。この移動は1つのTaskにつき1日3回までです。 **このタスクの実行をあなたの
マシンに移しました** の通知は、あなたのマシンに移ったときだけ届きます。

## Cognoがリポジトリのリモートに残すもの

pushしていない作業も移せるように、Cognoは毎ターンの終わりにTaskの作業のチェック
ポイントを保存し、リポジトリのリモートに `refs/cogno/checkpoints/task-<TaskのID>`
としてpushします。対象は **Worktreeで実行** するフォルダだけです。 **直接実行** に
設定したフォルダには一切触れません。

| 項目 | 内容 |
| - | - |
| 含むもの | Taskの作業ツリーのブランチ、そのコミット、変更したファイルと新しいファイル |
| 除くもの | `.gitignore` で無視しているファイル。フォルダ内のどこにあっても `.env`、`.env.*`、`*.pem`、`*.key`、`*.p12`、`*.pfx`、`id_rsa*`、`id_ecdsa*`、`id_ed25519*`、`.netrc`。5 MBを超える変更ファイル |
| 読める人 | push済みのブランチと同じく、リポジトリを読めるすべての人。ブランチではないので、ブランチ一覧やPull Requestには出ません。 |
| 残る期間 | Taskが **完了**、**アーカイブ**、**却下** になるか削除されるまで。その後、Taskのフォルダを持つマシンが削除します。開き直したTaskは、次のターンで新しいチェックポイントを保存します。 |
| pushに使う認証情報 | Taskを実行しているマシンのGit認証情報 |

> [!WARNING]
>
> チェックポイントには、コミットしていないファイルが含まれることがあります。認証情報
> など、マシンの外に出してはいけないファイルは `.gitignore` に入れてください。

## Cognoがあなたのマシンに移すとき

ローカルのファイル、認証情報、ログイン済みのツールなど、あなたのマシンにしかないもの
が実行に必要になることがあります。このときCognoは、わかったことを説明に書き、残す
べき作業をpushしてから、実行をあなたのマシンへ移します。新しい実行はすぐに始まり、
[受信トレイ](/docs/ja/inbox.md)に **このタスクの実行をあなたのマシンに移しました** という通知
が届きます。

## トラブルシューティング

| 症状 | 対処 |
| - | - |
| **自分のマシンで続ける** が表示されない | あなたがTaskの担当者であること、あなたのマシンにそのプロジェクトのフォルダがあることを確認してください。 |
| **あなたのマシンに移せませんでした** | Taskが閉じられたか、移動したか、フォルダの準備ができていません。Taskを開き直し、**設定 → マシン一覧** でフォルダを確認してください。 |
| 前の実行の変更がないまま新しい実行が始まる | 前のマシンがターンの途中で止まったか、チェックポイントから除かれるファイルか、フォルダが **直接実行** に設定されています。前のマシンの持ち主にpushを頼み、ブランチ名をTaskに送ってください。 |

## 関連ドキュメント

* [Taskをターミナルで引き継ぐ](/docs/ja/task-sessions.md)
* [マシン](/docs/ja/machines.md)
* [受信トレイ](/docs/ja/inbox.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.