本文へ移動
cccskills
無料GitHub で公開日本語紹介

query

APIの一覧取得に使う絞り込み条件や並び順を、許可する項目や演算子、カーソル式ページ送りと合わせて設計するスキルです。

原文原文の説明を見る

How list endpoints take filters and sorts, modelled on Stream's query syntax. Read before adding a filter, a sort, or a query endpoint.

GetStream/Agentsスター 8,215(GitHub 8,215 + cccskills 0)

実行スコア 未検証

インストール方法を見る

こんなときに便利

  • 一覧APIに絞り込みを追加したいとき
  • ソート可能な検索エンドポイントを設計するとき
  • クエリで許可する項目を整理したいとき
  • カーソル式ページ送りを実装するとき

日本語での紹介

できること

一覧取得APIで使う絞り込み条件と並び順を、Streamのクエリ構文に沿って設計します。等価・範囲・複数候補・全文検索などの演算子、論理条件の組み合わせ、並び順の許可項目を定め、入力値の型や未対応条件を検証する方針を示します。フィルター項目はインデックスで処理できるものに限定し、利用者の項目名をそのままSQLに渡さない設計も扱います。結果は件数指定とカーソルによるページ送りで返し、並び順の情報を含むカーソルで重複や抜けを防ぎます。Goでは型付きリクエストや条件ツリーを使って検証・SQL条件への変換を行い、メモリ上のデータとPostgresの結果を同じ条件で扱う方法も説明します。

こんなときに便利

既存の簡単な一覧APIに条件が増え、クエリパラメーターを追加し続ける代わりに専用の検索エンドポイントを設計したいときに役立ちます。利用者が指定できる条件を明確にし、検索性能やページ送りを含めてAPIの仕様を整えたい開発者にも向いています。

使い方の例

  • 「このリソースの一覧APIに、状態と作成日時の絞り込みを追加する設計を整理して」
  • 「許可するフィルターとソート項目を定め、カーソルページングの仕様を書いて」

注意点

ページ位置の設計には別スキルの pagination を先に読みます。Goの実装例を中心に説明しています。

この紹介文は、公開されている SKILL.md をもとに AI(OpenAI Codex)が作成しました。正確な仕様は下の原文を確認してください。

資料チェック

SKILL.md の記述から、注意が要る操作と導入の前提を AI が確認しました。点数は実際に動かした結果(実行検証)だけで付けています。

安全面送信・削除・コマンド実行などの扱いが明示されているか
A良好呼び出し元の項目名をSQLへ渡さず、許可リスト照合と型検証を指定。
導入のしやすさ必要なツールや API キーが少ないか、書かれているか
A良好Go例と別スキルの参照を示すが、キーや外部サービスは求めない。

点数には入れていません。 2026年11月18日 時点で AI(OpenAI Codex)が判定しました。目安なので、入れる前に原文も確認してください。

評価が違うと思ったら、見直しを依頼する

どの項目が、なぜ違うと思うかを書いてください。ログインは不要です。内容を SKILL.md と照らし合わせて評価を作り直し、この欄に反映します。

このフォームは reCAPTCHA で保護されており、Google のプライバシーポリシーと利用規約が適用されます。

含まれるファイル(1)

  • SKILL.md6.4 KB

SKILL.md(原文)

インストールする前に、エージェントに与えられる指示の中身を確認できます。

レビュー

まだレビューはありません。使ってみた感想をお寄せください。

コメント

ログインなしで書き込めます。使ってみた感想、質問、動かなかった環境などを気軽にどうぞ。

まだコメントはありません。最初のコメントを書いてみませんか。

送信するとすぐに公開されます。メールアドレスや電話番号などの個人情報は書かないでください。URL は 2 つまでです。

0 / 1000 文字

このフォームは reCAPTCHA で保護されており、Google のプライバシーポリシーと利用規約が適用されます。

同じリポジトリのスキル

accelerate-sales-engineer

無料概要あり

企業のWebサイトや競合情報をもとに、Stream Agentsを使った顧客向けデモを組み立て、会話UIと確認用リンク、短い実演台本を用意します。

  • 見込み顧客向けデモの作成
  • 商談用POCの準備
  • 企業別エージェントの試作
GetStream/Agents8,2152026年11月18日 更新

add-connector

無料概要あり

アプリ専用のMCPサーバー接続をコードなしで登録する方法と、カタログに組み込むコネクターのYAML定義、同意テスト、改訂管理の手順を案内します。

  • アプリ専用MCP接続の登録
  • カタログへのプロバイダー追加
  • 組み込みマニフェストの変更
GetStream/Agents8,2152026年11月18日 更新

check_prices

無料概要あり

ルーターが参照するベンダー料金を公開価格と照合し、差異の状況をまとめて、各環境向けの変更案と価格表更新用のPR案を準備します。

  • ベンダーの価格改定を確認したいとき
  • リリース前に料金表を点検したいとき
  • 未設定や古い料金を見つけたいとき
GetStream/Agents8,2152026年11月18日 更新

cli

無料概要あり

`getstream agents` コマンドが接続するローカルまたはホスト版ルーターの設定方法と、認証や初期化、エラーの切り分け方を確認できます。

  • ローカルルーターに接続したいとき
  • プロジェクトをアプリに紐付けたいとき
  • CLIの認証や応答エラーを調べたいとき
GetStream/Agents8,2152026年11月18日 更新

commit

無料概要あり

変更を論理単位で整理し、規約に沿ったGitコミットを作成するスキルです。ブランチやコミットフックの確認、失敗時の修正と再実行も扱います。

  • 変更を規約に沿ってコミットしたいとき
  • 必要なファイルだけをステージしたいとき
  • コミットフックの失敗を解消したいとき
GetStream/Agents8,2152026年11月18日 更新

connectors

無料概要あり

外部サービスのアカウントをルーターに接続し、エージェントに使わせるツールや利用者ごとの認証を設定します。接続や応答の問題を調べる手順も扱います。

  • 外部サービスをエージェントにつなぎたいとき
  • 利用者ごとのアカウントを設定したいとき
  • エージェントが使えるツールを選びたいとき
GetStream/Agents8,2152026年11月19日 更新

GetStream のスキルをすべて見る

このスキルの問題を報告する