How long does the integration take?

Change one base URL in an OpenAI-compatible client, or install the Python or TypeScript SDK; the quickstart routes a first request in a few minutes.

Will this lock us into another vendor?

No. The router is Apache-2.0 open source, your provider keys stay yours, and the API is OpenAI-compatible, so leaving is a change of base URL.

What happens when a provider fails?

The router falls back to the next model your policy allows and records the fallback in the trace, so an outage costs a retry, not an incident.

start-12-4 - Prompt - OpenSmartRoute

Name: start-12-4
Author: minicoohei

Prompt file imported from minicoohei/ai-agent-camp (.cursor/commands/lesson/start-12-4.md). Copyright stays with the author.

🎓 Lesson 12-4: ファイル作成・ページ作成

📍 このセッションでやること

Lesson 12-4: ファイル作成・ページ作成 へようこそ！

項目	内容
ゴール	ncli でNotionにページ・データベースを作成し、ファイルをアップロードする
所要時間	約25分
使うスキル	ncli (Notion CLI)
前提条件	Lesson 12-3 完了（ファイル取得ができる状態）

このセッションの流れ:

シンプルなページ作成
本文付きページ作成（パイプ入力）
ファイルアップロード
データベース作成
DBにエントリ追加

セッション終了時には、ncli を使ってNotionにページ・DB・ファイルを自由に作成できるようになっています。

💡 ヒント: AIの応答が途中で止まった場合は「続きを表示して」「止まってるよ」と入力すると再開します。

🎯 準備チェック

まずは準備が整っているか確認しましょう。

AskQuestionの設定:

{
  "title": "🎯 セッション開始前の確認",
  "questions": [{
    "id": "readiness",
    "prompt": "準備はできていますか？",
    "options": [
      {"id": "ready", "label": "準備OK！始めましょう"},
      {"id": "check_prereq", "label": "前提条件を確認したい"},
      {"id": "different_lesson", "label": "別のレッスンに移動したい"}
    ]
  }]
}

(ready → Step 1へ) (check_prereq → ncli whoami を実行して認証状態を確認) (different_lesson → モジュール一覧を表示)

🚀 Step 1: シンプルなページ作成

AskQuestionの設定例:

{
  "title": "🚀 Step 1: シンプルなページ作成",
  "questions": [{
    "id": "step_action",
    "prompt": "このステップをどうしますか？",
    "options": [
      {"id": "practice", "label": "このまま進める"},
      {"id": "review", "label": "例だけ確認する"},
      {"id": "skip", "label": "スキップする"}
    ]
  }]
}

AIが実行すること:

まず受講者に親ページを確認:
- 「ページを作成する場所（親ページ）のURLを教えてください。特になければワークスペースのトップレベルに作成します」と案内

テストページを作成:

ncli page create --title "ncli テストページ"

親ページを指定して作成する場合:

ncli page create --title "ncli テストページ" --parent <親ページURL>

作成されたページの情報を確認:
- ページID
- ページURL
- 作成日時
ブラウザでNotionを開き、ページが正しく作成されたか確認するよう案内する。

期待される結果: Notionに新しいページが作成され、ブラウザで確認できる。

🚀 Step 2: 本文付きページ作成（パイプ入力）

AskQuestionの設定例:

{
  "title": "🚀 Step 2: 本文付きページ作成",
  "questions": [{
    "id": "step_action",
    "prompt": "このステップをどうしますか？",
    "options": [
      {"id": "practice", "label": "このまま進める"},
      {"id": "review", "label": "例だけ確認する"},
      {"id": "skip", "label": "スキップする"}
    ]
  }]
}

AIが実行すること:

--body オプションで本文付きページを作成:

ncli page create --title "議事録テンプレート" --body "# 会議概要

日時

日付: $(date +%Y-%m-%d)

参加者

（ここに記入）

議題

議題1
議題2

決定事項

（ここに記入）

次のアクション

タスク1
タスク2"

パイプを使った入力も試す:
```
echo "# レポート本文
```

これはパイプ経由で入力された本文です。

セクション1

テスト内容を記載しています。" | ncli page create --title "パイプ入力テスト" --body -


