sf-soql
SOQLクエリの生成・最適化・分析を100点満点でスコアリングします。ユーザーがSOQL/SOSLクエリの作成・最適化・デバッグを行う場合、`.soql`ファイルを操作する場合、またはリレーションシップクエリ・集計・クエリパフォーマンスについて質問する場合にトリガーします。バルクデータ操作(`sf-data`を使用)、Apex DMLロジック(`sf-apex`を使用)、レポート/ダッシュボードのクエリには使用しません。
description の原文を見る
> SOQL query generation, optimization, and analysis with 100-point scoring. TRIGGER when: user writes, optimizes, or debugs SOQL/SOSL queries, touches .soql files, or asks about relationship queries, aggregates, or query performance. DO NOT TRIGGER when: bulk data operations (use sf-data), Apex DML logic (use sf-apex), or report/dashboard queries.
SKILL.md 本文
sf-soql: Salesforce SOQL クエリエキスパート
ユーザーが SOQL/SOSL の作成または最適化 を必要とする場合、このスキルを使用します。自然言語からのクエリ生成、リレーションシップクエリ、集計、クエリプラン分析、Salesforce クエリのパフォーマンス/セーフティ改善が対象です。
このスキルがタスクを担当する場合
以下の作業を含む場合、sf-soql を使用します:
.soqlファイル- 自然言語からのクエリ生成
- リレーションシップクエリと集計クエリ
- クエリの最適化と選択性分析
- SOQL/SOSL シンタックスとガバナー対応設計
以下の場合は他にデリゲートします:
- バルクデータ操作を実行している →
sf-data - より広い Apex 実装内にクエリロジックを埋め込んでいる →
sf-apex - ログ経由でのデバッグ(クエリ形状ではなく) →
sf-debug
最初に収集すべき必須コンテキスト
以下を質問するか推測します:
- 対象オブジェクト
- 必要なフィールド
- フィルタ条件
- ソート/制限要件
- クエリが表示、オートメーション、レポートのような分析、または Apex 使用のいずれかであるか
- パフォーマンス/選択性が既に懸念事項であるか
推奨ワークフロー
1. 最もシンプルな正しいクエリを生成する
優先事項:
- 必要なフィールドのみ
- 明確な WHERE 条件
- 適切な LIMIT
- 必要な深さまでのみのリレーションシップ深度
2. 正しいクエリ形状を選択する
| ニーズ | デフォルトパターン |
|---|---|
| 子から親データを取得 | 子から親へのトラバーサル |
| 親から子行を取得 | サブクエリ |
| カウント/ロールアップ | 集計クエリ |
| 関連行あり/なしのレコード | セミジョイン/アンチジョイン |
| オブジェクト全体のテキスト検索 | SOSL |
3. 選択性とセーフティのために最適化する
確認事項:
- インデックス付き/選択的なフィルタ
- 不要なフィールドなし
- 回避可能なワイルドカードまたはスキャン集約的なパターンなし
- セキュリティ実施期待値
4. 必要に応じて実行パスを検証する
ユーザーが実行時検証を希望する場合、以下に実行をハンドオフします:
sf-data
高シグナルルール
SELECT *スタイルの考え方は絶対に使用しない。必要なフィールドのみをクエリする- Apex コンテキストではループ内でクエリを実行しない
- Apex での事後フィルタリングではなく、SOQL でフィルタリングする方を優先する
- 不要なレコードをロードする代わりに、カウントとグループ化されたサマリーには集計を使用する
- ワイルドカード使用は慎重に評価する。先頭ワイルドカードはインデックスを無効にすることが多い
- クエリが Apex に移動する場合、セキュリティモード/フィールドアクセス要件を考慮する
出力フォーマット
完了時に、この順序で報告します:
- クエリの目的
- 最終的な SOQL/SOSL
- この形状が選ばれた理由
- 最適化またはセキュリティに関する注釈
- 必要に応じて実行提案
推奨される形式:
Query goal: <summary>
Query: <soql or sosl>
Design: <relationship / aggregate / filter choices>
Notes: <selectivity, limits, security, governor awareness>
Next step: <run in sf-data or embed in Apex>
スキル間統合
| ニーズ | デリゲート先 | 理由 |
|---|---|---|
| org に対してクエリを実行する | sf-data | 実行とエクスポート |
| サービス/セレクタにクエリを埋め込む | sf-apex | 実装コンテキスト |
| ログから低速クエリの症状を分析する | sf-debug | 実行時エビデンス |
| クエリ支援 UI をワイヤリングする | sf-lwc | フロントエンド統合 |
リファレンスマップ
ここから始める
references/soql-syntax-reference.mdreferences/query-optimization.mdreferences/cli-commands.md
専門的なガイダンス
references/soql-reference.mdreferences/anti-patterns.mdreferences/selector-patterns.mdreferences/field-coverage-rules.mdassets/
スコアガイド
| スコア | 意味 |
|---|---|
| 90+ | 本番環境最適化クエリ |
| 80–89 | 良いクエリだが小さな改善が可能 |
| 70–79 | 機能するがパフォーマンスの懸念が残る |
| < 70 | 本番環境使用前に改訂が必要 |
ライセンス: MIT(寛容ライセンスのため全文を引用しています) · 原本リポジトリ
詳細情報
- 作者
- jaganpro
- リポジトリ
- jaganpro/sf-skills
- ライセンス
- MIT
- 最終更新
- 不明
Source: https://github.com/jaganpro/sf-skills / ライセンス: MIT
関連スキル
hugging-face-trackio
Trackioを使用してMLトレーニング実験を追跡・可視化できます。トレーニング中のメトリクスログ記録(Python API)、トレーニング診断のアラート発火、ログされたメトリクスの取得・分析(CLI)が必要な場合に活用してください。リアルタイムダッシュボード表示、Webhookを使用したアラート、HF Space同期、自動化向けのJSON出力に対応しています。
btc-bottom-model
ビットコインのサイクルタイミングモデルで、加重スコアリングシステムを搭載しています。日次パルス(4指標、32ポイント)とウィークリー構造(9指標、68ポイント)の2カテゴリーにわたる13の指標を追跡し、0~100のマーケットヒートスコアを算出します。ETFフロー、ファンディングレート、ロング/ショート比率、恐怖・貪欲指数、LTH-MVRV、NUPL、SOPR(LTH+STH)、LTH供給率、移動平均倍率(365日MA、200週MA)、週次RSI、出来高トレンドに対応します。市場サイクル全体を通じて買いと売りの両方の推奨を提供します。ビットコインの底値拾い、BTCサイクルポジション、買い時・売り時、オンチェーン指標、MVRV、NUPL、SOPR、LTH動向、ETFの流出入、ファンディングレート、恐怖指数、ビットコインが過熱状態か、マイナーコスト、暗号資産市場のセンチメント、BTCのポジションサイジング、「今ビットコインを買うべきか」「BTCが天井をつけているか」「オンチェーン指標は何を示しているか」といった質問の際にこのスキルを活用します。
protein_solubility_optimization
タンパク質の溶解性最適化 - タンパク質の溶解性を最適化します。タンパク質の特性を計算し、溶解性と親水性を予測し、有効な変異を提案します。タンパク質配列の特性計算、タンパク質機能の予測、親水性計算、ゼロショット配列予測を含むタンパク質エンジニアリング業務に使用できます。3つのSCPサーバーから4つのツールを統合しています。
research-lookup
Parallel Chat APIまたはPerplexity sonar-pro-searchを使用して、最新の研究情報を検索できます。学術論文の検索にも対応しています。クエリは自動的に最適なバックエンドにルーティングされるため、論文の検索、研究データの収集、科学情報の検証に活用できます。
tree-formatting
ggtree(R)またはiTOL(ウェブ)を使用して、系統樹の可視化とフォーマットを行います。系統樹を図として描画する際、ツリーレイアウトの選択、分類学に基づく枝やラベルの色付け、クレードの折りたたみ、サポート値の表示、またはツリーへのオーバーレイ追加が必要な場合に使用してください。系統推定(protein-phylogenyスキルを使用)やドメイン注釈(今後の独立したスキル)には使用しないでください。
querying-indonesian-gov-data
インドネシア政府の50以上のAPIとデータソースに接続できます。BPJPH(ハラール認証)、BOM(食品安全)、OJK(金融適正性)、BPS(統計)、BMKG(気象・地震)、インドネシア中央銀行(為替レート)、IDX(株式)、CKAN公開データポータル、pasal.id(第三者法MCP)に対応しています。インドネシア政府データを活用したアプリ開発、.go.idウェブサイトのスクレイピング、ハラール認証の確認、企業の法的適正性の検証、金融機関ステータスの照会、またはインドネシアMCPサーバーへの接続時に使用できます。CSRF処理、CKAN API使用方法、IP制限回避など、すぐに実行可能なPythonパターンを含んでいます。