タスクCSVをCognoにインポートする

このガイドは、他のシステムのタスクデータを Cogno に移すための手順です。Cogno はCSVを読み込み、すべての column を確認し、source statuses と members を mapping してから tasks を作成します。

CSV importを使う場面

CSV import は次の用途に向いています。

• Linear、Notion、GitHub Issues、Asana、Jira Cloud、その他 task system から移行する。
• tasks 作成前に mapping を確認したい。
• source URLs、IDs、labels、milestones、priorities、custom fields を metadata として残したい。
• one-time migration または controlled batch import を行う。

CSV import は tasks を作成します。live sync ではありません。

Export前の準備

source system 側を先に整えます。

assignees または collaborators を Cogno members に mapping したい場合は、import 前に members を招待します。

Import flow

1. source app からCSVを export します。
2. Cogno app を開きます。
3. target workspace を選択します。
4. Settings > General を開きます。
5. Task import に1つ以上のCSVを drop するか、computer から選択します。
6. uploaded file を選び、mapping を確認します。
7. すべてのCSV column を Cogno field に map するか、Do not import を選択します。
8. すべての source status value を Cogno status に map します。
9. source assignees と collaborators を workspace members に map するか、Do not assign を選択します。
10. mapped preview を確認します。
11. 各 file で Mapping complete を選択します。
12. Import を選択します。
13. Tasks page で作成された tasks を spot-check します。

Supported sources

Cogno fields

すべての column は map するか、明示的に ignore する必要があります。

Column mapping rules

• Task title は required です。
• Status、Assignee、Due date、Start date、Project、Parent Task、Source はそれぞれ1つのCSV column だけに map できます。
• Task title、Description、Collaborators、Metadata、Do not import は複数CSV columns を受け取れます。
• empty title rows は skipped されます。
• unsupported fields は rejected されます。
• Source URL と metadata は task import metadata に保存されます。

Date values

Cogno は一般的な absolute date formats を受け付けます。

先頭10文字が ISO date になる timestamps は処理できます。

Status mapping

Cogno statuses は次の通りです。

• proposed
• active
• backlog
• completed
• archived

CSV column を Status に map すると、importer は source status values を一覧化します。file を complete にする前にすべての source values を mapping してください。

source status は Cogno status に変換されます。source-specific な分類を残す場合は、import 後に workspace tag として管理します。

Member mapping

source assignees と collaborators を Cogno workspace members に map します。

CSVに people が含まれる場合は、import 前に members を招待します。

Parent task mapping

source system に subtasks がある場合、parent reference column を Parent Task に map します。

Cogno は parent reference を次の対象から解決します。

• 同じCSV import batch 内の tasks。
• 同じ workspace で過去に import された tasks。
• import metadata values、source URLs、task titles、CSVから作られた task titles。

Rules:

• Cogno は1 level の task nesting に対応します。
• child は同じ file で import された parent に link できます。
• child は reference が metadata に残っている過去 import の parent に link できます。
• ambiguous parent references は skipped されます。
• cycles は skipped されます。

source export が parents と children を分ける場合、大きな migration では parents を先に import します。

Import limits

large files は batches に分けて送信されます。batch が partially succeed した場合、Cogno は created、skipped、error counts を表示します。

Linearからexportする

Linear は issue views、projects、custom views、workspace-level export tools から issue CSV export に対応しています。

推奨手順:

1. 移したい issue list、project、custom view を開きます。
2. Cmd/Ctrl + K で command menu を開きます。
3. Export issues as CSV を選択します。
4. downloaded CSV を Cogno に upload します。

推奨 mapping:

Notionからexportする

Notion Markdown & CSV export の中にあるCSVを使います。

推奨手順:

1. tasks を含む Notion database を開きます。
2. 右上の page menu を開きます。
3. Export を選択します。
4. Markdown & CSV を選択します。
5. export を download して unzip します。
6. database CSV を Cogno に upload します。

推奨 mapping:

GitHub Issuesからexportする

GitHub Issues には browser CSV export がありません。GitHub CLI で issue data を JSON として取り出し、CSVに整形します。

gh auth login

REPO="OWNER/REPO"
OUT="github-${REPO//\//-}-issues.csv"

gh issue list -R "$REPO" --state all --limit 1000 \
  --json number,title,body,state,stateReason,labels,assignees,milestone,createdAt,updatedAt,closedAt,url \
  --jq '(["number","title","body","state","stateReason","labels","assignees","milestone","createdAt","updatedAt","closedAt","url"], (.[] | [.number,.title,.body,.state,(.stateReason // ""),([.labels[].name] | join(";")),([.assignees[].login] | join(";")),(.milestone.title // ""),.createdAt,.updatedAt,(.closedAt // ""),.url])) | @csv' \
  > "$OUT"

推奨 mapping:

repository 全体を出す場合は --limit を十分大きくします。subset が必要な場合は --search を使います。

Asanaからexportする

project CSV export が一番扱いやすい task set です。

推奨手順:

1. Asana project を開きます。
2. project title の横の dropdown を開きます。
3. project export menu から CSV export option を選択します。
4. CSV を Cogno に upload します。

推奨 mapping:

Jira Cloudからexportする

Jira Cloud は project list または global work item search から work items を export できます。

推奨手順:

1. Jira project を開いて List を選ぶか、Filters > Search work items を開きます。
2. import したい work items の query または filter を適用します。
3. more actions menu を開きます。
4. Export を選択します。
5. Export CSV - all fields を選択します。
6. CSV を Cogno に upload します。

推奨 mapping:

comments と custom fields が必要な場合は all fields を使います。Jira Cloud は CSV を UTF-8 で export します。

Import後に検証する

少なくとも5件の tasks を spot-check します。

Troubleshooting

症状別の切り分けは Troubleshooting を見てください。

LLM handoff

assistant に import を手伝わせる場合は、次を渡します。

1. source app name
2. CSV header row
3. sensitive values を削除した representative rows 3件
4. desired Cogno field mapping
5. status mapping decisions
6. assignee mapping decisions
7. parent task strategy
8. import error messages

このページの Copy for LLM を使うと、complete import rules を Markdown context として渡せます。

Official references

• Linear exporting data
• Notion export your content
• GitHub CLI gh issue list
• GitHub CLI formatting
• Asana project importing and exporting
• Jira Cloud CSV export