ガイド・リソース

AnkiからDeckbaseへの移行プレイブック

APKGとCSV経路のための低リスクな移行ワークフロー。インポート速度が定着品質を損なわないよう、明示的な品質ゲートを備えています。

Deckbase編集チーム8分で読了

このプレイブックの対象者

本ガイドは、すでにアクティブなAnkiデッキを持っており、毎日の復習の一貫性を崩さずに構造的にDeckbaseへ移行したい学習者向けです。anki import csvを検索している場合、これは素早い転送と品質安定化を切り分けた実装パスです。

移行前チェックリスト

  1. 1
    最初のインポート前に、すべてのソースデッキをバックアップしましょう。
  2. 2
    過去30日間のアクティブなデッキを一覧化し、それらを先に移行しましょう。
  3. 3
    1つのデッキを超えて規模を拡大する前に、合否の品質ゲートを定義しましょう。
  4. 4
    習慣の継続を守るため、1日の復習の最低ライン(時間ベースまたはカード数ベース)を設定しましょう。

経路A: APKG優先の移行

速度と構造の保持が最も重要な場合はAPKGを使いましょう。この経路は、目的が完璧なクリーンアップではなく継続性である最初の移行波に最適です。

  • アクティブなデッキを1つインポートし、すぐに30枚のサンプルを確認しましょう。
  • 影響の大きい問題のみを修正しましょう: 読めないプロンプト、壊れたメディア、明らかな重複。
  • 大規模な見た目の編集のために一時停止するのではなく、同日中に復習を再開しましょう。

経路B: CSV優先の移行

フィールドレベルの正規化が必要な場合はCSVを使いましょう。CSVは事前準備に時間がかかりますが、規模拡大時の命名の一貫性、テンプレートルール、重複排除を徹底しやすくなります。

  1. 1
    インポート前にフィールド名と用語のフォーマットを正規化しましょう。
  2. 2
    プロンプト、答え、タグ、コンテキストのための1つの正規マッピングを作成しましょう。
  3. 3
    まずパイロットバッチをインポートし、本格ロールアウトの前にすべての品質ゲートを通過させましょう。

フィールドマッピングマトリクス

Front

目的
プロンプトテキスト
品質ルール
1つの概念のみ
運用上の注意
インポート前に詰め込みすぎたカードを分割

Back

目的
期待される答え
品質ルール
直接的な答えを最初に
運用上の注意
長い説明はノートに残す

Tags

目的
トピックのグループ化
品質ルール
一貫した分類体系
運用上の注意
分野/章の命名を使用

Extra / Notes

目的
コンテキストのサポート
品質ルール
短く任意
運用上の注意
答えのヒントの埋め込みを避ける

Media

目的
視覚/音声のコンテキスト
品質ルール
添付され読み取り可能
運用上の注意
サンプルで壊れた参照を確認

バッチ品質ゲート

新しいインポートバッチごとにゲートを実行しましょう。1つのゲートが失敗した場合は、新規インポートを一時停止し、まずカード品質を修正しましょう。これにより問題を小さく保ち、滞留負債を防げます。

理解度

合格しきい値
サンプルカードの90%以上が理解可能
不合格のシグナル
プロンプト形式が曖昧またはノイズが多い

重複率

合格しきい値
表面プロンプトの重複が3%未満
不合格のシグナル
バッチに定義や見出しの繰り返しがある

セッション負荷

合格しきい値
週ごとのセッション時間増加が15%未満
不合格のシグナル
インポートされたカードが冗長すぎる

失念傾向

合格しきい値
2週目までに安定または改善
不合格のシグナル
コアトピックのプロンプト品質が低い

規模拡大前に対処すべきAnki固有のエッジケース

ほとんどの移行の後退は、サンプルでは小さく見えるが規模が大きくなるとコストの高いエッジケースから生じます。追加のデッキをインポートする前に、クローズの表示、一時停止状態、リーチ(頻出失敗カード)の挙動、メディア参照を確認しましょう。

クローズカード

よくある失敗
インポート後にクローズマーカーが欠落
緩和策
本格移行前にサンプルのクローズ表示を検証する

一時停止カード

よくある失敗
予期しないアクティブな復習負荷
緩和策
一時停止状態をエクスポートし、インポート後に再適用する

リーチカード

よくある失敗
慢性的な失敗がキューを汚染する
緩和策
リーチにタグを付け、書き直し/アーカイブ方針を実行する

メディア参照

よくある失敗
壊れた画像・音声ポインタ
緩和策
最初の100枚で壊れたメディアのスキャンを実行する

デッキオプション

よくある失敗
間隔挙動の不一致
緩和策
追加デッキを拡大する前に14日間の指標を確認する

繰り返し可能な移行のためのCSVインポート契約

繰り返しインポートを行う場合は、固定のCSV契約を定義してバージョン管理しましょう。これにより担当者間のスキーマのずれが減り、QA自動化が容易になります。実践的な基準は、識別子、プロンプト、答え、コンテキスト、分類、ソースの各フィールドを持つ6列の契約です。

