> ## 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を作成し、Cogno管理の作業を確認し、実行を開始してレビューまで進めます。

TaskはCognoの作業単位です。依頼、ステータス、担当、会話、ファイル、納品を、受付からレビューまで1か所に保ちます。

サイドバーの**All tasks**を開くと、Projectをまたいだ作業を確認できます。ライフサイクルのルールは[Taskのステータス](/docs/ja/task-statuses.md)、レイアウトと保存済みビューは[Taskのビューとフィルタ](/docs/ja/task-views.md)を参照してください。

## 前提条件

* Taskを作成または編集できるCognoワークスペース。
* エージェント作業には、TaskのProjectへ接続したEnvironment。[Projectを設定する](/docs/ja/projects.md)を参照してください。

## Taskを開く

フルビューのTaskには専用ページと共有できるリンクがあります。「戻る」でTaskを開く前のページへ戻り、「進む」で再び開けます。サイドバーの移動先は1回のクリックで開きます。ページを移動しても作業中のセッションは保持されます。

ブラウザでTaskを選ぶと、現在のページの上にサイドピークが開きます。左端をドラッグし、離すと幅が保存されます。ドラッグ中にEscapeキーを押すと変更を取り消せます。左端にフォーカスを合わせ、左右の矢印キーで幅を調整することもできます。**フルビューで開く**でTask全体を開き、**タスクパネルを閉じる**で一覧へ戻ります。

| 画面 | 開く内容 |
| - | - |
| ブラウザ | Taskのプロパティ、説明、納品情報。 |
| Cognoデスクトップアプリ | エージェントとの会話、Taskの説明、ファイル、変更、実行中プロセス、ターミナルを配置できる作業画面。 |

共有された HTTPS の Task リンクは、この端末の Cogno デスクトップアプリで開くことを優先します。
対応する Desktop では OS が直接リンクを渡し、それ以外では短いブラウザの遷移を経由します。
アプリを開けない場合は、自動で Web に進みます。アプリとブラウザを選ぶ操作は必要ありません。

ほかのアプリから開いた正確なTaskリンクは、初期設定でクイックピークだけに開きます。Cognoのメインウィンドウはそのままです。Project、Meeting、Inbox、Task内のサブページへのリンクは、引き続きメインウィンドウで開きます。

Desktopで未ログインの場合やセッションが切れている場合、クイックピークはリンクをメインウィンドウに引き渡してログインを開きます。認証後は元のTaskに戻ります。リンクだけで閲覧権限が付くことはありません。Taskを閲覧できるアカウントが必要です。

すべてのTaskリンクをメインウィンドウで開くには、**設定 → 環境設定**の**Taskリンクをクイックピークで開く**をオフにします。この設定はmacOS版とWindows版のデスクトップアプリに適用され、変更時に自動保存されます。

クイックピーク内の**説明**・**会話**・**変更・PR**を選ぶと、ピークを残したままメインウィンドウでTaskの対応する表示を開きます。説明内のCognoリンクとリンクカードはメインウィンドウでリンク先を開きます。Projectのチップを選ぶと、ワークスペースの有効なProjectが一覧になり、いまのProjectにチェックが付きます。別のProjectを選ぶとTaskをそこへ移し、**プロジェクトを開く**を選ぶとメインウィンドウでProject画面を開きます。録画中の会議のTaskをピークで開いているときは、Projectを選ぶとその会議とTaskが移ります。外部リンクはブラウザで開きます。**Cogno で開く**を選ぶとTaskをメインウィンドウへ展開し、ピークを閉じます。

デスクトップのクイックピークでは、開いているTaskのタイトル、ステータス、担当者、説明、runの状態が変更に合わせて自動で更新されます。再び開いたときや、別のTaskへ切り替えたときにも最新の状態を取得します。macOSとWindowsで利用できます。

### クイックピークで説明をレビューする

ブラウザとフォールバックのクイックピークでは、説明のレビュー機能をすべて利用できます。説明の文章を選択し、**コメント**を選び、直してほしい内容を書いて**追加**を選びます。既存のコメントは、説明内の引用箇所に付いたまま表示されます。

macOS 26のネイティブクイックピークでは、説明は読み取り専用のままですが、コンテンツを編集する権限があるメンバーは文章を選択してレビューコメントを追加できます。権限がないメンバーには**コメント**が表示されません。

既存のレビューコメントは、ネイティブクイックピークの説明の下に件数で表示されます。**Cogno で開く**を選ぶとTaskの説明とレビューコメントが開きます。

Cloud ProjectのTaskのフルビューでは、会話ペインとメッセージ入力欄が非表示になります。Taskのプロパティ、説明、納品情報は引き続き利用できます。Local Projectでは会話ペインが表示されます。

デスクトップアプリを再読み込みしても、ペインの配置、右ペインの表示状態、Taskごとのターミナルの開閉状態は保持されます。読み込み中も、保存した配置で作業画面が表示されます。表示するTaskはURLで決まります。

デスクトップの作業画面では、ペインの境界をドラッグしてサイズを調整できます。離すと配置が保存され、ドラッグ中にEscapeキーを押すと元に戻ります。

