> ## 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の集合は4通りに並べられ、クエリバーで絞り込め、サイドバーに View として保存できます。このページはそれらの操作のリファレンスです。task自体の意味は
[5つのstatus](/docs/ja/task-statuses.md)にあります。

## 日付と Workspace のタイムゾーン

期限表示の「今日」「明日」、Calendar と Gantt の今日の位置、期限設定のショートカット、
`due:` と `start:` の相対日付による絞り込みは、Workspace のタイムゾーンを使います。
Cogno agent も、相対日付やタイムゾーンを省略した定期実行に同じ基準を使います。
別のタイムゾーンを明示した予定には、その指定が適用されます。

Workspace のタイムゾーンを変更すると、これらの日付の判定も更新されます。
Task の開始日と期限日はカレンダー上の日付を保持します。

コメントや会議の日時は端末のタイムゾーンで表示します。
端末のタイムゾーンを変更すると、表示時刻も変わります。
共有の期限判定と定期実行には、それぞれ設定されたタイムゾーンを使います。

## 4つのレイアウト

Tasksページまたはprojectのページで、ヘッダーのセレクター（**タスクビューを切り替え**）から
切り替えます。projectではどのレイアウトもそのprojectのtaskだけを表示します。選んだレイアウトは
ワークスペースごとに記憶されます。

| ビュー | 何のためのものか |
| - | - |
| **リスト** | グループ分けされ、並べ替えできる表 — 既定のレイアウト。 |
| **ボード** | かんばん。カードをドラッグしてstatusを変えたり並べ替えたりします。 |
| **カレンダー** | taskを日付の上に置きます。ドラッグで日程を変更できます。 |
| **ガント** | 開始日と期限による時系列。 |

`?layout=calendar` や `?layout=gantt` で特定のレイアウトへ直接リンクできます。

### リスト

* 一覧の一番上は**進行中**で、人ごとのタブを持つ1本のレーンです。開いているタブに、その人の実行中と
  待機中の作業が並び、Cogno自身の作業は**Cogno**グループに入ります。持ち主のいないrunは**担当なし**に
  入ります。名前が収まらなくなると、開いていないタブはアバターだけを表示します。
* ステータスのセクションは、空でも常に表示します。見出しに件数は付きません。
* そのあとにステータスのセクションが続きます — **レビュー中 → 準備完了 → バックログ**、フィルタに含めていれば完了も表示します。Cogno管理中の準備完了Taskは、準備完了の中にある**Cogno**グループへ入ります。
* 既定の列はtaskと **担当者**、**期限** です。**Status**、**サブタスク**、**Source**、
  **作成日**、**プロジェクト** を追加の列として出せます。