3. ファイルの内容をそのままページに流し込む:
```bash
cat README.md | ncli page create --title "READMEコピー" --body -

作成したページを ncli fetch で確認:
```
ncli fetch <作成されたページURL>
```

補足: --body - はパイプからの入力（標準入力）を本文として使うことを意味します。長文のコンテンツを作成する際に便利です。

期待される結果: Markdown形式の本文を持つページが作成される。

🚀 Step 3: ファイルアップロード

AskQuestionの設定例:

{
  "title": "🚀 Step 3: ファイルアップロード",
  "questions": [{
    "id": "step_action",
    "prompt": "このステップをどうしますか？",
    "options": [
      {"id": "practice", "label": "このまま進める"},
      {"id": "review", "label": "例だけ確認する"},
      {"id": "skip", "label": "スキップする"}
    ]
  }]
}

AIが実行すること:

テスト用ファイルを準備（なければ作成）:

echo "これはncliアップロードテスト用のファイルです。" > output/test_upload.txt

ファイルをNotionにアップロード:
```
ncli file upload output/test_upload.txt
```
画像ファイルのアップロードも試す（あれば）:
```
ncli file upload output/notion_auth_screenshot.png
```
アップロード結果を確認:
- アップロード先のページ/ブロック情報
- ファイルURL
Notionブラウザでアップロードされたファイルが表示されるか確認するよう案内。

期待される結果: ファイルがNotionにアップロードされ、ブラウザで確認できる。

🚀 Step 4: データベース作成

AskQuestionの設定例:

{
  "title": "🚀 Step 4: データベース作成",
  "questions": [{
    "id": "step_action",
    "prompt": "このステップをどうしますか？",
    "options": [
      {"id": "practice", "label": "このまま進める"},
      {"id": "review", "label": "例だけ確認する"},
      {"id": "skip", "label": "スキップする"}
    ]
  }]
}

AIが実行すること:

タスク管理用データベースを作成:

ncli db create --title "タスク管理" \
  --prop "Name:title" \
  --prop "Status:select=Open,InProgress,Done" \
  --prop "Priority:select=High,Medium,Low" \
  --prop "DueDate:date" \
  --prop "Category:multi_select=開発,デザイン,企画,ドキュメント"

作成されたDBの情報を確認:
- データベースID
- データベースURL
- プロパティ一覧
ncli fetch でスキーマを確認:
```
ncli fetch <作成されたDB-URL>
```

各プロパティが正しく作成されたか、テーブル形式で表示する:

プロパティ名	型	選択肢
Name	title	-
Status	select	Open, InProgress, Done
Priority	select	High, Medium, Low
DueDate	date	-
Category	multi_select	開発, デザイン, 企画, ドキュメント

期待される結果: プロパティ付きのデータベースが作成される。

🚀 Step 5: DBにエントリ追加

AskQuestionの設定例:

{
  "title": "🚀 Step 5: DBにエントリ追加",
  "questions": [{
    "id": "step_action",
    "prompt": "このステップをどうしますか？",
    "options": [
      {"id": "practice", "label": "このまま進める"},
      {"id": "review", "label": "例だけ確認する"},
      {"id": "skip", "label": "スキップする"}
    ]
  }]
}

AIが実行すること:

Step 4 で作成したDBにタスクを追加:

ncli page create --parent <DB-URL> \
  --prop "Name=APIドキュメント作成" \
  --prop "Status=Open" \
  --prop "Priority=High" \
  --prop "Category=ドキュメント"

さらにタスクを追加:

ncli page create --parent <DB-URL> \
  --prop "Name=ユーザー認証機能実装" \
  --prop "Status=InProgress" \
  --prop "Priority=High" \
  --prop "Category=開発"

3つ目のタスクも追加:

ncli page create --parent <DB-URL> \
  --prop "Name=UIモックアップ作成" \
  --prop "Status=Open" \
  --prop "Priority=Medium" \
  --prop "Category=デザイン"

追加されたエントリを確認:
```
ncli db query <DB-view-URL>
```
結果をテーブル形式で表示し、全タスクが正しく追加されたか確認する。

期待される結果: 3件のタスクがDBに追加され、クエリで一覧表示できる。

⚠️ よくあるトラブルと解決方法

AskQuestionの設定例:

{
  "title": "トラブル内容を選択",
  "questions": [{
    "id": "trouble",
    "prompt": "当てはまる内容を1つ選んでください",
    "options": [
      {"id": "trouble_1", "label": "ページ作成時に Parent not found エラー"},
      {"id": "trouble_2", "label": "--body で本文が正しく反映されない"},
      {"id": "trouble_3", "label": "ファイルアップロードが失敗する"},
      {"id": "trouble_4", "label": "DB作成時にプロパティがエラーになる"}
    ]
  }]
}

トラブル1: ページ作成時に Parent not found エラー

原因: 親ページのURLまたはIDが間違っている 解決方法:

以下を確認してください：
1. 親ページのURLをブラウザから直接コピーする
2. ncli fetch <親ページURL> で親ページにアクセスできるか確認
3. --parent を省略してワークスペースのトップレベルに作成を試す

トラブル2: --body で本文が正しく反映されない

原因: Markdown構文がNotionのブロックに変換されない場合がある 解決方法:

以下を試してください：
1. シンプルなテキストで試す（# 見出し、- リスト のみ）
2. パイプ入力（echo "..." | ncli page create --body -）を試す
3. 長文の場合はファイルに保存してから cat file.md | ncli page create --body -

トラブル3: ファイルアップロードが失敗する

原因: ファイルサイズが大きすぎる、またはファイルパスが間違っている 解決方法:

以下を確認してください：
1. ファイルパスが正しいか（ls でファイルの存在を確認）
2. ファイルサイズが5MB以下か確認
3. 小さなテキストファイルで試してみる

トラブル4: DB作成時にプロパティがエラーになる

原因: --prop の構文が間違っている 解決方法:

--prop の正しい構文：
- タイトル: --prop "Name:title"
- セレクト: --prop "Status:select=Option1,Option2"
- マルチセレクト: --prop "Tags:multi_select=Tag1,Tag2"
- 日付: --prop "Date:date"
- 数値: --prop "Count:number"
プロパティ名にスペースを含む場合はクォーテーションで囲んでください。

✅ チェックポイント

ncli page create でページが作成できる
--body オプションで本文付きページが作成できる
ncli file upload でファイルがアップロードできる
ncli db create でプロパティ付きDBが作成できる
DBにエントリ（ページ）を追加できる

📋 成果物プレビュー

このレッスンで得られる成果物:

成果物	説明
ncli テストページ	シンプルなページ（タイトルのみ）
議事録テンプレート	本文付きページ（Markdown形式）
アップロードファイル	Notionにアップロードされたファイル
タスク管理DB	5つのプロパティを持つデータベース
タスクエントリ 3件	DBに追加されたサンプルタスク

➡️ 次のステップ

これでページ・DB・ファイルの作成は完了です。次のレッスンでは、既存コンテンツの書き込みと更新を学びます。

AskQuestionの設定例:

{
  "title": "次のステップを選択",
  "questions": [{
    "id": "next_step",
    "prompt": "次に進む操作を選んでください",
    "options": [
      {"id": "next_auto", "label": "次のセクションを開始（/next_lesson）"},
      {"id": "next_window", "label": "新しいウィンドウで開始（/start-12-5）"},
      {"id": "finish", "label": "ここで終了する"}
    ]
  }]
}

選択後の案内:

next_auto → /next_lesson
next_window → 新しいウィンドウで /start-12-5
finish → 終了

Install start-12-4 and it becomes one more candidate the router can pick - when it fits.

A listing is a routing target with a manifest: what it does, which domains it covers, what it costs and who publishes it. Once installed it sits beside your own models and tools, is scored like any other candidate for each request, and shows up in the trace when it wins. Ratings come from workspaces that installed it, one per account.

# 🎓 Lesson 12-4: ファイル作成・ページ作成 ## 📍 このセッションでやること **Lesson 12-4: ファイル作成・ページ作成** へようこそ！ | 項目 | 内容 | |------|------| | ゴール | ncli でNotionにページ・データベースを作成し、ファイルをアップロードする | | 所要時間 | 約25分 | | 使うスキル | ncli (Notion CLI) | | 前提条件 | Lesson 12-3 完了（ファイル取得ができる状態） | **このセッションの流れ:** 1. シンプルなページ作成 2. 本文付きページ作成（パイプ入力） 3. ファイルアップロード 4. データベース作成 5. DBにエントリ追加セッション終了時には、ncli を使ってNotionにページ・DB・ファイルを自由に作成できるようになっています。 > **💡 ヒント**: AIの応答が途中で止まった場合は「続きを表示して」「止まってるよ」と入力すると再開します。 --- ## 🎯 準備チェックまずは準備が整っているか確認しましょう。 **AskQuestionの設定:** ```json { "title": "🎯 セッション開始前の確認", "questions": [{ "id": "readiness", "prompt": "準備はできていますか？", "options": [ {"id": "ready", "label": "準備OK！始めましょう"}, {"id": "check_prereq", "label": "前提条件を確認したい"}, {"id": "different_lesson", "label": "別のレッスンに移動したい"} ] }] } ``` (ready → Step 1へ) (check_prereq → `ncli whoami` を実行して認証状態を確認) (different_lesson → モジュール一覧を表示) --- ## 🚀 Step 1: シンプルなページ作成 **AskQuestionの設定例:** ```json { "title": "🚀 Step 1: シンプルなページ作成", "questions": [{ "id": "step_action", "prompt": "このステップをどうしますか？", "options": [ {"id": "practice", "label": "このまま進める"}, {"id": "review", "label": "例だけ確認する"}, {"id": "skip", "label": "スキップする"} ] }] } ``` **AIが実行すること:** 1. まず受講者に親ページを確認: - 「ページを作成する場所（親ページ）のURLを教えてください。特になければワークスペースのトップレベルに作成します」と案内 2. テストページを作成: ```bash ncli page create --title "ncli テストページ" ``` 3. 親ページを指定して作成する場合: ```bash ncli page create --title "ncli テストページ" --parent <親ページURL> ``` 4. 作成されたページの情報を確認: - ページID - ページURL - 作成日時 5. ブラウザでNotionを開き、ページが正しく作成されたか確認するよう案内する。 **期待される結果**: Notionに新しいページが作成され、ブラウザで確認できる。 --- ## 🚀 Step 2: 本文付きページ作成（パイプ入力） **AskQuestionの設定例:** ```json { "title": "🚀 Step 2: 本文付きページ作成", "questions": [{ "id": "step_action", "prompt": "このステップをどうしますか？", "options": [ {"id": "practice", "label": "このまま進める"}, {"id": "review", "label": "例だけ確認する"}, {"id": "skip", "label": "スキップする"} ] }] } ``` **AIが実行すること:** 1. `--body` オプションで本文付きページを作成: ```bash ncli page create --title "議事録テンプレート" --body "# 会議概要 ## 日時 - 日付: $(date +%Y-%m-%d) ## 参加者 - （ここに記入） ## 議題 1. 議題1 2. 議題2 ## 決定事項 - （ここに記入） ## 次のアクション - [ ] タスク1 - [ ] タスク2" ``` 2. パイプを使った入力も試す: ```bash echo "# レポート本文これはパイプ経由で入力された本文です。 ## セクション1 テスト内容を記載しています。" | ncli page create --title "パイプ入力テスト" --body - ``` 3. ファイルの内容をそのままページに流し込む: ```bash cat README.md | ncli page create --title "READMEコピー" --body - ``` 4. 作成したページを `ncli fetch` で確認: ```bash ncli fetch <作成されたページURL> ``` **補足**: `--body -` はパイプからの入力（標準入力）を本文として使うことを意味します。長文のコンテンツを作成する際に便利です。 **期待される結果**: Markdown形式の本文を持つページが作成される。 --- ## 🚀 Step 3: ファイルアップロード **AskQuestionの設定例:** ```json { "title": "🚀 Step 3: ファイルアップロード", "questions": [{ "id": "step_action", "prompt": "このステップをどうしますか？", "options": [ {"id": "practice", "label": "このまま進める"}, {"id": "review", "label": "例だけ確認する"}, {"id": "skip", "label": "スキップする"} ] }] } ``` **AIが実行すること:** 1. テスト用ファイルを準備（なければ作成）: ```bash echo "これはncliアップロードテスト用のファイルです。" > output/test_upload.txt ``` 2. ファイルをNotionにアップロード: ```bash ncli file upload output/test_upload.txt ``` 3. 画像ファイルのアップロードも試す（あれば）: ```bash ncli file upload output/notion_auth_screenshot.png ``` 4. アップロード結果を確認: - アップロード先のページ/ブロック情報 - ファイルURL 5. Notionブラウザでアップロードされたファイルが表示されるか確認するよう案内。 **期待される結果**: ファイルがNotionにアップロードされ、ブラウザで確認できる。 --- ## 🚀 Step 4: データベース作成 **AskQuestionの設定例:** ```json { "title": "🚀 Step 4: データベース作成", "questions": [{ "id": "step_action", "prompt": "このステップをどうしますか？", "options": [ {"id": "practice", "label": "このまま進める"}, {"id": "review", "label": "例だけ確認する"}, {"id": "skip", "label": "スキップする"} ] }] } ``` **AIが実行すること:** 1. タスク管理用データベースを作成: ```bash ncli db create --title "タスク管理" \ --prop "Name:title" \ --prop "Status:select=Open,InProgress,Done" \ --prop "Priority:select=High,Medium,Low" \ --prop "DueDate:date" \ --prop "Category:multi_select=開発,デザイン,企画,ドキュメント" ``` 2. 作成されたDBの情報を確認: - データベースID - データベースURL - プロパティ一覧 3. `ncli fetch` でスキーマを確認: ```bash ncli fetch <作成されたDB-URL> ``` 4. 各プロパティが正しく作成されたか、テーブル形式で表示する: | プロパティ名 | 型 | 選択肢 | |---|---|---| | Name | title | - | | Status | select | Open, InProgress, Done | | Priority | select | High, Medium, Low | | DueDate | date | - | | Category | multi_select | 開発, デザイン, 企画, ドキュメント | **期待される結果**: プロパティ付きのデータベースが作成される。 --- ## 🚀 Step 5: DBにエントリ追加 **AskQuestionの設定例:** ```json { "title": "🚀 Step 5: DBにエントリ追加", "questions": [{ "id": "step_action", "prompt": "このステップをどうしますか？", "options": [ {"id": "practice", "label": "このまま進める"}, {"id": "review", "label": "例だけ確認する"}, {"id": "skip", "label": "スキップする"} ] }] } ``` **AIが実行すること:** 1. Step 4 で作成したDBにタスクを追加: ```bash ncli page create --parent <DB-URL> \ --prop "Name=APIドキュメント作成" \ --prop "Status=Open" \ --prop "Priority=High" \ --prop "Category=ドキュメント" ``` 2. さらにタスクを追加: ```bash ncli page create --parent <DB-URL> \ --prop "Name=ユーザー認証機能実装" \ --prop "Status=InProgress" \ --prop "Priority=High" \ --prop "Category=開発" ``` 3. 3つ目のタスクも追加: ```bash ncli page create --parent <DB-URL> \ --prop "Name=UIモックアップ作成" \ --prop "Status=Open" \ --prop "Priority=Medium" \ --prop "Category=デザイン" ``` 4. 追加されたエントリを確認: ```bash ncli db query <DB-view-URL> ``` 5. 結果をテーブル形式で表示し、全タスクが正しく追加されたか確認する。 **期待される結果**: 3件のタスクがDBに追加され、クエリで一覧表示できる。 --- ## ⚠️ よくあるトラブルと解決方法 **AskQuestionの設定例:** ```json { "title": "トラブル内容を選択", "questions": [{ "id": "trouble", "prompt": "当てはまる内容を1つ選んでください", "options": [ {"id": "trouble_1", "label": "ページ作成時に Parent not found エラー"}, {"id": "trouble_2", "label": "--body で本文が正しく反映されない"}, {"id": "trouble_3", "label": "ファイルアップロードが失敗する"}, {"id": "trouble_4", "label": "DB作成時にプロパティがエラーになる"} ] }] } ``` ### トラブル1: ページ作成時に Parent not found エラー **原因**: 親ページのURLまたはIDが間違っている **解決方法**: ```text 以下を確認してください： 1. 親ページのURLをブラウザから直接コピーする 2. ncli fetch <親ページURL> で親ページにアクセスできるか確認 3. --parent を省略してワークスペースのトップレベルに作成を試す ``` ### トラブル2: --body で本文が正しく反映されない **原因**: Markdown構文がNotionのブロックに変換されない場合がある **解決方法**: ```text 以下を試してください： 1. シンプルなテキストで試す（# 見出し、- リストのみ） 2. パイプ入力（echo "..." | ncli page create --body -）を試す 3. 長文の場合はファイルに保存してから cat file.md | ncli page create --body - ``` ### トラブル3: ファイルアップロードが失敗する **原因**: ファイルサイズが大きすぎる、またはファイルパスが間違っている **解決方法**: ```text 以下を確認してください： 1. ファイルパスが正しいか（ls でファイルの存在を確認） 2. ファイルサイズが5MB以下か確認 3. 小さなテキストファイルで試してみる ``` ### トラブル4: DB作成時にプロパティがエラーになる **原因**: --prop の構文が間違っている **解決方法**: ```text --prop の正しい構文： - タイトル: --prop "Name:title" - セレクト: --prop "Status:select=Option1,Option2" - マルチセレクト: --prop "Tags:multi_select=Tag1,Tag2" - 日付: --prop "Date:date" - 数値: --prop "Count:number" プロパティ名にスペースを含む場合はクォーテーションで囲んでください。 ``` --- ## ✅ チェックポイント - [ ] `ncli page create` でページが作成できる - [ ] `--body` オプションで本文付きページが作成できる - [ ] `ncli file upload` でファイルがアップロードできる - [ ] `ncli db create` でプロパティ付きDBが作成できる - [ ] DBにエントリ（ページ）を追加できる --- ## 📋 成果物プレビューこのレッスンで得られる成果物: | 成果物 | 説明 | |--------|------| | ncli テストページ | シンプルなページ（タイトルのみ） | | 議事録テンプレート | 本文付きページ（Markdown形式） | | アップロードファイル | Notionにアップロードされたファイル | | タスク管理DB | 5つのプロパティを持つデータベース | | タスクエントリ 3件 | DBに追加されたサンプルタスク | --- ## ➡️ 次のステップこれでページ・DB・ファイルの作成は完了です。次のレッスンでは、既存コンテンツの書き込みと更新を学びます。 **AskQuestionの設定例:** ```json { "title": "次のステップを選択", "questions": [{ "id": "next_step", "prompt": "次に進む操作を選んでください", "options": [ {"id": "next_auto", "label": "次のセクションを開始（/next_lesson）"}, {"id": "next_window", "label": "新しいウィンドウで開始（/start-12-5）"}, {"id": "finish", "label": "ここで終了する"} ] }] } ``` **選択後の案内:** - next_auto → /next_lesson - next_window → 新しいウィンドウで /start-12-5 - finish → 終了

