using-geoscience-skills

地球科学スキルの使用

ユーザーのタスクを、利用可能な分野別スキルおよびワークフロースキルに対応付けます。依頼された結果に必要な手順だけを選び、すでに提供されているデータやコードを再利用します。

使用する場面と代替手段

適切な地球科学ライブラリが不明な場合、依頼が複数の分野にまたがる場合、または複数のスキルを連携させる必要がある場合に、このスキルを使用します。ライブラリが指定されている場合や、操作が1つに絞られている場合は、その分野別スキルを直接使用します。複数の手順からなる確立されたタスクには、以下に該当するワークフロースキルを使用します。

振り分け手順

1. 求められている成果物、データ形式、既存の入力、および環境を特定します。
2. 分野別テーブルを使って焦点の絞られたタスクを、またはワークフローテーブルを使って複数手順のタスクを対応付けます。記載されたスキルの連鎖は利用可能な選択肢として扱い、必須の段階とはみなしません。
3. 現在のホストで利用可能なスキルを確認します。ホストで利用可能なファイルまたはリソースへのアクセス手段を使って、選択したスキルの SKILL.md と、タスクに必要な参照ファイルのみを読みます。
4. スキルが見つからない、または利用できない場合は、実用可能な範囲で、利用できるドキュメントと機能を使って続行します。重要な制約があれば明示します。アクセスできなかったスキルを読み込んだ、または呼び出したと主張してはいけません。
5. 関連する検証を行い、ユーザーが求めた成果物を完成させます。不足情報が結果に重大な影響を及ぼす場合に限り、確認を求めます。可能な場合は、独立して進められる作業を続行します。

ドメインルーティングテーブル

ユーザーの意図を示すキーワードに基づいて、適切なドメインスキルを選択します。

キーワード／トリガー	スキル	ドメイン
SEG-Y、地震トレース、トレースヘッダー、インライン、クロスライン	segyio	地震データ I/O
SEG-Y から xarray への変換、ラベル付き地震キューブ、Dask による地震データ処理	segysak	地震データ I/O
波形、地震、FDSN、地震記象、miniSEED	obspy	地震学
表面波、分散、レイリー波、ラブ波	disba	地震学
LAS、坑井ログ、ワイヤーライン、坑井曲線	lasio	坑井ログ
DLIS、RP66、配列ログ、新しい坑井データ	dlisio	坑井ログ
坑井解析、曲線の品質管理、複数坑井、スパイク除去	welly	坑井ログ
岩石物理検層、Sw、孔隙率、地層評価	petropy	岩石物理検層
岩相、層序、striplog、岩相ログ	striplog	層序学
3D モデル、地質、陰的曲面、断層	gempy	3D モデリング
褶曲モデリング、構造フレーム、Loop3D	loopstructural	3D モデリング
GIS、空間データの前処理、坑井データから GemPy への変換	gemgis	GIS 前処理
既存のライセンス済み GeoLime プロジェクト、採掘ブロックモデル API	geolime	ライセンス済みモデリング
インバージョン、直流比抵抗、磁気、重力、電磁法	simpeg	インバージョン
TensorMesh、TreeMesh、セル／面演算子、有限体積メッシュ	discretize	メッシュ
ERT、SRT、IP、浅部インバージョン	pygimli	インバージョン
PDE、波動方程式、有限差分、ステンシル	devito	シミュレーション
線形演算子、逆問題、スパース性	pylops	逆問題
重力、磁気、ブーゲー、上方接続	harmonica	ポテンシャル場
参照楕円体、標準重力、地心緯度	boule	測地学
AVO、Zoeppritz、Gassmann、流体置換、ウェーブレット	bruges	岩石物理
グリッディング、補間、空間、Verde	verde	空間解析
バリオグラム、クリギング、GSLIB、地球統計学	geostatspy	地球統計学
バリオグラムのフィッティング、scikit-learn スタイルの地球統計	scikit-gstat	地球統計学
空間回帰、GWR、GNNWR、非定常性、係数マッピング	gnnwr	空間回帰
地下水、時系列、揚水試験	pastas	水文学
MODFLOW、帯水層流動、水頭、涵養、水収支	flopy	水文学
景観、侵食、地表プロセス、DEM	landlab	地表プロセス
ステレオネット、走向、傾斜、極、構造地質	mplstereonet	構造地質学
地球化学、REE、スパイダーダイアグラム、三角図	pyrolite	地球化学
GPR、地中レーダー、レーダーグラム	gprpy	浅部探査
マグネトテルリクス、MT、インピーダンステンソル	mtpy	浅部探査
NetCDF、xarray、多次元、気候	xarray	データ形式
古気候プロキシ、年代アンサンブル、不規則スペクトル	pyleoclim	古気候学
3D 可視化、メッシュ、VTK、点群	pyvista	可視化
GMT、PyGMT、地図投影、地理グリッド地図作成	pygmt	地図作成
データのダウンロード、サンプルデータ、キャッシュ、取得	pooch	ユーティリティ
Fatiando データセット、明示的なデータセットバージョン、Ensaio	ensaio	データセット
既存の RockHound キャッシュ、旧式 PREM ローダーの移行	rockhound	旧式データセット