別のマシンに紐づくTaskには、**\<machine>で実行中**または別マシンで動くことを示す表示が出ます。現在の画面からもTaskの説明を読み、編集できます。

## Cogno管理の作業を理解する

Cognoは接続済みのEventからTaskを作成して開始します。Taskは直接**進行中**に作成され、Cognoが担当している間はオレンジ色で表示されます。

* パソコンのリストでは、Cogno管理中の作業が、**進行中**にある担当者のタブの下の**Cogno**グループへ入ります。
* ボードとスマートフォンのリストでは、Taskは**進行中**に残り、オレンジ色の表示を保ちます。
* 最上位のTaskは作成元を保ちます。**Source**列または\*\*from \<source>\*\*の表示で確認できます。

Local ProjectでEnvironmentがまだないTaskを開始する際、Cognoは実行可能なメンバーのProjectフォルダーから、空いているマシンや負荷の低いマシンを優先します。実行可能な開始待ちのTaskは、待機している間も実行中の作業とともに負荷へ数えます。マシンの健全性、実行の空き状況、負荷が同じ場合は、担当者のマシンが優先されます。既存のEnvironmentがあるTaskは、その場所で続けます。

Runの状態はTaskのワークフローステータスと別に表示されます。Runの開始や引き継ぎでTaskの既存ステータスは変わりません。

TaskのステータスとRunの実行は別です。**完了**・**アーカイブ**・**却下**を含む、どのステータスでも会話を開始・継続できます。送信前にTaskを**準備完了**へ戻す必要はありません。Taskのステータスを変更しても、待機中・実行中のRunは停止しません。停止するときは会話の停止操作を使います。

Taskの元のSlackスレッドで次の依頼を書いてCognoへメンションすることもできます。同じスレッドに複数のTaskがある場合、Cognoが依頼の対象を確認します。

