Contents
1. Scrapbox の基本概念とタスク管理に適した機能
Scrapbox では「ページ」「リンク」「タグ」「検索クエリ」の四つが中心要素です。このセクションではそれぞれの役割を簡潔にまとめ、なぜタスク管理に向くかを示します。
1‑1. ページ・リンクの特徴
Scrapbox のページは [[ページ名]] と記述すると自動的に相互リンクが生成されます。リンクは双方向であるため、タスクから担当者やプロジェクトページへすぐにジャンプでき、情報の散逸を防げます。
1‑2. タグによるメタデータ化
#TODO や #進行中 のように ハッシュ記号 を先頭につけた語はタグとして扱われ、全文検索と同等の高速検索が可能です。タスクのステータスや優先度を軽量に管理できます。
1‑3. 検索クエリ(正しいシンタックス)
Scrapbox の埋め込み検索は search: プレフィックスで始め、スペース区切りで条件式を並べます。日付は YYYY/MM/DD 形式、相対日時は today-7d のように表記します(※公式ドキュメントの最新版をご確認ください)。
|
1 2 |
search: #TODO created:2024/01/01..2024/12/31 |
上記例は「#TODO タグが付いていて、作成日が 2024 年 1 月 1 日から 12 月 31 日まで」のページをリアルタイムに抽出します。クエリは埋め込みブロックとして保存できるため、常に最新のタスクリストが自動更新されます。
ポイント
- リンクで関係性を可視化し、タグで状態管理、検索クエリで動的一覧化すれば、Scrapbox はタスク管理に最適なプラットフォームになります。
2. プロジェクトページとタスク用サブページの作成手順
プロジェクト全体を俯瞰できるトップページと、個別タスクを格納するサブページを階層化すると情報が整理しやすくなります。このセクションでは 「テンプレート化」 と 「コピー方法」 を含めた具体的フローを示します。
2‑1. ページ構造の例と設計方針
以下は典型的な階層構成です。各ページは Markdown ライクに見出しで区切りますが、Scrapbox の本文はプレーンテキストでも問題ありません。
|
1 2 3 4 5 6 7 |
[[ProjectA]] ← プロジェクトトップ ├─ [[Task Template]] ← タスクテンプレート(1 つだけ作成) └─ [[Tasks]] ← タスク一覧用フォルダページ ├─ [[Task-001]] ├─ [[Task-002]] … |
2‑2. プロジェクトトップページの作り方
- 新規ページ作成:左上の「+」ボタンで
ProjectAと入力し、Enter キーでページを生成。 - 基本情報記入:概要・ゴール・メンバーリストを箇条書きで記載します(例:
#メンバー [[山田太郎]] [[鈴木花子]])。
導入文:プロジェクトページは全体像と関係者のハブになるため、最初に必ず概要と目的を書き込んでおくことが重要です。
2‑3. タスクテンプレートの作成と保存
以下の内容を Task Template ページに貼り付けます。コードブロックは使用しません(Scrapbox はそのままテキストとして扱うため)。
|
1 2 3 4 5 6 7 8 9 10 11 12 13 |
# タイトル: 【】 ← ここにタスク名を書く ## ステータス #TODO <!-- 未着手 --> #進行中 <!-- 作業中 --> #完了 <!-- 完了済み --> ## 期限 2026/08/15 <!-- YYYY/MM/DD 形式で入力 --> ## 担当者 [[ユーザー名]] <!-- 担当者ページへのリンク --> |
導入文:テンプレートは「1 回作成 → 複数プロジェクトで再利用」できるよう、必ず 専用ページ として切り離しておきます。
2‑4. タスクサブページの自動生成手順
ProjectAページ上部に以下のリンクを配置します。
text
[[Task Template]]
- このリンクをクリック → 「Copy page」ボタン(右上メニュー)を選択し、コピー先として新しいタスク名(例:
Task-001)を入力して作成。 - 作成されたページは自動的に
Task Templateの内容が複製されるので、そのまま必要項目を書き換えるだけで完了です。
ポイント:テンプレートリンクからの「Copy to」操作は UI が変わっても概ね同様なので、公式ヘルプを参照しながら実行してください。
3. タスクテンプレートとステータス管理の実装
統一されたフォーマットでタスク情報を入力すれば、メンバー間で認識齟齬が起きにくくなります。この章では 必須項目 と タグ活用例 を具体的に示し、変更フローも合わせて解説します。
3‑1. テンプレート項目の詳細説明
| 項目 | 記入例 | 補足 |
|---|---|---|
| タイトル | # タイトル: 【顧客情報の更新】 |
角括弧は必須ではないが、視認性向上に有用 |
| ステータス | #TODO / #進行中 / #完了 |
タグはページ内に 1 つだけ付与するとクエリがシンプルになる |
| 期限 | 2026/08/15(YYYY/MM/DD) |
日付は必ずスラッシュ区切りで記入。相対日付は deadline: today+3d のように書くことも可 |
| 担当者 | [[山田太郎]] |
担当者ページが存在しない場合は先に作成しておく |
導入文:上記項目はすべて検索クエリの対象になるため、抜け漏れなく入力することが後続の自動集計で重要です。
3‑2. ステータスタグ活用例と変更手順
| 現在のステータス | 変更先 | 操作方法 |
|---|---|---|
未着手 (#TODO) |
作業中 (#進行中) |
タスクページで #TODO を削除し、#進行中 を追記 |
作業中 (#進行中) |
完了 (#完了) |
同様にタグを置換。完了時は コメント で完了報告も添えると履歴が残る |
ポイント:タグの付け外しだけでステータス遷移でき、クエリ結果は即座に反映されます。
4. クエリでタスク一覧・フィルタ表示、レポート作成
Scrapbox の検索クエリはリアルタイムに結果を返すので、別途スプレッドシートを手動更新する必要がありません。ただし CSV エクスポート は直接的には提供されていないため、API もしくはテキストダウンロード → 手作業で変換という流れになります。以下に安全な手順と実例クエリを書き出します。
4‑1. 正しい日付フィルタの書式例
- 作成日が過去 30 日以内:
created:today-30d..today - 期限が今日以降かつ 7 日以内:
deadline:today..today+7d
導入文:Scrapbox の日時表記は
YYYY/MM/DDが基本で、相対日付はtoday±N[d|w|m]と書く点に注意してください。
4‑2. 基本クエリ例(未完了タスク・期限別)
|
1 2 |
search: #TODO or #進行中 // 未完了タスク全般 |
|
1 2 |
search: #TODO created:today-30d..today deadline:today..today+7d // 直近 30 日に作成、期限が今から 7 日以内の未完了タスク |
|
1 2 |
search: [[山田太郎]] #TODO // 担当者別(山田太郎)の未完了タスク |
ポイント:クエリはページ内に
search:ブロックとして保存でき、他メンバーと共有すると常に最新の一覧が閲覧可能です。
4‑3. CSV エクスポート手順(実装例)
- 検索結果ページをテキストでダウンロード
- クエリブロック右上の「⋮」メニュー → 「Export as text」(
.txt) を選択。 - テキストを CSV へ変換
- ダウンロードしたファイルはタブ区切りになることが多いので、Excel/Google スプレッドシートで「区切り文字: タブ」を指定してインポートし、必要に応じて
CSVとして保存。 - 自動化(任意)
- Scrapbox API (
GET https://scrapbox.io/api/pages/{project}/{page}) を利用すれば、スクリプトで定期的に JSON を取得し、サーバー側で CSV に変換・保存できます。
注意点:公式 UI からの直接 CSV 出力は未実装です。そのため上記手順または API 活用を推奨します。
5. チーム共有フローと他ツール連携ベストプラクティス
タスク情報を Scrapbox のみで完結させても良いですが、Slack や GitHub、Google カレンダーとの 双方向同期 ができれば、チーム全体の可視性が飛躍的に向上します。ここでは実装可能な具体手順と代表的なシナリオを示します。
5‑1. Slack 通知設定(公式インテグレーション)
- Slack 側で Incoming Webhook を作成
-
Slack アプリディレクトリ → 「Incoming Webhooks」 → ワークスペースに追加し、通知したいチャンネル(例:
#scrapbox-updates)を選択。生成された URL をコピー。 -
Scrapbox の設定画面で Webhook を登録
- Scrapbox 右上の自分アイコン → 「Settings」→「Integrations」→「Slack」へ移動。
-
「Webhook URL」に先ほどコピーした URL を貼り付け、トリガー条件を以下のように設定します。
イベント 条件式 タスク作成 #TODOがページに追加されたときステータス変更 ページ内のタグが #進行中または#完了に変わったとき -
通知内容のカスタマイズ(任意)
- 「Message template」に
{title} / 担当: {assignee} / 期限: {deadline}のようにプレースホルダーを埋め込むと、Slack メッセージが分かりやすくなります。
ポイント:Webhook は即時送信されるため、タスクの追加・変更があった瞬間にチームへ共有できます。
5‑2. GitHub Issue との同期(Zapier または n8n)
| フロー | Zapier 設定例 |
|---|---|
| トリガー | 「Scrapbox – New Page」 (ページが作成されたとき) |
| 条件分岐 | ページ本文に #TODO が含まれるかをチェック |
| アクション | 「GitHub – Create Issue」 ・リポジトリ: my-org/project ・タイトル:ページの「タイトル」行 ・Assignee: [[担当者名]] から抽出 |
| ステータス変更時 | 別途 Zap を作成し、Scrapbox の「Page Updated」→タグが #完了 に変わったら同 Issue を 「Close」 |
n8n でも同様に Webhook → Scrapbox API → GitHub ノードで実装可能です。
注意:Zapier の無料枠は月 100 タスクまでなので、規模が大きい場合は n8n 自己ホスト版を検討してください。
5‑3. Google カレンダー連携例(Make / Integromat)
- Scrapbox API で期限タスク取得
-
GET https://scrapbox.io/api/pages/{project}/search?query=search:%20#TODO%20deadline:today..today+7d -
Make のシナリオ
- 「Scheduler」モジュール:毎日 09:00 に実行。
- 「HTTP」モジュールで上記 API を呼び出し、JSON 結果を取得。
- 各タスクごとに「Google Calendar – Create Event」モジュールでイベントを作成(開始日時=期限の前日 18:00、リマインダーは 30 分前)。
ポイント:カレンダー上に期限が自動的に表示されるため、リマインド漏れが大幅に減ります。
5‑4. シナリオ別活用例(Kanban・GTD・スプリント)
| シナリオ | 推奨ページ構成 | 主なクエリ例 |
|---|---|---|
| Kanban | [[Board]] に列をタグで表現 (#TODO, #進行中, #完了) |
search: #TODO → 「To Do」カラムに貼り付け |
| GTD | [[Inbox]], [[Next Actions]], [[Someday/Maybe]] を作成 |
search: [[Inbox]] |
| スプリント管理 | [[Sprint 2026-07]] に目標とタスクリンクを列挙 |
search: sprint:2026-07 #TODO |
導入文:Scrapbox の柔軟なページ構造は、Kanban ボードや GTD リスト、スプリントバックログなど、さまざまなプロジェクト管理手法にすぐ適応できます。
6. まとめ
- リンク・タグ・検索クエリ を組み合わせるだけで、リアルタイムかつ柔軟なタスク管理基盤が構築できる。
- テンプレート化とページ階層 によって情報の散在を防ぎ、新規タスク作成を数クリックに短縮できる。
- 正しい日付・期限フィルタ とクエリ文法(
search:,created:today-30d..today,deadline:today+7d)を守れば、必要なタスクリストが瞬時に抽出可能。 - CSV エクスポートはテキストダウンロード+変換 が公式手順であり、API 活用で自動化も実現できる。
- Slack, GitHub, Google カレンダー との連携は Webhook / Zapier / Make といった外部サービスを介すれば設定がシンプル。双方向同期により、タスク情報が全ツールに反映されチームの可視性と生産性が向上する。
本ガイドで示した手順とベストプラクティスを導入すれば、Scrapbox 上で完結するだけでなく、他の業務ツールともシームレスに連携した 統合タスク管理環境 が実現します。ぜひ自チームのワークフローに合わせてカスタマイズし、業務効率化を加速させてください。