mcpField
N
notion-apps

notion-apps

github.com/makenotion開発177341 回インストール5 週間前に更新
リポジトリ

notion-apps について

notion-appsは、Notion CLIとSDKでNotion Appsを開発するためのスキルです。Alpha利用資格の確認からプロジェクト作成、生成された開発ガイドへの準拠までを案内します。

主な機能

  1. 01作業前のAlpha利用資格確認
  2. 02Notion CLIの確認とインストール
  3. 03依存関係とGitを含むプロジェクト作成
  4. 04生成されたAGENTS.mdガイドの確認

活用シーン

  1. 01App開発開始前の資格確認
  2. 02新しいNotion Appプロジェクトの作成
  3. 03プロジェクト固有ガイドに沿った実装

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/makenotion/skills --skill notion-apps

インストール後、Claude Code で/notion-appsを入力して読み込まれたか確認します。

同梱ファイルagents/openai.yaml

詳細

Notion Apps

アルファ版へのアクセスを確認する

コマンドを実行したり、App プロジェクトを調べたりする前に、Notion Apps のアルファ版に参加していることをユーザーに確認してください。CLI 認証、CLI 実験の有効化、または SDK がローカルで動作することは、アルファ版へのアクセスを確認するものではありません。ユーザーが参加していない、または確認できない場合は、SDK のコードはローカルでビルドできても、デプロイにはアルファ版へのアクセスが必要であることを説明し、App のワークフローを中止してください。

セットアップとスキャフォールド

アルファ版へのアクセスが確認できたら、ntn --version で Notion CLI がインストールされていることを確認してください。インストールされていない場合は、ユーザーのプラットフォームに対応するコマンドでインストールしてください。

# macOS and Linux
curl -fsSL https://ntn.dev | bash

# Windows
winget install Notion.ntn

依存関係をインストールし、Git を初期化した状態で、新しい App プロジェクトをスキャフォールドしてください。

ntn apps new --install --git <app-directory>

必ず明示的な配置先を指定してください。エージェントは CLI の対話式ディレクトリプロンプトを使用できません。現在のディレクトリが空で、適切なプロジェクトルートである場合は . を使用してください。それ以外の場合は、ユーザーの依頼または周辺のコンテキストから適切なディレクトリを推測してください。安全な配置先を推測できない場合は、スキャフォールドを行う前にプロジェクトの配置先を尋ねてください。apps コマンドを使用できない場合は、ntn experiments enable apps で有効にしてから再試行してください。

プロジェクトが作成されたら、そのルートから作業し、AGENTS.md の内容をすべて読んでください。このファイルには、生成されたプロジェクトの App の設計、実装、機能、デプロイに関するガイダンスが記載されています。以降の作業では、このガイダンスと、インストール済み SDK のバージョン固有のガイダンスに従ってください。

コメント

Markdown 対応