ステータスの提案は別のメタデータです。`suggested:true`で、提案が未解決のTaskだけを表示できます。[Taskのステータス](/docs/ja/task-statuses.md#ステータスの提案)を参照してください。

## Taskを作成する

### Desktopで依頼を音声入力する

**+**から開くTask入力欄のマイクで依頼を話せます。初回は**音声入力を準備する**を
選び、端末内で使うモデル（約190 MB）をダウンロードします。進捗は割合で表示します。
新しいDesktopでは**ダウンロードを一時停止**でき、もう一度**音声入力を準備する**を
選ぶと保存済みの部分から再開します。

**音声入力**を選んで話します。マイクは同じ位置で丸い停止ボタンに変わり、その横に
声に合わせて動く波形と経過時間のピルが開きます。終わるまで入力欄のほかの操作は薄く
なります。同じボタンの**停止して文字にする**を選ぶ（または Return）と変換し、ピルの
**録音を取り消す**を選ぶ（または Esc）と録音を捨てます。変換中はピルに**変換中…**と
表示します。変換結果は現在の下書きに追加され、変換を待つ間に手で直した文章も残ります。
**Taskを作成**と**あとで**は録音と変換が終わると戻ります。入力欄を閉じると、その入力欄で
始めた録音を取り消します。

新しいDesktopでは、現在のWorkspaceのProject名とメンバー名を端末内の表記ヒントに
使います。ヒントには上限があり、その録音だけに使います。独自の用語集を編集する画面は
まだありません。古いDesktopはヒントなしで変換を続けます。認識精度の改善は未計測です。

この操作の音声は端末内で処理します。モデルの取得後はオフラインでも使えます。
ブラウザの新規Task作成では、端末内の音声入力コントロールは利用不可になります。

### 接続済みEngineで作成して開始する

Cloud Projectで**Taskを作成**を選ぶと、依頼文全文をTaskの説明へ保存してCloudでのrunをキューします。自分に割り当てた場合も同じです。Taskの会話画面を開く処理に依存せず開始します。Cloudのクイック作成では実行環境の既定設定を使い、添付、モデル、アクセス権、base branchの操作は表示しません。添付後にCloud Projectへ切り替えた場合は、添付を削除してから作成してください。

DesktopとEngineに接続できるブラウザでは、同じプロンプト入力型composerを使います。Local ProjectまたはProjectなしのTaskでファイルを添付し、**Taskを作成**を押すとTaskを開いて最初のメッセージをEngineへ送信します。モデルを取得できない場合は、Engineの既定エージェントとモデルで開始します。Engineに接続できないブラウザでは、以下のフルフォームを使います。

**Taskを作成**の横の**あとで**を選ぶと、実行を始めずに依頼をバックログへ保存します。

**作業**を選び、\*\*Cognoに頼みたいことを入力…\*\*へ入力します。Projectを選び、Localでの実行ではbase branchとモデルを選びます。**Taskを作成**を選ぶかEnterを押します。Localでの実行では、Cognoは準備完了のTaskを作成して開き、プロンプトを最初のターンとして送ります。

作成に失敗しても、開いている入力欄には本文と添付が残ります。本文、Project、モデルを編集して**Taskを作成**を選び直すと、その時点の入力で再試行できます。前回の未完了の作成要求が新しい作成を妨げることはなく、入力欄を開き直しても前回の要求は復元されません。

Taskが保存された後に応答を受け取れなかった場合、自動または手動の再試行でTaskが重複することがあります。Taskの作成後に端末への初回入力の保存が失敗した場合、そのTaskは最初のターンを開始しないまま残ることがあります。

Localでの実行では、Projectの隣にある人のチップ（**担当者**）が、どのマシンで作業を進めるかを示します。最初はあなた自身です。別の人を選んで**Taskを作成**すると、Taskはその人の担当になり、ここで開く代わりにその人のマシンへrunをキューします。その人がProjectにフォルダーを接続していればすぐに開始し、なければ接続するまでTaskは**進行中**のその人のタブの下で待ちます。添付、モデル、base branchの操作は自分のマシン向けなので、別の人を選ぶとcomposerから消えます。**進行中**にある人のタブの\*\*+\*\*は、その人が選ばれた状態でこのcomposerを開きます。

Localでの実行では、作成前にファイルを添付または貼り付けられます。1つのメッセージには20件まで添付でき、ローカルエージェントは25MBを超えるファイルを拒否します。すべての添付を読み終えるまで送信は待機します。

base branchはrepositoryの既定ブランチを使います。ダイレクトEnvironmentにはGit branchも自動Pull Requestもありません。ローカル専用branchにも**自動PRなし**と表示されます。

### 依頼から付くタイトル

composerにはタイトル欄がありません。Taskには依頼文の1行目を60文字で切ったタイトルが付きます。**設定 → 一般**の**Taskタイトルを読みやすくする**がオンのあいだ(初期値はオン)、Cognoがそのタイトルを、何のTaskか分かる短いタイトルにワークスペースの言語で付け直します。付け直せなかったときは1行目のまま残ります。

フルフォームで入力したタイトルは付け直しません。自分でタイトルを編集したあとも、Cognoは変えません。1行目をそのままタイトルにしたい場合は**Taskタイトルを読みやすくする**をオフにします。変更にはワークスペース設定を編集する権限が必要です。

### フルフォームで進め方を選ぶ

フルフォームの**進め方**パネルで、担当者、Environment、次の操作をまとめて選びます。

**1. 作業を書く**

タイトルと説明を追加します。エディタではリッチテキスト、メンション、表、画像を使えます。

**2. 担当者と実行場所を選ぶ**

Local Projectでマシンを選べる場合、Environmentは最初は**自動**です。開いて**自動ルーティング**または登録済みEnvironmentを選びます。Cloud Projectは担当者に関係なくCloud環境を使います。

**3. 次の操作を選ぶ**

* **実装を見る**はTaskを作成して実装を開始します。
* **Plan する**はTaskを作成して計画ターンを開始します。
* **あとで**は実行せず、Taskを**バックログ**に作成します。
* **作成**は実行せず、Taskを**準備完了**に作成します。

Cloud Projectでは、自分へのアサインでも**実装を見る**と**Plan する**でCloud実行を開始します。
ブラウザでLocal Projectを自分にアサインした場合はTaskを保存し、Desktopで開いて開始します。
[Cloud環境](/docs/ja/cloud-environments.md#cloud-taskを開始する)を参照してください。

## 作業を開始して追う

独立した実行ボタンはありません。デスクトップアプリでは、Taskの会話でメッセージを送ります。最初のメッセージがEnvironmentを確保し、Taskを**進行中**へ移動します。それ以降のメッセージは同じTaskのsessionを続けます。

composerは\*\*エージェントにメッセージ…\*\*と表示し、Taskの接続先Engineのセッションへ送信します。この画面からマシンに接続できない場合は、入力欄の代わりにTaskの実行場所を表示します。

作業の開始中は**起動中…**、ターンの実行中は**実行中…**と表示し、送信操作は**停止**に変わります。実行中に別のメッセージで Enter を押すと次のターンのキューに積まれ、⌘Enter で入力欄とキューを実行中ターンへすぐに送ります。モデルを変えるときは、先にターンを停止します。

送信したメッセージはすぐに入力欄から消え、会話に表示されます。Engineが受け付けるまで送信ボタンは無効です。送信が拒否された場合は、本文と添付が入力欄に戻り、再送できます。

メッセージの送信予約が受け付けられると、入力欄の上に予約したメッセージが表示されます。現在のターンは継続し、メッセージは順番を待ちます。各メッセージの**今すぐ送る**、**編集**、**キューから削除**で、その後の動作を変更できます。

composerへファイルを添付、ドロップ、貼り付けできます。画像はサムネイルになり、選ぶと原寸で開きます。失敗したアップロードを削除するまで、メッセージは送信されません。

Desktopで送信を依頼したあとは、別のWorkspaceやTaskを開いても初回送信とフォルダー移動後の保留送信が進みます。Engineがメッセージを受け付けるまではアプリを開いておいてください。Engineが受け付けた作業は、表示中のWorkspaceに関係なく継続します。送信に失敗した場合は、そのTaskを開いて本文と添付を確認し、再送してください。

### 依頼元の会話への返答

Slack、Microsoft Teams、Discordから作成したTaskでは、その会話へ返答するrunがメッセージToolを呼ぶ前に完了することがあります。CognoがTaskを**進行中**で担当している間は、Taskと依頼元の会話を読み、何が起きたかを伝える補完runを1件キューします。別のrunが動いていれば、そのrunが終了するまで確認を待ちます。後続のrunが失敗しても同じです。複数の完了runが返答を待っている場合は、1件の補完runでまとめて確認します。

別のrunが送ったメッセージでは、この確認を取り消しません。そのrunが別の場所へ投稿していた場合や、新しい依頼が届く前に送信していた場合も、Cognoは依頼元の会話を確認します。

補完runは既存の会話を読んでから返答し、すでに答えがあれば何も送りません。新しい作業を始めず、自身の完了から次の自動補完runを作ることもありません。返答には、Projectの現在の連携権限とメッセージ送信への同意が引き続き必要です。TaskをCogno管理から外した場合は人の担当を保ち、この回復処理で再起動しません。

### リストから人の作業を開始する

**進行中**にある人のタブ、または開いているタブの下の行へTaskをドラッグします。Taskはその人の担当になり、その人のマシンへrunがキューされます。Projectページでは、サイドバーの一番上にある自分の名前へTaskを落とすと、自分について同じことが起きます。

* Projectにフォルダーが接続されていれば、runはすぐに開始します。
* 接続されていなければ、行に中抜きのブランチマークが出ます。ツールチップは\*\*\<名前> がフォルダを接続すると開始\*\*です。その人がフォルダーを接続した時点でrunは自動的に開始します。
* すでにあるEnvironmentで実行中のTaskは、その所有者から動きません。別の人の上に保持している間、レーンには\*\*\<名前> の環境に固定\*\*と表示され、落としても何も変わりません。
* runの実行中は、実行しているマシンだけでなく、workspaceの全員に行のマークが回転して見えます。

## ライフサイクルを進める

Task、行メニュー、リストやボードのドラッグ操作からステータスを変えます。

* 作業を開始せず**進行中**へ移動すると、\*メッセージを送信すると作業を開始します。\*と表示して拒否します。リストから作業を開始するには、**進行中**にある人のタブへTaskを落とします。詳しくは下の**リストから人の作業を開始する**を参照してください。
* 実行中に**進行中**から移動すると、\*\*実行中のrunを停止して移動しますか?\*\*を開きます。**停止して移動**を選ぶと、途中結果を残して実行を終了します。
* 完了した実行は、**バックログ**、**準備完了**、**レビュー中**を提案できます。提案を反映するとCognoの管理が解除されます。失敗または停止した実行はTaskを**進行中**に残します。
* Taskの会話で明確な返答をすると、ステータスを直接決められます。明示的な受諾はTaskを**完了**へ、延期は**準備完了**または**バックログ**へ、レビュー依頼は**レビュー中**へ、中止は**却下**へ移動します。意味が曖昧な場合、エージェントはTaskを移動する前に質問または報告します。
* 作業が終わったら、人が**完了**を選びます。

## 編集、アーカイブ、削除

Taskの説明には、ステータス、タグ、日付、担当者、Project、プレビュー、各種操作があります。説明はリッチテキスト、共同編集、バージョン履歴に対応します。

図と埋め込みページは、スクロールして近づいた時点で読み込みます。遠く離れた図や未操作の埋め込みページは解放し、戻ると再表示します。埋め込みページに入力・操作したあとは、その説明を開いている間は読み込み状態を保ち、フォームや再生の状態を保持します。

行の`...`メニューから**親タスク**を追加すると、Taskをトップレベルのタスクの下にぶら下げたり、別の親へ移したり、**親なし**で外したりできます。サブTaskを持つTaskはサブTaskにできません。

**アーカイブ**はTaskをアクティブなビューから外し、あとで元に戻せます。**完全に削除**はTask、サブTask、コメント、添付、履歴を削除します。実行したマシン上では、ローカルの会話と作業コピーも未コミットの変更を含めて削除します。

> [!WARNING]
>
> 完全に削除したマシンローカルの会話と、作業コピーの未コミット変更は復元できません。

## サブTaskを持つTaskを閉じる

Taskを**完了**、**却下**、**アーカイブ**へ移すと、開いているサブTaskも一緒に移り、そこで動いていたエージェントの作業は停止します。すでにアーカイブ済みのサブTaskはそのままです。親を**バックログ**、**準備完了**、**レビュー中**へ戻す操作は、サブTaskに影響しません。

開いているサブTaskがある場合、Cognoは移動する前に確認し、いくつ閉じるかを示します。**すべて閉じる**で実行し、**キャンセル**で何も変更しません。

移動から10分間は、トーストの**元に戻す**で操作全体を取り消せます。親と、その移動で閉じたサブTaskが、それぞれ元のステータスへ戻ります。移動のあとに自分で変更したサブTaskは、変更したままです。移動が停止した実行は再開しません。Taskは戻るので、必要なら実行し直してください。

<kbd>⌘</kbd>+<kbd>Z</kbd>（Windows と Linux では <kbd>Ctrl</kbd>+<kbd>Z</kbd>）でも、ワークスペースで最後に行ったステータス変更を取り消せます。**Done**・**Rejected**・**Archived** をはじめ、**In Progress** へ移した場合以外のすべてが対象です。続けて押すと、その前の変更も取り消します。複数選択してアーカイブしたTaskは、まとめて戻ります。テキスト入力中やダイアログを開いているあいだは、入力の取り消しとして働きます。

> [!NOTE]
>
> サブTaskは親のProjectに属します。TaskをほかのProjectへ移すとサブTaskも一緒に移り、ほかのProjectにある親の下にTaskを入れると、そのProjectへ移ります。

TaskまたはサブTaskに待機中の作業や実行中の会話があるときに別のProjectを選ぶと、**実行中のrunを停止して別のProjectへ移動しますか?**が開きます。**停止して移動**を選ぶと、キャンセルを要求します。Coreはすべての実行の停止確認が届くまで元のProjectを維持し、確認後にTaskとサブTaskを一緒に移動します。停止を確認できないときは、実行中のマシンでrunを終了してから再試行してください。移動結果を確認できないときは、再試行して結果を確認してください。停止を確定する前に**キャンセル**を選ぶと、runとProjectを変更しません。

古いrunでは、キャンセル済みでも停止確認の記録がない場合があります。確認済みの停止記録が得られるまでProjectの移動を保留します。キャンセル済みの表示だけでは、この保留は解除されません。

Project・フォルダ・マシンが変わったら、**引き継いで続ける**を選んでメッセージを送り、同じTaskを現在のProjectのフォルダで続行します。Taskの担当者本人で、そのProjectに利用可能なフォルダを設定している必要があります。以前の会話は履歴として残り、新しい会話にはTaskのdescription、未配信のメッセージ、取得できるbranch情報が渡ります。

元のbranch・checkpoint・未送信の変更が取得できなくても、descriptionと現在のファイルから作業内容が分かればエージェントは続行します。取得できた変更を保持し、必要に応じて欠けた作業を作り直し、引き継げなかった内容を記録します。必要な情報や権限が不足するときは確認します。

Projectを読み込めなくても、Task本文と成果物は引き続き表示されます。Projectの案内にある**再試行**を選択してください。実行先の確認中はチャットを表示しません。確認後もCloud Taskではチャットを非表示にします。

## 確認が必要なTask

リストとガントでは、前回の実行が失敗したTaskと、実行中のエージェントが承認を待っているTaskを強調します。ポインタを合わせると理由を確認できます。リストでは、サブTaskに確認が必要な場合に親Taskも控えめに強調します。

完了・アーカイブ・却下済みのTaskは対象外です。失敗後に直接実行へ引き継がれた場合も対象外です。最終更新からの経過時間だけでは強調しません。

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

| 症状 | 対処 |
| - | - |
| Taskを**進行中**へ移動できない | Taskでメッセージを送って作業を開始するか、**進行中**にある人のタブへTaskを落としてその人のrunをキューします。 |
| **進行中**の行に中抜きのブランチマークが出る | runがその人のフォルダーを待っています。その人のマシンでProjectにフォルダーを接続すると、runは自動的に開始します。 |
| Taskを人に落とすと\*\*\<名前> の環境に固定\*\*と出る | Taskはすでにその人のEnvironmentで実行中で、その人から動きません。 |
| Environmentメニューに実行先がない | フォルダーをProjectへ接続してから再試行します。 |
| **モデルを取得できません**と表示される | モデルメニューを開き、**モデルを再取得**を選びます。 |
| **この依頼を実行する Project を選んでください** と表示される | この依頼はまだ Project に入っていないため、作業するフォルダがありません。Task を Project に移してからもう一度送信します。入力した内容は残っています。 |
| ターンがキューに残る | 選択したマシンをオンラインにします。キューした作業はそのまま残ります。 |
| Taskが**Cogno**の下に表示される | Cognoがこの**進行中**のTaskを担当しています。最新のrunを確認し、次のターンを送るか、担当を変えるときにTaskを移動します。 |

その他の問題は[トラブルシューティング](/docs/ja/troubleshooting.md)を参照してください。

## 関連ドキュメント

* [Taskのステータス](/docs/ja/task-statuses.md)
* [Taskのビューとフィルタ](/docs/ja/task-views.md)
* [Taskをエージェントに実行させる](/docs/ja/agents.md)
* [Taskをターミナルで引き継ぐ](/docs/ja/task-sessions.md)

## デスクトップ内の移動

受信トレイ、ミーティング、すべてのタスクはサイドバー上部に表示されます。保存したビューはProjectより上にあります。Project名を押すとページを開きます。現在のProjectをもう一度押すと、作業中のTaskを展開・折りたたみます。開閉矢印でも同じ操作ができます。

**Projects**の横にあるフィルタボタンを押すと、表示するProjectを選べます。Projectの位置は変わらず、各行の右端がトグルに切り替わります。表示・非表示を選び、もう一度フィルタボタンを押して完了します。非表示にしたProjectは、サイドバーの一番下にある**非表示のProject**にまとまります。押すと開閉でき、開いた一覧からProjectを開いたり、目のボタンで再び表示したりできます。この操作で変わるのは自分のサイドバーだけです。Projectのアーカイブや内容には影響しません。非表示の設定はアカウントに保存され、デスクトップ、Web、モバイルアプリで共通です。モバイルアプリでは、Projectを長押しして出るメニューから**非表示にする**・**表示する**を選べます。

### サイドバーのTaskをpinする

サイドバーのTaskを右クリックして**Taskをpinする**を選ぶと、所属するProjectの一番上へ移動します。通常のTaskは**Cogno**グループより上にも表示できます。**Cogno**グループ内のTaskは、そのグループの一番上へ移動します。**Taskのpinを解除**でpinを解除します。

pinしたTaskは一番上に、ドラッグで並べた順に表示されます。Projectの下のそれ以外のTaskは、そのTaskに最後にメッセージが送られた時刻の新しい順に並びます。まだ誰もメッセージを送っていないTaskは作成した時刻で並びます。runが始まっても終わっても、Taskの位置は変わりません。

pinは自分のアカウントに保存され、サイドバーだけに適用されます。リスト・ボード・カレンダー・ガントのTaskの並び順には影響しません。

### サイドバーをキーボードで操作する

TabまたはShift+TabでProjectやTaskにフォーカスを合わせ、Enterで開きます。

Command+1〜9で、対応する順番のサイドバーのTaskを開きます。Taskのリスト画面やその検索欄からも使えます。サイドバーへフォーカスを合わせたり、先にCommandを長押ししたりする必要はありません。折りたたまれたTaskの行は飛ばして数えます。

| Taskの行にフォーカスがあるときのキー | 操作 |
| - | - |
| D | Taskを**完了**にします。 |
| A | \*\*このTaskをアーカイブしますか？\*\*を開きます。Enterで確定し、Escapeで取り消してTaskへフォーカスを戻します。 |
| P | Taskのサイドバーのpinを切り替えます。 |

ステータスの変更とアーカイブには、Taskを編集する権限が必要です。

サイドバーのTaskを右クリックしたメニューが開いているときも、P・D・Aを使えます。メニュー内の入力欄で文字を入力しているときには実行されません。

サイドバーを閉じてもタイトルバーの戻る・進むを利用できます。設定には専用の「作業に戻る」があります。

Task一覧のアドレスには適用済みの検索・絞り込み・並び順・表示形式が含まれ、戻る・進むで復元できます。Workspaceの入口を開くと、このウィンドウでアカウントとWorkspaceごとに記憶した直前の作業ページを開きます。明示的なリンクの移動先が常に優先されます。

ボード表示でステータス列を表示・非表示にすると、アドレスのステータス条件も更新されます。再読み込みや履歴で列の表示も復元します。

## mobileのTasks操作

Taskに**詳細**と**チャット**の両方が表示される場合、詳細から左へスワイプするとチャットを開きます。チャットでは、画面の左側3分の1から右へスワイプするとTask一覧を開き、それ以外の位置から右へスワイプすると詳細へ戻ります。切り替え中は、上部の選択表示が指の動きに追従し、指を離すと選択したタブへ収まります。短いスワイプを途中でやめると、現在のタブへ戻ります。

一覧は最初に、自分が担当するバックログ・準備完了・進行中・レビュー中のTaskを表示します。自分のTaskだけに絞り込んでいる場合も、filterボタンに絞り込み中であることを表示します。ボタンを開いて担当者とステータスの選択を確認してください。条件に合うTaskは200件を超えて取得します。下へ引いて再読み込みするか、Task・検索・別のタブから一覧へ戻ると最新の状態を取得します。

Task作成では写真・ファイルを合計20件まで、1件25MiBまで添付できます。その場で写真を撮る、既存の写真を選ぶ、ファイルを追加する方法があります。カメラや選択画面で失敗しても現在の入力は保持されます。

モバイルのTask作成とチャットでは、Desktopと同じモデル・effort・アクセスの設定を使えます。モデル・effortの選択は次の送信に反映されます。そのターンが開始すると、別の端末でもSessionの最新設定を表示します。その端末で未送信メッセージ用の設定を明示的に選んでいる場合は、その選択を維持します。送信が拒否された場合も、再試行用のモデル・effortを維持します。Sessionのアクセス更新に対応するEngineでは、アクセスの変更がすぐ既存Sessionに保存され、Desktopにも表示されます。実行中のターンへの適用は、プロバイダーに応じて即時または次のターンになります。古いEngineでは、既存Sessionのアクセス選択は無効になります。変更が拒否された場合は元の選択を維持し、エラーを表示します。Full accessはマシンの設定上限に従います。

モバイルのDiffでは既定のbranchとTaskの作業中の変更を比較します。**比較元**と**比較先**を選ぶとbranch同士も比較できます。差分一覧やファイルの読み込みに失敗した場合は、その場で再試行できます。

Taskを長押しすると、指を離す前にstatusメニューが開きます。変更先を選択してください。完了・アーカイブ・却下へ移す前に、サブTaskも閉じて実行を停止することを確認します。**進行中**へ移すにはTaskから作業を開始してください。

長押ししたまま上下へドラッグすると、同じstatus・同じ親・同じCogno担当状態のTaskの中で並べ替えできます。iOSでは親Taskを動かすとサブTaskも一緒に移動します。絞り込みで隠れたTaskも含めて順序を保存します。Taskの並べ替えは200件以下のProjectに対応します。

Projectの順序は、iOSではProject名を長押しして**上へ移動**・**下へ移動**を選んで変更します。Androidでは、Project名を長押ししたまま上下へドラッグして指を離します。並び順は自分のアカウントに保存されます。

Tasksのfilterで**ステータス**を開き、複数のstatusを続けて選択できます。選択してもメニューは開いたままで、選択状態が更新されます。メニューの外側を押すと閉じます。

### mobileで文章にコメントする

iOSでは、**詳細**や**チャット**の文章を長押しし、選択ハンドルを動かして引用する範囲を選びます。文字選択メニューの**コメント**を選ぶと、その範囲を引用します。iOSが利用可能と判断したコピー・すべて選択・調べる・翻訳・検索・共有などの標準操作も使えます。

Androidやネイティブの文字選択メニューがないアプリでは、文章を長押しして標準の文字選択操作を使います。文章の横にある**コメント**ボタンを押すと、その文章全体を引用します。

送信待ちのメッセージでは、レビューコメントを引用と読みやすい文章で表示します。送信待ちメッセージを編集するときは、本文と各コメントを別々の入力欄で編集できます。引用箇所とコメントの作成者は保持されます。

直してほしい内容を書いて**追加**を選びます。未送信のコメントはチャット入力欄の上に表示され、送信前に自分のコメントを編集・削除できます。\*\*レビューを送信 (件数)\*\*を選ぶと、未送信のコメントをまとめてエージェントへ送ります。次のチャットメッセージと一緒に送ることもできます。

説明へのコメントはDesktopと共有されます。チャットへの未送信コメントは現在の端末に保持されます。

### mobileで画像を表示する

Taskの説明やチャットの画像をタップすると、Mermaid図と同じように全画面で表示できます。**閉じる**を選ぶと元の画面へ戻ります。読み込んだ画像は端末にキャッシュされ、説明やチャットへ戻ったときに再利用されます。添付画像の読み込みに失敗した場合は、一時的なプレビューリンクを1回更新します。

### mobileでTaskのアクティビティを確認する

Taskの**詳細**を開いて**アクティビティ**を選ぶと、そのTaskの変更を新しい順に確認できます。各項目には、変更したメンバーと日時が表示されます。この履歴はTaskの変更が対象で、Cognoが外部サービスで行ったすべての操作の記録ではありません。

自分が行った最新のステータス変更をまだ元に戻せる可能性がある場合だけ、**取り消す**が表示されます。選ぶとサーバーが安全に戻せるかを再確認します。その後の変更や時間制限によって戻せない場合は**取り消しは利用できません**と表示し、成功扱いにしません。取消操作は対象の項目に表示します。そのほかの履歴には変更内容、メンバー、日時を表示します。

### モバイルでTaskを作成する

入力欄の上の行には、左からアクセス・モデル・effortを表示します。worktreeを作成する設定のProjectでは、右端に`stg`などの設定済みのbase branchを表示します。branch名を押すと、モデル選択と同じ形式の検索付きメニューから、Engineが返す別のbranchを選べます。選択は最初のSessionに適用され、変更しなければProjectに設定したbase branchを使います。変更確認の比較元と比較先は**Diff**で選びます。

worktreeを作成しない設定のProjectでは、右端に**このフォルダ**と表示します。別のworktreeを作らず、設定済みのフォルダーで直接実行を開始します。開始branchの選択は表示しません。

Project横の\*\*＋\*\*からTaskを作成できます。送信する前に画面を閉じても、タイトル・説明・添付の参照はアカウント／Workspace／Project別にこの端末へ保持します。**閉じる**で中断し、同じProjectの作成画面を開くと、タイトル・説明・添付から再開できます。Projectを切り替えると、そのProjectの下書きを表示します。送信すると、別の送信待ちデータを端末に保存し、編集用の下書きを消去します。未送信の下書きはサーバーへ保存しません。

**タイトル**と**やること**を入力し、Projectを選びます。**添付を追加**を押して、**写真を撮る**、**写真を追加**、**ファイルを追加**のいずれかを選びます。**写真を撮る**はカメラへのアクセスを求め、許可されていない場合は端末の設定を開く選択肢を表示します。**作成して実行**でTaskを保存し、説明に添付を追加してから作業を開始します。Projectに実行可能なマシン接続があると操作できます。モデル一覧の取得は作成を妨げません。モデル未選択時はEngineの既定の実行エージェントとモデルを使います。

タイトル・説明欄の上でモデルを選びます。モデルメニューを開き、**モデルを再取得**を選ぶと、タイトル・説明・添付を保ったまま選択肢を取得し直せます。接続先を取得できない場合もモデル欄に**再試行**が表示されます。

送信内容の保存と添付の端末内コピーが終わると、シートが閉じます。Taskの作成、添付のアップロード、実行の依頼が進む間も、アプリを操作できます。メイン画面で送信状況を確認できます。実行が受け付けられるとTaskは**進行中**になります。送信内容を保存しただけでは実行開始とは扱いません。

アプリを離れると未完了の送信を一時停止し、戻ると再開します。アプリを再起動した場合も再開します。作成・添付・実行に失敗した場合は、メイン画面から保存済みの送信を再試行できます。入力内容とコピー済みのファイルを保持し、Taskが作成済みなら同じTaskを使います。すべての添付が成功してから実行を開始します。実行に失敗しても、保存済みのTaskは削除しません。

### mobileのチャット入力

会話の上端近くまでスクロールすると、読んでいる位置を保ったまま以前のメッセージを自動で読み込みます。読み込みに失敗した場合は、表示された再試行ボタンを押してください。

既存Taskの未送信の本文・添付・選択設定は、アカウント・Workspace・Task別にこの端末へ保持します。別のTaskへ移動したり、アプリを離れたりしても、戻って続きを入力できます。下書きは別の端末へ同期せず、サーバーへ保存しません。選んだ添付はアプリのDocument領域へコピーします。ファイルを読めない場合は添付を残し、削除して再添付するよう表示します。

送信成功時は送った内容だけを消し、送信中の追加入力を残します。送信に失敗すると元の内容が追加入力の前に戻ります。保存・復元のエラーが出た場合は、画面を離れる前に**再試行**してください。共有Sessionへ保存済みの設定は、そのSessionに残ります。

同じアプリ起動中は、画面を離れてTaskへ戻ってもアップロードの進捗を保持します。送信結果が分かる前にアプリが終了した場合は入力を復元します。再送する前に、そのメッセージが会話に届いていないか確認してください。

Taskの会話は最新のメッセージから開きます。同じアプリ起動中に開いた会話は、新しいメッセージの同期中も表示されます。会話の上にある**以前のメッセージを読み込む**を選ぶと以前の作業を読めます。**最新へ**を選ぶと最新のメッセージに戻ります。

Taskの入力欄に表示されたモデルをタップし、Engineが提供するモデルを選びます。最初のSessionを開始する前はexecutorも選べます。**モデルを再取得**で選択肢を取得し直せます。対応するEngineではアクセスのアイコンをタップし、マシンで許可された範囲内で**確認**・**自動**・**フルアクセス**を選びます。**フルアクセス**の確認は、この端末でマシンごとに記憶します。選択メニューの外側をタップすると閉じます。

操作欄のアクセス設定は、モデル名のスペースを確保するためアイコンで表示します。**確認**は手、**自動**はゲージ、**フルアクセス**はオレンジの警告付きの盾です。メニューを開くと、選択中のアクセス名とチェックマークを読めます。**再試行**はマシンの権限を取得できなかった場合だけ表示します。

操作欄の上にある全幅の入力欄へ本文を書きます。**+**を押して、**写真を撮る**、**写真を追加**、**ファイルを追加**のいずれかを選びます。**写真を撮る**はカメラへのアクセスを求め、許可されていない場合は端末の設定を開く選択肢を表示します。画像はプレビューが表示され、送信前に削除ボタンで添付を外せます。1つのメッセージには20件まで、1件あたり25MBまでのファイルを添付でき、本文なしでも添付を送信できます。画質を下げずにファイルを1件ずつ小さく分割してアップロードします。プレビューには進捗の割合が表示され、完了すると**アップロード済み**になります。すべての添付がアップロードされてからメッセージを送信します。

送信に失敗した場合は会話を開いたまま送信ボタンをもう一度押してください。本文と写真は入力欄に保持され、利用可能な成功済みアップロードは再利用します。更新を案内された場合は、パソコンのCognoを更新してからMobileの添付を送信してください。

### mobileでbranchを比較する

Taskの**変更**では、repositoryごとに**比較元**と**比較先**の行があります。iOS・Androidともに行をタップするとremote branchの検索付き一覧が開きます。検索キーボードが開いた状態でも、branchをタップして選択できます。両方の選択は変更ファイル一覧と各ファイルの差分に反映されます。選択はrepositoryごとに保持され、Taskを離れるか実行環境を変えると既定に戻ります。

**比較元**で**既定のbranch**、**比較先**で**作業中の変更**を選ぶとTaskの変更に戻ります。選んだbranchが削除された場合は、同じ行から既定の選択肢か別のbranchを選び直してください。変更がないrepositoryや比較に失敗した場合も行は表示されます。branchの取得に失敗した場合は、エラー文を押して再試行できます。

## 説明の履歴を確認する

WebとDesktopでは、Taskの説明にある**説明の履歴**から保存済みの版を選べます。スクロールに合わせて続きや前の範囲を読み込みます。読みたい版を選び、現在の説明に戻るには**現在**を選びます。読み込みに失敗した場合は**再試行**を選びます。

## 親Taskの候補を探す

**親タスク**、またはフル作成フォームの**親タスク…**を開くと候補を表示します。スクロールで続きを読み込み、前の候補にも戻れます。検索は未取得の候補も対象です。読み込めない場合は**再試行**を選びます。別の候補を探している間も、選択した親Taskのタイトルは表示されます。


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