notis-query について
notis-queryは、Notisデータベースをネイティブな構造化クエリで操作するスキルです。スキーマの確認、全ページの取得、リビジョンを考慮したレコード操作と書き込みを支援します。
主な機能
- 01データベースのスキーマと対象の確認
- 02フィルター・ソート・集計・ページング
- 03全ページにわたるクエリ
- 04関連レコードとビューの読み取り
- 05リビジョン確認と再読み取りによる書き込み保護
活用シーン
- 01フィールド条件に合うレコードの検索
- 02件数や集計値の算出
- 03データベースクエリの全ページ取得
- 04レコード更新後の結果確認
MCP 対応
このスキルは、データベースの検出、クエリ、書き込みを含むNotisネイティブデータベースツールの利用方法を説明します。ホスト型MCPでは関連するリファレンスガイドが提供されます。
インストール
コマンドをコピーしてターミナルで実行します。
$
npx skills add https:/ / github.com/ mindtheflo/ notis-skills --skill notis-queryインストール後、Claude Code で/notis-queryを入力して読み込まれたか確認します。
同梱ファイル
SKILL.md と一緒にインストールされる参考資料やスクリプト。
references/database-discovery.mddocuments.mdquery.md詳細
ネイティブデータベースクエリ
フィルタリング、並べ替え、件数、集計、ページネーションには、構造化されたネイティブクエリを使用します。意味に基づく探索にはメモリを、ページの表示内容を確認するにはビューのレンダリングを使用します。ライブツールの inputSchema が正式な仕様です。
LOCAL_NOTIS_DATABASE_GET_DATABASEを使用してデータベースを見つけ、スキーマ、プロパティの説明、リレーションの参照先、オプション ID を確認します。- 返されたネイティブの
target、スキーマのリビジョン、利用可能な操作をそのまま保持します。すべてのデータベースは Space に属します。アクセスに失敗しても、別の所有者へのフォールバックは行われません。 LOCAL_NOTIS_DATABASE_QUERYにprotocol: 1、そのtarget、直接のinputを指定して使用します。実際のフィールド型とオプションに基づいてフィルターを作成します。返された継続情報がなくなるまでページを取得します。1 ページだけではデータベース全体を取得したことにはなりません。- レコードまたはビューのリンクがわかっている場合は、広範な探索を行わず、レコードの読み取りに従います。ビューのリンクは書き込み結果または
LOCAL_NOTIS_FIND_VIEWSから取得します。機密性の高い情報や古い可能性のある情報については、改めてレンダリングして確認する必要があります。 - 書き込みには、現在のスキーマ/レコードのリビジョンと安定したリクエスト ID を使用して、検出済みのネイティブツールを使用します。まずドライランを実行し、コミットされた状態を読み戻して確認します。ビューのリンクがないことは書き込みの失敗を意味せず、再実行の理由にもなりません。
Space のコードを作成する場合は、アカウント全体に適用されるツール呼び出しではなく、useShown または宣言済みのアクションを使用します。Space の作成については notis-spaces を読み込みます。ホストされているリファレンスは notis://docs/notis-spaces/references/views.md です。
ガイド
ホスト型 MCP では、これらのリファレンスを notis://docs/notis-query/references/<file>.md で公開しています。関連するガイドのみを読み込んでください。
コメント
Markdown 対応