note_id

役割
安定した行の識別子
制約
誤った重複取り込みを防ぐ

front_text

役割
プロンプトフィールド
制約
句読点とUnicode異体字を正規化する

back_text

役割
答えフィールド
制約
最初の文に直接的な答えを置く

context_hint

役割
任意の曖昧さ解消
制約
短いドメインコンテキストのみを使用する

tags_pipe

役割
分類のグループ化
制約
パイプ区切りの正規タグを使用する

source_ref

役割
追跡可能性
制約
QAの遡及確認のために章/ページを保存する

UTF-8エンコーディングを維持し、改行を正規化し、エクスポートセル内の隠れたスプレッドシート数式を避けましょう。これらの小さな制約が、静かなインポート破損を防ぎます。

14日間の安定化プロトコル

  1. 1
    1〜3日目: アクティブなデッキを1つ移行し、すぐに毎日の復習を再開する。
  2. 2
    4〜7日目: 最も失敗の多いカードを修正し、表面プロンプトの重複を排除する。
  3. 3
    8〜10日目: タグ/テンプレートを標準化し、セッション時間の傾向を検証する。
  4. 4
    11〜14日目: 完了率と失念指標が健全な場合のみ移行の規模を拡大する。

シナリオ別の移行ガイダンス

試験直前対策(8〜12週間)

主な目的
毎日の完了率を安定させる
推奨されるアプローチ
アクティブなデッキのみをインポートし、アーカイブの移行は一時停止する

長期的な語学学習

主な目的
文脈を保持する
推奨されるアプローチ
厳格なフィールド正規化を伴うCSV経路

チーム移行

主な目的
テンプレートの一貫性
推奨されるアプローチ
大量インポートの前に1つの正規マッピングを公開する

アーカイブの整理

主な目的
価値の低いデッキを廃止する
推奨されるアプローチ
トピックごとに移行し、古くなったカードは早めに削除する

よくある質問

最初にAPKGとCSVどちらを使うべきですか?

速い構造転送にはまずAPKGを使いましょう。規模拡大前に厳格なフィールドクリーンアップやテンプレート正規化が必要な場合はCSVを使いましょう。

一度に何個のデッキを移行すべきですか?

まず1つのアクティブなデッキから始め、7〜14日間安定させましょう。完了率、セッション時間、失念傾向が健全なままである場合のみ拡大しましょう。

移行中にAnkiとDeckbaseを並行して使えますか?

はい。多くの学習者は、Deckbaseで新規カードを作成しながらAnkiにレガシーデッキを残し、品質管理が安定してから統合しています。

カードが正しくインポートされない場合はどうすればよいですか?

よくある問題には、エンコーディングの問題(UTF-8を使用)、必須フィールドの欠落、テンプレートの不一致があります。CSVにエクスポートし、スプレッドシートで問題を修正してから再インポートしてください。このプレイブックには繰り返し可能な移行のためのCSV契約が含まれています。

移行がうまくいかない場合、ロールバックできますか?

はい。移行前に、Ankiデッキをバックアップとして(.apkgで)エクスポートしてください。DeckbaseはあなたのオリジナルのAnkiデータを削除しません。Deckbaseがニーズに合わない場合、進捗を失うことなくいつでもAnkiに戻れます。

移行後の最初の週に何をすべきですか?

安定化に集中しましょう: 失敗しているカードを修正し、プロンプトの重複を排除し、毎日の復習ルーティンを確立してください。主要デッキが安定するまで新しいデッキを追加しないでください。セッション時間と失念率を注意深く監視してください。

移行すると復習履歴を失いますか?

基本的なカード内容はAPKGインポートで転送されます。完全な復習履歴(学習状態、間隔)はインポート方法によってはリセットされる場合があります。DeckbaseのFSRSアルゴリズムは、新しい復習パフォーマンスに基づいて最適な間隔を再構築します。

移行後の最初の週: 成功チェックリスト

最初の7日間が移行の成否を決めます。追加のデッキに拡大する前に、主要デッキの安定化に集中しましょう。

  1. 1
    1日目: インポートしたカードで最初の復習セッションを完了する。フォーマットの問題があれば記録する。
  2. 2
    2〜3日目: 分かりにくい、またはプロンプトが不明瞭なカードを特定して修正する。
  3. 3
    4〜5日目: 重複チェックを実行し、表面が同一のカードを統合する。
  4. 4
    6〜7日目: セッション時間を評価する。大幅に増加している場合はカードの長さを調査する。
  5. 5
    7日目までに: Ankiを続けるか、完全にDeckbaseに切り替えるか、両方を維持するかを決める。

ヒント: 最初の1か月はAnkiのインストールと元のデッキをそのまま残しておきましょう。DeckbaseがニーズにあわなければAnkiに戻すロールバックオプションを持てます。

まず全体像を知りたいですか?移行戦略についての公開記事を読んでから、このプレイブックで実行に戻ってきてください。Ankiインポート/エクスポートガイドから始めましょう。