maintain-integration

maintain-integration

maintain-integration と create-integration の使い分け

パッケージがすでに存在する場合は、このスキルを使用します。

• 既存のパッケージの品質、ECS 準拠状況、正確性を確認する
• パイプラインエラー、フィールドマッピング、ECS 分類、CEL プログラム、マニフェストなど、特定の問題を修正する
• 品質改善を一通り実施する（レビュー → 修正 → 再検証のループ）
• 既存のデータストリームに小規模な変更を加える

次の場合は、代わりに create-integration を使用します。

• 新しいインテグレーションパッケージを一から作成する
• 既存のパッケージに新しいデータストリームを追加する（create-integration → references/add-datastream-workflow.md）

モード

レビューのみ（読み取り専用、編集なし）

→ 開始前に references/review-workflow.md を最後まで読んでください。

自動検証を実行し、サブエージェントに検査を委任します（references/review-workflow.md のディスパッチ規則を参照）。サブエージェントには、作業手順書として review-integration/references/reviewer-subagent-guidance.md を指定します。ファイルを変更せずに、調査結果を提示します。

全面的な改善（分析 → 修正 → 再検証）

→ 開始前に references/improve-workflow.md を最後まで読んでください。

（以前のレビューまたは新たなレビュアーの実行から）問題を分析し、深刻度に基づいて優先順位を付け、直接修正するかサブエージェントに委任し、再検証して報告します。

小規模な直接修正（サブエージェント不要）

小規模で対象が限定された変更は、ワークフロー全体を読み込まず、その場で対応できます。

• マニフェストフィールドの修正（title、description、format_version、conditions、owner）
• changelog エントリーとバージョンの更新 — package-spec スキルを参照
• _dev/build/docs/README.md のドキュメント内プレースホルダーテキスト
• _dev/build/build.yml の作成または ECS リファレンスの更新
• 簡単なフィールドファイルの修正（誤字、エントリーの欠落、重複の削除）
• CEL の書式設定のみ — ストリームの agent/stream/ ディレクトリで celfmt -s -agent -i cel.yml.hbs -o cel.yml.hbs を実行

直接編集を行った後は、回帰がないことを確認するため elastic-package lint と elastic-package check を実行します。

直接作業で読み込むスキル

• elastic-package-cli — 検証コマンドとテストコマンド
• package-spec — マニフェストのルール、バージョンの更新、changelog のスキーマ

ドメイン固有のスキル（パイプライン、CEL、ECS、フィールドマッピング）を自分のコンテキストに読み込まないでください。 それらの知識をすでに備えたサブエージェントに委任してください。

サブエージェント

専門的な作業はすべて、プラットフォームの汎用サブエージェント（Cursor：generalPurpose Task agent、Claude Code：general-purpose Task agent、または他のプラットフォームの同等のエージェント）に委任します。各タスクのプロンプトでは、該当する *-subagent-guidance.md ファイルのパスをサブエージェントに示し、ほかの作業に着手する前にそのファイル（および「First steps」に記載されたスキルの SKILL.md）を最初から最後まで読むよう指示してください。自分ではガイダンスファイルを読まず、その内容をタスクのプロンプトに貼り付けないでください — コンテキストコストが二重にかかります。パスとタスク固有のコンテキストのみを渡してください。詳細なディスパッチ規則とワークフローごとの説明は、references/review-workflow.md と references/improve-workflow.md に記載されています。

サブエージェントのガイダンスファイル	用途
review-integration/references/reviewer-subagent-guidance.md	読み取り専用での徹底的な品質検査：ファイルをドメインごとに分類し、review-integration スキルを通じて関連するすべてのドメインスキルとチェックリストを読み込み、深刻度順に並べたドメインタグ付きの調査結果を返します
ingest-pipelines/references/builder-subagent-guidance.md	パイプラインの修正：JSE00001、エラー処理、プロセッサータグ、ECS 分類、フィールド定義、テストフィクスチャ
cel-programs/references/builder-subagent-guidance.md	CEL の修正：プログラムロジック、カーソル管理、エラー処理、mito 検証、モック API、cel.yml.hbs テンプレート、マニフェスト変数の整理

委任する際は、サブエージェントに次の情報を渡してください：パッケージのパス、データストリームのパス、修正する具体的な問題（調査結果を貼り付ける）、該当する場合はサンプルデータ、制約事項。

データの匿名化

コミットするデータはすべて完全に匿名化する必要があります。コミットするファイルに、実際の IP アドレス、ホスト名、メールアドレス、トークン、組織識別子を含めないでください。テスト用フィクスチャー、モックレスポンス、サンプルイベント、ドキュメントの例を修正または追加する際は、値がすべて合成データであることを確認してください。改善作業中に実データが見つかった場合は、匿名化してください。

参考資料

• references/review-workflow.md — 読み取り専用のレビュー手順（フェーズ 1～4、必須チェックリスト、出力形式）
• references/improve-workflow.md — 改善手順の全体（分析 → 優先順位付け → 修正 → 再検証 → 報告）