* 行を別のセクションへドラッグするとstatusが変わり、**進行中**にある人のタブへドラッグするとその人のrunを開始します。複数の行をまとめて操作するには **一括編集** を使います —
  [複数のtaskをまとめて編集する](#複数のtaskをまとめて編集する)を参照。
* ドラッグ中、一覧の中は何も動きません。落ちる先のセクションを白い枠が、元のセクション内の位置を白い線が示し、タイトルのチップがポインターに付いてきます。

### ボード

* 列は **バックログ → 準備完了 → 進行中 → レビュー中 → 完了** の順です。**完了**・**アーカイブ**・
  **却下** の列は最初は非表示で、ボードの表示切り替えから出せます。
* もうひとつの操作で、列を **Status**・**ユーザー**・**プロジェクト** のいずれかでグループ化できます。グループ化はワークスペースごとに記憶されます。**ユーザー**列の見出しには人間のメンバーのアバターとTask数が表示されます。Cognoだけが担当するTaskは空のCogno列ではなく**未割り当て**に入ります。
* Cogno管理中のtaskは、**ユーザー**や**プロジェクト**でグループ化した場合も含め、各列の先頭にある暖色の**Cogno**グループへまとまり、折り畳めます。配置はstatusが決め、提案のメタデータが別の仕切りや順番を作ることはありません。
* **Status**でグループ化しているとき、カードをドラッグしてstatusを変えたり並べ替えたりできます。リストと同じく、元のカードはグレーのまま動かず、タイトルのチップがポインターに付き、別の移動先の列を白い枠、元の列での挿入位置を白い線が示します。元の列には枠を付けません。
* **ユーザー**でグループ化しているとき、別の人の列へカードをドラッグすると主担当が変わります。**未割り当て**へ移すと担当者をすべて外します。人の列へ移す場合、移動した担当者以外の共同担当者は元の列に残ります。移動先の列だけに枠が付き、元の列には付きません。Environmentに結び付いたTaskは、別の持ち主へ移せません。
* 実行していないtaskは、**進行中**へドロップするだけではstatusが変わりません。Taskからrunを開始し、runとstatusを同時に始めます。
* 列見出しの **+** は、その列に直接taskを作ります。
* デスクトップでは、ボード全体がウィンドウ内に収まります。長い列だけが個別にスクロールし、クエリとView切替はその場に残ります。
* 列の合計幅がウィンドウを超える場合は、ボードを横にスクロールして各列を確認します。一番左まで戻すと、最初の列全体が見えます。

### カレンダー

* 月表示と週表示のtaskは、リストと同じコンパクトなマークを使います。status、実行状態、子task、Cogno管理、担当者を同じ並びで確認できます。
* カレンダーの面は中立色です。Statusは共通の小さなマークで示し、Cogno管理中のtaskにはリストのCognoグループと同じ暖色を使います。
* 年表示では日付を中立色のまま保ち、日付の下に最大3つのstatusマークを表示します。日付を選ぶと、その週を開きます。
* Taskを別の日へドラッグすると期限を変更できます。
* デスクトップのカレンダーはウィンドウ内に収まります。年表示は12か月を4列×3行で表示し、内部スクロールは使いません。週表示の内容が長い場合だけ、カレンダー内部をスクロールします。

### ガント

* 日程があるTaskは中立色のタイムラインバーに表示され、リストと同じstatus、実行状態、子task、Cogno管理、担当者のマークを使います。
* 日程が揃っていないTaskは**Unscheduled**に残ります。ここではstatus、期限、担当者を含む通常のリストTask行を使います。Cogno管理中のTaskは、リストやボードと同じ暖色の**Cogno**グループにまとまり、折り畳めます。
* UnscheduledのTaskをprojectのタイムラインへドラッグすると日程を設定できます。日程があるバーはドラッグまたは端のサイズ変更で期間を変えられ、左右端に保持するとタイムラインが横へスクロールします。
* デスクトップでは、タイムラインと**Unscheduled**一覧が別々にスクロールするため、一方の操作でもう一方は動きません。クエリとView切替はその場に残ります。

## 複数のtaskをまとめて編集する

ヘッダーの **一括編集** を押すと、一覧が選択のための画面になります。各行にチェックボックスが付き、
下部のバーに操作が集まります。このトグルはリストのレイアウトに出ます。projectのtask一覧にも、
フィルタの隣に同じトグルがあります。

**1. 一括編集をオンにする**

**一括編集** を押します。各行の左端にチェックボックスが付き、行をクリックすると
taskが開くのではなくチェックが入ります。

**2. 対象の行にチェックを入れる**

Shiftを押しながら行をクリックすると、最後にチェックした行からその行までがまとめて選ばれます。
**すべて選択** は画面に出ている行すべてにチェックを入れ、**選択を解除** はすべて外します。

**3. 選んだ集合に操作を実行する**

バーには **N件を選択中** と出ます。**操作** を開いて変更したい内容を選ぶと、
チェックの入ったtaskすべてに適用されます。

| 操作 | チェックした各taskに何が起きるか |
| - | - |
| **ステータス** | **バックログ**・**準備完了**・**レビュー中**・**完了**・**アーカイブ** のいずれかにします。進行中 は選べません — taskは実行が始まることでその状態に入ります。 |
| **期限** | **今日**・**明日**・**来週**、**日付を選択** で選んだ日付、または **期限をクリア**。 |
| **プロジェクト** | 選んだprojectへまとめて移します。 |
| **アーカイブ** | まとめてアーカイブします。 |
| **削除** | 件数を示す確認のあと、完全に削除します。 |

**ステータス** と **プロジェクト** は、選択中のtaskがすでに持っているものを示します —
全部が同じならチェック、一部だけならダッシュです。期限は内容が揃っていないとき **混在** と出ます。
担当者はtaskごとの操作のままで、この一覧には入りません。

閉じるボタン（**一括編集を終了**）でモードを抜け、チェックは破棄されます。レイアウトを切り替えたり
ページを離れたときも同じです。ここでの操作はすべて書き込みなので、トグルはコンテンツを編集できる
メンバーにのみ表示されます — 閲覧者には出ません。

> [!TIP]
>
> 一括編集をオンにしなくても、Shiftを押しながら行をクリックすれば選択できます — 一括編集は
> 同じ選択への見える入口です。projectのtask一覧では、選択中の行をどれかドラッグすると、
> その集合ごとドロップ先のセクションへ移動します。

## クエリバー

taskの上のクエリバーが、いま見ているビューを絞り込み・検索します。空白区切りの `key:value`
トークンと自由入力のテキストを受け取ります。ひとつのトークンの中でカンマ区切りにした値はORになります — `status:backlog,ready` はどちらにも一致します。トークンを打つ必要はありません。
**フィルタ** パネルでStatus・タグ・プロジェクト・担当者・開始日・期限 を選ぶと、同じクエリが組み立てられます。

既定のクエリは開いている4つのstatus — `status:backlog,ready,in_progress,in_review` — で、絞り込みはワークスペースごとに記憶されます。

| トークン | 値 | 一致するもの |
| - | - | - |
| `status:` | `backlog` · `ready` · `in_progress` · `in_review` · `done` · `archived` · `rejected` | そのstatusのtask。廃止された語彙やGitHub風の別名も解決されます — [古い語彙](/docs/ja/task-statuses.md#古い語彙)を参照。 |
| `tag:` | タグ名 | そのタグが付いたtask。パネルからタグなしのtaskも選べます。 |
| `project:` | projectのid | そのprojectのtask。 |
| `assignee:` | メンバーのid | そのメンバーに割り当てられたtask。パネルから **未割り当て** も選べます。 |
| `due:` | `overdue` · `today` · `week` · `none` | 期限による絞り込み。 |
| `start:` | `started` · `today` · `week` · `none` | 開始日による絞り込み。 |
| `parent:` | taskのid | そのtaskのサブタスク。 |
| *(自由入力)* | 任意の語、または `#123` | タイトルにその語を含むtask、またはtask番号が一致するもの。 |

## 保存したView

選択中の保存済みビューをもう一度選んでも、そのビューを表示し続けます。別の画面へ移動するには、サイドバーの**All tasks**または別の移動先を選択します。

よく使う絞り込みは、サイドバーのViewのセクションに置けます。その一番上に固定されている
**すべてのタスク** は、projectをまたいだすべてのtaskです。

* **作る** — 一覧を絞り込んでから、フィルタパネルの **View として保存** を選びます。ダイアログで名前とアイコン、そして公開範囲 — 自分だけか、ワークスペース全員か — を指定します。
* **編集する** — 保存したViewを開いた状態で絞り込みを変えると、ヘッダーに **保存**（変更を書き戻す）、**新しい View として保存**（枝分かれさせる）、**リセット**（保存済みのクエリに戻す）が出ます。ダイアログからは名前・公開範囲・アイコンも変えられます。
* **消す** — サイドバーのそのViewの行から、確認のうえ削除します。

## 何が記憶されるか

| 挙動 | 詳細 |
| - | - |
| レイアウト | ワークスペースごとに記憶。 |
| ボードのグループ化 | ワークスペースごとに記憶。Tasksページでは Status / ユーザー / プロジェクト、projectのページでは Status / ユーザーを選べます。 |
| ボードの列の表示 | 記憶されます。完了 / アーカイブ / 却下 は最初は非表示。 |
| 絞り込み | ワークスペースごとに記憶され、次に開いたときに復元されます。保存したViewは自分のクエリを持ちます。 |
| projectページの絞り込み | projectごとに記憶され、次に開いたときも絞り込んだままの状態で開きます。 |
| ボード・カレンダー・ガントでのドラッグ | status、並び順、日付が保存されます。 |

## 関連ドキュメント

* [Tasksを扱う](/docs/ja/tasks.md) — これらのビューが映すtaskの作成・整理・移動。
* [5つのstatus](/docs/ja/task-statuses.md) — セクションや列が何を意味するか。
* [projectを用意する](/docs/ja/projects.md) — projectのページにも、そのprojectに絞った4つのレイアウトとクエリバーがあります。


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