{ "prompt": "# 🎓 Lesson 12-4: ファイル作成・ページ作成\n\n## 📍 このセッションでやること\n\n**Lesson 12-4: ファイル作成・ページ作成** へようこそ！\n\n| 項目 | 内容 |\n|------|------|\n| ゴール | ncli でNotionにページ・データベースを作成し、ファイルをアップロードする |\n| 所要時間 | 約25分 |\n| 使うスキル | ncli (Notion CLI) |\n| 前提条件 | Lesson 12-3 完了（ファイル取得ができる状態） |\n\n**このセッションの流れ:**\n1. シンプルなページ作成\n2. 本文付きページ作成（パイプ入力）\n3. ファイルアップロード\n4. データベース作成\n5. DBにエントリ追加\n\nセッション終了時には、ncli を使ってNotionにページ・DB・ファイルを自由に作成できるようになっています。\n\n> **💡 ヒント**: AIの応答が途中で止まった場合は「続きを表示して」「止まってるよ」と入力すると再開します。\n\n---\n\n## 🎯 準備チェック\n\nまずは準備が整っているか確認しましょう。\n\n**AskQuestionの設定:**\n```json\n{\n \"title\": \"🎯 セッション開始前の確認\",\n \"questions\": [{\n \"id\": \"readiness\",\n \"prompt\": \"準備はできていますか？\",\n \"options\": [\n {\"id\": \"ready\", \"label\": \"準備OK！始めましょう\"},\n {\"id\": \"check_prereq\", \"label\": \"前提条件を確認したい\"},\n {\"id\": \"different_lesson\", \"label\": \"別のレッスンに移動したい\"}\n ]\n }]\n}\n```\n\n(ready → Step 1へ)\n(check_prereq → `ncli whoami` を実行して認証状態を確認)\n(different_lesson → モジュール一覧を表示)\n\n---\n\n## 🚀 Step 1: シンプルなページ作成\n\n**AskQuestionの設定例:**\n```json\n{\n \"title\": \"🚀 Step 1: シンプルなページ作成\",\n \"questions\": [{\n \"id\": \"step_action\",\n \"prompt\": \"このステップをどうしますか？\",\n \"options\": [\n {\"id\": \"practice\", \"label\": \"このまま進める\"},\n {\"id\": \"review\", \"label\": \"例だけ確認する\"},\n {\"id\": \"skip\", \"label\": \"スキップする\"}\n ]\n }]\n}\n```\n\n**AIが実行すること:**\n\n1. まず受講者に親ページを確認:\n - 「ページを作成する場所（親ページ）のURLを教えてください。特になければワークスペースのトップレベルに作成します」と案内\n\n2. テストページを作成:\n ```bash\n ncli page create --title \"ncli テストページ\"\n ```\n\n3. 親ページを指定して作成する場合:\n ```bash\n ncli page create --title \"ncli テストページ\" --parent <親ページURL>\n ```\n\n4. 作成されたページの情報を確認:\n - ページID\n - ページURL\n - 作成日時\n\n5. ブラウザでNotionを開き、ページが正しく作成されたか確認するよう案内する。\n\n**期待される結果**: Notionに新しいページが作成され、ブラウザで確認できる。\n\n---\n\n## 🚀 Step 2: 本文付きページ作成（パイプ入力）\n\n**AskQuestionの設定例:**\n```json\n{\n \"title\": \"🚀 Step 2: 本文付きページ作成\",\n \"questions\": [{\n \"id\": \"step_action\",\n \"prompt\": \"このステップをどうしますか？\",\n \"options\": [\n {\"id\": \"practice\", \"label\": \"このまま進める\"},\n {\"id\": \"review\", \"label\": \"例だけ確認する\"},\n {\"id\": \"skip\", \"label\": \"スキップする\"}\n ]\n }]\n}\n```\n\n**AIが実行すること:**\n\n1. `--body` オプションで本文付きページを作成:\n ```bash\n ncli page create --title \"議事録テンプレート\" --body \"# 会議概要\n\n## 日時\n- 日付: $(date +%Y-%m-%d)\n\n## 参加者\n- （ここに記入）\n\n## 議題\n1. 議題1\n2. 議題2\n\n## 決定事項\n- （ここに記入）\n\n## 次のアクション\n- [ ] タスク1\n- [ ] タスク2\"\n ```\n\n2. パイプを使った入力も試す:\n ```bash\n echo \"# レポート本文\n\nこれはパイプ経由で入力された本文です。\n\n## セクション1\nテスト内容を記載しています。\" | ncli page create --title \"パイプ入力テスト\" --body -\n ```\n\n3. ファイルの内容をそのままページに流し込む:\n ```bash\n cat README.md | ncli page create --title \"READMEコピー\" --body -\n ```\n\n4. 作成したページを `ncli fetch` で確認:\n ```bash\n ncli fetch <作成されたページURL>\n ```\n\n**補足**: `--body -` はパイプからの入力（標準入力）を本文として使うことを意味します。長文のコンテンツを作成する際に便利です。\n\n**期待される結果**: Markdown形式の本文を持つページが作成される。\n\n---\n\n## 🚀 Step 3: ファイルアップロード\n\n**AskQuestionの設定例:**\n```json\n{\n \"title\": \"🚀 Step 3: ファイルアップロード\",\n \"questions\": [{\n \"id\": \"step_action\",\n \"prompt\": \"このステップをどうしますか？\",\n \"options\": [\n {\"id\": \"practice\", \"label\": \"このまま進める\"},\n {\"id\": \"review\", \"label\": \"例だけ確認する\"},\n {\"id\": \"skip\", \"label\": \"スキップする\"}\n ]\n }]\n}\n```\n\n**AIが実行すること:**\n\n1. テスト用ファイルを準備（なければ作成）:\n ```bash\n echo \"これはncliアップロードテスト用のファイルです。\" > output/test_upload.txt\n ```\n\n2. ファイルをNotionにアップロード:\n ```bash\n ncli file upload output/test_upload.txt\n ```\n\n3. 画像ファイルのアップロードも試す（あれば）:\n ```bash\n ncli file upload output/notion_auth_screenshot.png\n ```\n\n4. アップロード結果を確認:\n - アップロード先のページ/ブロック情報\n - ファイルURL\n\n5. Notionブラウザでアップロードされたファイルが表示されるか確認するよう案内。\n\n**期待される結果**: ファイルがNotionにアップロードされ、ブラウザで確認できる。\n\n---\n\n## 🚀 Step 4: データベース作成\n\n**AskQuestionの設定例:**\n```json\n{\n \"title\": \"🚀 Step 4: データベース作成\",\n \"questions\": [{\n \"id\": \"step_action\",\n \"prompt\": \"このステップをどうしますか？\",\n \"options\": [\n {\"id\": \"practice\", \"label\": \"このまま進める\"},\n {\"id\": \"review\", \"label\": \"例だけ確認する\"},\n {\"id\": \"skip\", \"label\": \"スキップする\"}\n ]\n }]\n}\n```\n\n**AIが実行すること:**\n\n1. タスク管理用データベースを作成:\n ```bash\n ncli db create --title \"タスク管理\" \\\n --prop \"Name:title\" \\\n --prop \"Status:select=Open,InProgress,Done\" \\\n --prop \"Priority:select=High,Medium,Low\" \\\n --prop \"DueDate:date\" \\\n --prop \"Category:multi_select=開発,デザイン,企画,ドキュメント\"\n ```\n\n2. 作成されたDBの情報を確認:\n - データベースID\n - データベースURL\n - プロパティ一覧\n\n3. `ncli fetch` でスキーマを確認:\n ```bash\n ncli fetch <作成されたDB-URL>\n ```\n\n4. 各プロパティが正しく作成されたか、テーブル形式で表示する:\n\n | プロパティ名 | 型 | 選択肢 |\n |---|---|---|\n | Name | title | - |\n | Status | select | Open, InProgress, Done |\n | Priority | select | High, Medium, Low |\n | DueDate | date | - |\n | Category | multi_select | 開発, デザイン, 企画, ドキュメント |\n\n**期待される結果**: プロパティ付きのデータベースが作成される。\n\n---\n\n## 🚀 Step 5: DBにエントリ追加\n\n**AskQuestionの設定例:**\n```json\n{\n \"title\": \"🚀 Step 5: DBにエントリ追加\",\n \"questions\": [{\n \"id\": \"step_action\",\n \"prompt\": \"このステップをどうしますか？\",\n \"options\": [\n {\"id\": \"practice\", \"label\": \"このまま進める\"},\n {\"id\": \"review\", \"label\": \"例だけ確認する\"},\n {\"id\": \"skip\", \"label\": \"スキップする\"}\n ]\n }]\n}\n```\n\n**AIが実行すること:**\n\n1. Step 4 で作成したDBにタスクを追加:\n ```bash\n ncli page create --parent <DB-URL> \\\n --prop \"Name=APIドキュメント作成\" \\\n --prop \"Status=Open\" \\\n --prop \"Priority=High\" \\\n --prop \"Category=ドキュメント\"\n ```\n\n2. さらにタスクを追加:\n ```bash\n ncli page create --parent <DB-URL> \\\n --prop \"Name=ユーザー認証機能実装\" \\\n --prop \"Status=InProgress\" \\\n --prop \"Priority=High\" \\\n --prop \"Category=開発\"\n ```\n\n3. 3つ目のタスクも追加:\n ```bash\n ncli page create --parent <DB-URL> \\\n --prop \"Name=UIモックアップ作成\" \\\n --prop \"Status=Open\" \\\n --prop \"Priority=Medium\" \\\n --prop \"Category=デザイン\"\n ```\n\n4. 追加されたエントリを確認:\n ```bash\n ncli db query <DB-view-URL>\n ```\n\n5. 結果をテーブル形式で表示し、全タスクが正しく追加されたか確認する。\n\n**期待される結果**: 3件のタスクがDBに追加され、クエリで一覧表示できる。\n\n---\n\n## ⚠️ よくあるトラブルと解決方法\n\n**AskQuestionの設定例:**\n```json\n{\n \"title\": \"トラブル内容を選択\",\n \"questions\": [{\n \"id\": \"trouble\",\n \"prompt\": \"当てはまる内容を1つ選んでください\",\n \"options\": [\n {\"id\": \"trouble_1\", \"label\": \"ページ作成時に Parent not found エラー\"},\n {\"id\": \"trouble_2\", \"label\": \"--body で本文が正しく反映されない\"},\n {\"id\": \"trouble_3\", \"label\": \"ファイルアップロードが失敗する\"},\n {\"id\": \"trouble_4\", \"label\": \"DB作成時にプロパティがエラーになる\"}\n ]\n }]\n}\n```\n\n### トラブル1: ページ作成時に Parent not found エラー\n**原因**: 親ページのURLまたはIDが間違っている\n**解決方法**:\n```text\n以下を確認してください：\n1. 親ページのURLをブラウザから直接コピーする\n2. ncli fetch <親ページURL> で親ページにアクセスできるか確認\n3. --parent を省略してワークスペースのトップレベルに作成を試す\n```\n\n### トラブル2: --body で本文が正しく反映されない\n**原因**: Markdown構文がNotionのブロックに変換されない場合がある\n**解決方法**:\n```text\n以下を試してください：\n1. シンプルなテキストで試す（# 見出し、- リストのみ）\n2. パイプ入力（echo \"...\" | ncli page create --body -）を試す\n3. 長文の場合はファイルに保存してから cat file.md | ncli page create --body -\n```\n\n### トラブル3: ファイルアップロードが失敗する\n**原因**: ファイルサイズが大きすぎる、またはファイルパスが間違っている\n**解決方法**:\n```text\n以下を確認してください：\n1. ファイルパスが正しいか（ls でファイルの存在を確認）\n2. ファイルサイズが5MB以下か確認\n3. 小さなテキストファイルで試してみる\n```\n\n### トラブル4: DB作成時にプロパティがエラーになる\n**原因**: --prop の構文が間違っている\n**解決方法**:\n```text\n--prop の正しい構文：\n- タイトル: --prop \"Name:title\"\n- セレクト: --prop \"Status:select=Option1,Option2\"\n- マルチセレクト: --prop \"Tags:multi_select=Tag1,Tag2\"\n- 日付: --prop \"Date:date\"\n- 数値: --prop \"Count:number\"\nプロパティ名にスペースを含む場合はクォーテーションで囲んでください。\n```\n\n---\n\n## ✅ チェックポイント\n- [ ] `ncli page create` でページが作成できる\n- [ ] `--body` オプションで本文付きページが作成できる\n- [ ] `ncli file upload` でファイルがアップロードできる\n- [ ] `ncli db create` でプロパティ付きDBが作成できる\n- [ ] DBにエントリ（ページ）を追加できる\n\n---\n\n## 📋 成果物プレビュー\n\nこのレッスンで得られる成果物:\n\n| 成果物 | 説明 |\n|--------|------|\n| ncli テストページ | シンプルなページ（タイトルのみ） |\n| 議事録テンプレート | 本文付きページ（Markdown形式） |\n| アップロードファイル | Notionにアップロードされたファイル |\n| タスク管理DB | 5つのプロパティを持つデータベース |\n| タスクエントリ 3件 | DBに追加されたサンプルタスク |\n\n---\n\n## ➡️ 次のステップ\n\nこれでページ・DB・ファイルの作成は完了です。次のレッスンでは、既存コンテンツの書き込みと更新を学びます。\n\n**AskQuestionの設定例:**\n```json\n{\n \"title\": \"次のステップを選択\",\n \"questions\": [{\n \"id\": \"next_step\",\n \"prompt\": \"次に進む操作を選んでください\",\n \"options\": [\n {\"id\": \"next_auto\", \"label\": \"次のセクションを開始（/next_lesson）\"},\n {\"id\": \"next_window\", \"label\": \"新しいウィンドウで開始（/start-12-5）\"},\n {\"id\": \"finish\", \"label\": \"ここで終了する\"}\n ]\n }]\n}\n```\n\n**選択後の案内:**\n- next_auto → /next_lesson\n- next_window → 新しいウィンドウで /start-12-5\n- finish → 終了", "variables": [], "notes": "Lesson command", "metadata": { "source": { "provider": "github-cursor-commands", "repository": "https://github.com/minicoohei/ai-agent-camp", "path": ".cursor/commands/lesson/start-12-4.md", "ref": "048ba4cfff8eccbffc18e39e61b6ce7b681cb1ff", "url": "https://github.com/minicoohei/ai-agent-camp/blob/048ba4cfff8eccbffc18e39e61b6ce7b681cb1ff/.cursor/commands/lesson/start-12-4.md", "key": "minicoohei/ai-agent-camp/.cursor/commands/lesson/start-12-4.md" } } }

start-12-4

About

🎓 Lesson 12-4: ファイル作成・ページ作成

📍 このセッションでやること

🎯 準備チェック

🚀 Step 1: シンプルなページ作成

🚀 Step 2: 本文付きページ作成（パイプ入力）

日時

参加者

議題

決定事項

次のアクション

セクション1

🚀 Step 3: ファイルアップロード

🚀 Step 4: データベース作成

🚀 Step 5: DBにエントリ追加

⚠️ よくあるトラブルと解決方法

トラブル1: ページ作成時に Parent not found エラー

トラブル2: --body で本文が正しく反映されない

トラブル3: ファイルアップロードが失敗する

トラブル4: DB作成時にプロパティがエラーになる

✅ チェックポイント

📋 成果物プレビュー

➡️ 次のステップ

Install start-12-4 and it becomes one more candidate the router can pick - when it fits.

What it costs to adopt - in engineering time.

One base URL

No vendor lock-in

Failover built in

Use it

Manifest

Reviews