ag-dev

使用されている AG 製品、そのバージョン、ラッパーフレームワークを把握する

使用されている製品は、コンテキストから明らかな場合があります。そうでない場合は、機能がインポートされているパッケージから判断できます。

• grid パッケージは @ag-grid- または ag-grid- で始まります
• charts パッケージは ag-charts- で始まります
• studio パッケージは ag-studio、または ag-studio- で始まります

以下の {product} は、grid、charts、studio のいずれかを指します。

バージョンは、プロジェクトの package.json を確認するか、node_modules 内にインストールされたライブラリの package.json を読んで判断できます。

フレームワークは、それらのフレームワークを使用している場合は react、vue、angular、Vanilla JS アプリやその他のフレームワーク（Svelte、Solid など）を使用しているアプリでは javascript です。

パッケージのバージョンを更新する場合は、ag-update スキルを使う

このスキルには、関連するスキル「ag-update」が付属しています。grid、charts、studio のパッケージの更新を依頼された場合は、そちらに委任してください。

推測しない

コードを書くときは必ず、使用する API の明確な根拠が必要です。既存のパターンに従う、ユーザーの指示を参照する、またはドキュメントを確認してください。不確かな場合は、調査して根拠を確かめてください。

汎用的なプリミティブより、目的に特化した機能を優先する

製品に、構築する機能に特化した機能が用意されている場合は、それを使ってください。同じ見た目の結果を実現する valueGetter、カスタムセルレンダラー、手作業で管理する状態、独自のイベント配線を使うのではありません。並べ替え、フィルタリング、集計、エクスポート、UI は組み込み機能をすべて認識します。一方、プリミティブは不透明なアプリケーションコードであり、その動作を再実装し、手作業で整合性を保つ必要があります。

「プリミティブが正しい値を描画する」ことは、組み込み機能を使わない理由にはなりません。その機能に馴染みがないことも理由にはなりません。学習データは現在のバージョンより古いため、馴染みがないからといって、サポートされていない証拠にはなりません。

実装する前に確認してください。 プリミティブを使って要求された機能を構築する前に、references/{product}/documentation-index.md を確認し、その機能を説明するスラッグがあるか探してください。該当する可能性がある場合は、そのページを読んでください。Enterprise 機能については、製品の推奨事項に記載されているモジュール登録のガイダンスに従ってください。

原則としてドキュメントを参照する

コードを書く際には、次の 2 つの問題に直面します。

1. 学習データには、多くの非推奨・削除済み API やパッケージ名が含まれており、新しい API が含まれていない場合があります。
2. API には、分かりにくいエッジケースや他の機能との相互作用があります。

どちらの問題も、ドキュメントを参照することで解決できます。

使用する API が明確な場合、たとえば特定の API が明記された詳細な計画に従う場合や、コードベース内にコピーできる例がある場合は、直接コードを書いてもかまいません。

それ以外で不確かな点がある場合は、ドキュメントを確認してください。使用中のバージョンに対応する正しいドキュメント URL を見つけるには、references/{product}/documentation-index.md を読み、そのファイルの指示に従ってください。

作業する機能をドキュメント内で見つけ、エッジケースや他の機能との相互作用について把握するために、前後の段落も読んでください。

製品固有の推奨事項を読み込む

references/{product}/recommendations.md には、LLM でよく発生する失敗パターンや、バージョン間で変更された重要な API を含む、各製品固有のアドバイスが記載されています。開発時に読み込み、考慮してください。