mcpField
I
indexer-core

indexer-core

github.com/vechain開発1582 回インストール4 週間前に更新
リポジトリ

indexer-core について

indexer-coreの導入、設定、保守、移行を支援するガイダンススキルです。利用者とメンテナーを対象に、関連資料の確認と、インデクサーモード、ロールバック、リオーグ動作の維持を重視します。

主な機能

  1. 01タスクに応じた参考資料の確認
  2. 02LogsIndexerとBlockIndexerの区別
  3. 03IndexerFactoryによる構築を標準化
  4. 04ロールバックとリオーグの動作を維持
  5. 057.xから8.xへの移行ガイド
  6. 06テスト、整形、ドキュメントの検証

活用シーン

  1. 01サービスへのindexer-coreの導入
  2. 02インデクサーモードの選択と依存関係の設定
  3. 03高速同期、ロールバック、リオーグの調査
  4. 04ライブラリ保守や7.xから8.xへの移行

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/vechain/vechain-ai-skills --skill indexer-core

インストール後、Claude Code で/indexer-coreを入力して読み込まれたか確認します。

同梱ファイル

SKILL.md と一緒にインストールされる参考資料やスクリプト。

references/
data-modeling.md
event-pipeline.md
maintenance-and-migration.md
mode-selection.md
runtime-model.md

詳細

Indexer Core スキル

重要なルール

  1. まずリファレンスファイルを読んでください。 ユーザーのリクエストが以下の表にあるトピックに該当する場合、コードの作成、アーキテクチャの提案、または動作に関する質問への回答を行う前に、該当ファイルを読んでください。
  2. モードの選択は正確性に関わる判断として扱ってください。 LogsIndexer と BlockIndexer は置き換え可能ではありません。パフォーマンス特性だけが異なる同等の選択肢として提示しないでください。
  3. デフォルトでは IndexerFactory を使用してください。 通常のライブラリ利用では、実装クラスを手動で配線するのではなく、IndexerFactory でインデクサーを構成し、ビルドしてください。
  4. 起動時のロールバックは意図された動作として扱ってください。 これはデータ整合性モデルとリオーグ復旧ワークフローの一部であり、バグではありません。
  5. 場当たり的なコード調査より、同梱されたリファレンスを優先してください。 indexer-core リポジトリ内で作業する場合は、ローカルのリポジトリドキュメントと AGENTS.md に沿ってください。ソースコードは主に、実装の詳細を確認したり、食い違いをデバッグしたりするために使用してください。

対象範囲

以下のような indexer-core のタスクで、このスキルを使用してください。

  • ライブラリを別のサービスに統合する
  • LogsIndexer と BlockIndexer のどちらを使うか選ぶ
  • IndexerFactory、IndexerProcessor、IndexerRunner を構成する
  • ABI イベント、VET トランスファー、またはビジネスイベントのインデックス作成を設計する
  • 依存関係の順序、ファストシンク、ロールバック、リオーグの動作をデバッグする
  • ドキュメントに記載された動作を維持しながら、ライブラリ自体を変更する
  • 7.x から 8.x に移行する利用者の質問に答える

作業手順

1. タスクを分類する

ユーザーが次のどちらを必要としているか判断してください。

  • 利用者向けのガイダンス：ライブラリの統合または構成に関するもの
  • ライブラリのメンテナンス：indexer-core 自体の変更に関するもの

利用者向けのガイダンスでは、内部の説明に入る前に、適切なモードの選択と統合方法の助言を優先してください。

ライブラリのメンテナンスでは、タスクで契約の変更が明示されていない限り、ドキュメントに記載された契約を維持してください。

2. 該当するリファレンスを読む

以下の表を使用し、現在のリクエストに必要なファイルだけを読み込んでください。

3. 実装前にリスクの高い選択肢を明確にする

次のいずれかが不明な場合は、作業に着手する前に確認してください。

  • ユーザーがブロック全体へのアクセスを必要としているのか、デコード済みイベントだけを必要としているのか
  • あるインデクサーがブロックの処理を終えてから、別のインデクサーが処理を開始する必要があるのか
  • 下流の利用者が生の ABI イベントと、より高レベルなビジネスイベントのどちらを求めているのか
  • タスクが動作変更、ドキュメント変更、デバッグのいずれなのか
4. indexer-core の正確性を保って実装する
  • 通常のインデクサーは IndexerFactory を通じてビルドしてください
  • リポジトリのドキュメントを、公開動作に関する信頼できる説明として扱ってください
  • タスクで変更が明示されていない限り、ロールバックとリオーグのセマンティクスを維持してください
  • 単一の実装詳細や型シグネチャから、公開契約を推測しないでください
5. 検証して納品する

以下の該当するすべての確認が完了するまで、タスクは完了ではありません。

  1. 対象を絞った検証：変更した動作を検証します
  2. より広範なテスト：変更が複数の領域にまたがる場合は ./gradlew test を実行します
  3. フォーマット：Kotlin コードを変更した場合は ./gradlew spotlessCheck または ./gradlew spotlessApply を実行します
  4. ドキュメントの整合性：公開動作や例を変更した場合は、ドキュメントとの整合性を確認します

参考ファイル

ほかの作業を始める前に、該当するファイルを読んでください。

トピックファイルユーザーが次の内容に言及した場合に読む
ランタイムモデル、ライフサイクル、ロールバック、依存関係references/runtime-model.mdIndexerProcessor、IndexerRunner、ライフサイクル、ステータス、ロールバック、再編成、依存関係の順序
LogsIndexer と BlockIndexer の違い、およびファクトリーの選択肢references/mode-selection.mdLogsIndexer、BlockIndexer、includeFullBlock、dependsOn、高速同期、ブロック全体へのアクセス
ABI イベント、ビジネスイベント、VET の送金、フィルタリングreferences/event-pipeline.mdABI、ビジネスイベント、VET_TRANSFER、イベント条件、送金条件、クラスパス JSON
リポジトリの保守と移行references/maintenance-and-migration.mdテスト、フォーマット、ドキュメントの参照元、7.x と 8.x の移行、IndexingResult の名前変更
データモデリング、BigDecimal、DECIMAL128、金額フィールドreferences/data-modeling.mdBigDecimal、DECIMAL128、トークン量、ステーク、残高、金額フィールド、大きな数値

コメント

Markdown 対応