> ## 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.

# CSVからTaskをImportする

> Linear、Notion、GitHub、Asana、JiraのTaskを、column・status・memberを確認しながらCognoへ移します。

CSVを読み込み、各columnをCognoのfieldへ対応付け、source側のstatusとpersonを確認してからTaskを作成します。CSV Importは1回限りの処理です。継続的にGitHubやSlackのactivityを受け取る場合は[連携](/docs/ja/integrations.md)を使います。

## 前提条件

* header行とTaskごとのdata行を含むCSV
* assigneeやcollaboratorを対応付ける場合は、先に[memberを招待](/docs/ja/getting-started.md)する
* `2026-06-11` のような絶対日付
* subtaskがある場合は、title・source URL・external IDなど安定したparent参照

## CSVをImportする

**1. source appからCSVをExportする**

下記のsource別recipeを参照してください。

**2. Task importを開く**

**設定 → 一般** の **Task import** cardへCSVをdropするか、**Choose Task CSV** を選びます。

**3. すべてのcolumnを対応付ける**

**Column mapping** で各columnをCogno fieldへ対応付けます。取り込まないcolumnは **Do not import** を選び、自動推測された対応も確認します。

**4. statusとmemberを対応付ける**

**Status mapping** でsource statusをCogno statusへ、**Member mapping** でsourceのpersonをworkspace memberへ対応付けます。割り当てない場合は **Do not assign** を選びます。

**5. previewを確認してImportする**

**Preview** を確認し、各fileを **Mapping complete** にして **Import** を選びます。fileごとに作成・skip・error件数が表示されます。

**6. 作成されたTaskを確認する**

[Task](/docs/ja/tasks.md)を開き、title、status、assignee、Project、parent link、source URLを確認します。

## Status mapping

Import先として **Backlog**、**Ready**、**In Review**、**Done**、**Archived** を選べます。**In Progress** はqueue中または実行中の作業専用、**Rejected** はCognoの提案を却下するためのstatusなので表示されません。status cellが空の行は **Ready** になります。元の値はImport metadataに保持されます。

| Import先 | source側の例 |
| - | - |
| **Backlog** | Backlog、Triage、Idea、Todo、Open |
| **Ready** | Up next、Selected、人が実行を決める予定済みの作業 |
| **In Review** | In review、Awaiting review |
| **Done** | Done、Closed、Completed、Resolved |
| **Archived** | Cancelled、Won't fix |

## Member mapping

| source値 | 動作 |
| - | - |
| member名と一意に一致 | memberを自動選択 |
| 1つのcellに複数名 | comma、semicolon、改行で分割 |
| 先頭のassignee | primary assigneeに設定 |
| 2人目以降 | collaboratorに設定 |
| 不明または曖昧 | 手動選択、または **Do not assign** |

## Parent Task mapping

subtaskがある場合はparent参照columnを **Parent Task** へ対応付けます。同じImport batch、過去にImportしたTask、title、source URL、Import metadataからparentを解決します。

* Taskのnestは1階層です。
* 曖昧な参照やcycleはlinkだけをskipし、child Taskは作成します。
* parentとchildが別fileの場合はparentを先にImportします。

## Field reference

| Cogno field | 必須 | 複数column | 用途 |
| - | - | - | - |
| **Task title** | Yes | Yes | 複数columnはspaceで結合 |
| **Description** | No | Yes | 複数columnは空行で結合 |
| **Status** | No | No | Import前にstatus値を対応付け |
| **Assignee** | No | No | primary owner |
| **Collaborators** | No | Yes | 追加のowner、follower、reviewer、participant |
| **Due date** | No | No | Taskの期限 |
| **Start date** | No | No | Taskの開始日 |
| **Project** | No | No | 名前でProjectを再利用または作成 |
| **Parent Task** | No | No | 1階層のparent参照 |
| **Source** | No | No | 元appのURL |
| **Metadata** | No | Yes | label、priority、estimate、ID、timestampなど |
| **Do not import** | No | Yes | 無視するcolumn |

すべてのcolumnを対応付けるか明示的に無視し、少なくとも1つの **Task title** columnを指定します。

### Date values

`2026-06-11`、`2026/06/11`、`06/11/2026`、`11/06/2026`、`Jun 11, 2026`、`June 11, 2026` を受け付けます。timestampは先頭10文字がISO dateの場合に使えます。`tomorrow` や `next Friday` のような相対表現は使えません。

### Limits

| Limit | Value |
| - | - |
| header行 | 必須。data行も1行以上必要 |
| column | 最大100 |
| cell長 | 最大20,000文字 |
| requestごとの行数 | 250。大きなfileはbatch送信 |
| requestごとのtext | 最大1,500,000文字 |

一部のbatchだけ成功した場合、先に成功したTaskは保存済みです。Taskを再読込し、残りだけを再Importします。

## source別のExport recipe

> **Linear**
>
> issue list、Project、viewを開き、`Cmd/Ctrl + K` から **Export issues as CSV** を選びます。title、description、status、assignee、Project、due date、parent issueを対応付けます。

> **Notion**
>
> database右上のmenuから **Export → Markdown & CSV** を選び、展開したdatabase CSVをuploadします。page titleをTask title、PeopleをAssignee、relationやrollupをMetadataへ対応付けます。

> **GitHub Issues**
>
> browserにCSV Exportがないため、GitHub CLIなどでissueのtitle、body、state、assignees、milestone、URLをCSVへ出力します。`open` はBacklog、`closed` はDoneへ対応付けられます。

> **Asana**
>
> Projectのtitle横にあるdropdownからCSV Exportを選びます。Task name、Notes、Section、Assignee、Collaborators、Due Date、Projectsを対応付けます。

> **Jira Cloud**
>
> Projectの **List** または **Filters → Search work items** でfilterを適用し、more-actions menuから **Export CSV - all fields** を選びます。Summary、Description、Status、Assignee、Due date、Project、Parent、Issue keyを対応付けます。

## Troubleshooting

| 症状 | 主な原因 | 対処 |
| - | - | - |
| fileを読めない | header行またはdata行がない | headerと1行以上のTaskを確認 |
| **Mapping complete** が無効 | 未決定のcolumn・status・memberがある | すべて対応付ける |
| **Task title column is required.** | title columnがない | 空でないtitle・name・summaryを指定 |
| 単一値fieldに複数column | StatusやAssigneeへ複数columnを指定 | 1つを残し、他をMetadataかDo not importへ移す |
| assigneeが見つからない | workspace memberではない | 招待するかDo not assignを選ぶ |
| dateが無効 | 相対表現または未対応format | 対応する絶対日付へ変換 |
| parentが見つからない | parent参照が不安定または欠落 | parentを先にImportし、安定したIDかURLを使う |
| 文字化けする | UTF-8ではない | UTF-8で再Exportする |

## 関連docs

* [TaskをExportする](/docs/ja/export.md)
* [Taskを扱う](/docs/ja/tasks.md)
* [連携](/docs/ja/integrations.md)


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