ワークフロースキル

ホストがスキル選択に対応している場合はスキル名を直接指定するか、利用可能なワークフローの手順を確認してください。自然言語のリクエストから、これらのタスクに該当するものを選べます。

スキル名	代表的なタスク	関連する専門スキル
seismic-interpretation	地震データを処理または解釈する、地震探査データと坑井データを対比する	segyio、obspy、bruges、disba、pyvista
well-log-evaluation	LAS または DLIS のログから地層を評価する	lasio、dlisio、welly、petropy、striplog、pyvista
geological-modelling	マッピング、ボーリング孔、GIS 入力から 3D モデルを構築する	gemgis、gempy または loopstructural、pyvista
geophysical-inversion	ERT、電磁探査、重力探査、磁気探査から物理特性を推定する	simpeg または pygimli、verde、pyvista
rock-physics-avo	弾性特性、流体置換、AVO、合成データを計算する	lasio、welly、bruges、segyio
hydrogeological-analysis	坑井ログ、地下水位の時系列、帯水層の仮説を組み合わせる	lasio、welly、pastas、必要に応じて flopy
near-surface-geophysics	座標と分解能を揃えて GPR、ERT、MT の証拠を比較する	gprpy、pygimli または simpeg、mtpy
climate-analysis	気候の時系列とグリッド化された空間観測データをリークなく分析する	xarray、verde、必要に応じて pyleoclim

構成とデータの引き渡し

• すでに利用可能な入力から開始します。データの読み込み、モデリング、プロット、エクスポートは、依頼されたタスクに役立つ場合にのみ行ってください。
• ライブラリ間で単位、座標、深度または時間の基準、配列の形状、欠損値マスク、データの来歴を引き継ぎます。後続の段階で、意図した処理済みの出力が使われていることを確認してください。
• 選択した各スキルの metadata.dependencies を環境と照合します。依存関係と補完関係の一覧は説明用のメタデータであり、パッケージのインストールコマンドでも、別のスキルが利用可能であることの証明でもありません。
• 選択した分岐に適合するライブラリとアダプターを選択します。代替手段が相互に置き換え可能なオブジェクトを生成すると想定しないでください。
• 成果物に合わせて検証を行います。修正済みスクリプト、説明、QC レポート、モデル、プロット、エクスポート済みデータセットのいずれも、ユーザーの依頼を完了する成果物になり得ます。

任意の役割リファレンス

リポジトリ内の agents/data-qc-reviewer.md、agents/geoscience-mentor.md、agents/cross-validation-reviewer.md は、対応しているホストで使用できる任意の役割リファレンスです。通常のスキルのインストールでは、これらのファイルが含まれないことがあります。利用可能な機能を使って QC と説明を行ってください。これらの役割やホスト固有の統合は、コアスキルの振り分けや実行に必須ではありません。

よくある問題

問題	対応
推奨されるスキルがインストールされていない	利用可能なガイダンスや機能を使い、重要な不足があれば報告します。
必要な Python パッケージが利用できない	適合する環境設定や代替手段を選ぶ前に、プロジェクトの環境と依存関係のガイダンスを確認します。
データがすでに読み込み済み、または処理済みである	該当する段階から開始し、提供されたデータの前提条件を確認します。
リクエストに合致するライブラリが複数ある	データ形式、必要な処理、既存の環境、求められる結果に基づいて選択します。