ソース取り込みスキルは何をしますか？

チャットチャンネル、イシューストリーム、フィード、メールボックスなど、後続の実行が以前の範囲と重複しうる有界なコレクションに使用します。共有規約、公開、マニフェストプロトコルを参照してください。取得後、ドキュメントと会話は knowledge-ingest にルーティングします。knowledge-ingest は knowledge-entities を使用してエンティティエンリッチメントを行います。会議は knowledge-meeting-ingest にルーティングします。このスキルはソースIDとカバレッジを所有します。取り込みワークフローは、保持されたコンテンツを有用な接続知識に変換します。定期的な取り込みジョブを作成するには、最初に knowledge-automation を使用します。

契約

コンテンツを読み取る前に、安定したプロバイダ/ソースキーを解決します。表示名はラベルであり、IDとしては機能しません。
source_role: canonical、provider、source_key を持つ正規の source ページを1つ維持します。実行ごとにそれを再利用します。
各有界な観測について、生成されたマニフェストを、source_role: snapshot、正確なカバレッジ、観測時刻、マニフェストハッシュ、カウント、完全性、ウォーターマーク、および正規ソースページへの依存関係を持つ source ページの添付ファイルとして保持します。
マニフェストは安定したアイテムIDとコンテンツハッシュを保持し、ソーステキストは保持しません。許可された場合、オリジナル/エクスポートされたコンテンツは証拠として別途保持します。
計画を立てる前に、同じプロバイダ/ソースキーの以前のスナップショットページをクエリします。それらのマニフェストをダウンロードし、添付ファイルのハッシュを検証し、重複するすべてのスナップショットをプランナーに渡します。会話メモリに依存しないでください。
変更されていないソースバイトと既存のレコードを再利用します。要求された場合、保持されたソースから以前に省略されたエンリッチメントを続行します。変更されていないマニフェストは、エンティティエンリッチメントが既に行われたことを意味しません。追加された項目を取り込みます。変更された項目を既存のページ/クレームと照合します。削除は観測されたソース状態として扱い、知識を消去する許可としては扱いません。証拠が正当化する場合にのみ、訂正または撤回します。
完全なスナップショットは、その正確なカバレッジ内での不在を確立できます。部分的または不明なスナップショットはそれができません。未解決の欠落IDは未解決のままです。

手順

knowledge_status と knowledge_ontology を検査して、対象のボールトスコープと source フィールドを確認し、次にプロバイダ/ソースキーによって正規ソースと以前のスナップショットを知識ベースで検索します。所有者プライベートな取り込みが、再起動後に会話スコープまたは空のボールトに誤って解決された場合は、書き込みを停止し、意図された許可されたスコープを復元します。間違ったスコープから以前のカバレッジが存在しないと推測しないでください。
承認されたリーダーを使用して有界なエクスポートを取得します。Discrawlの場合は、設定済みの読み取り専用アーカイブ、既知の場合は正確なチャンネルID、および [since,before) RFC3339範囲を指定して scripts/discrawl-normalize.mjs を実行します。正規化されたペイロードには、安定した作成者IDとアーカイブで観測された表示フィールドが含まれます。生のJSONLを保持し、人間によるレビューや行引用が必要な場合は、別の行安定な読み取り可能なトランスクリプトを作成します。
scripts/source-manifest.mjs snapshot を使用して決定論的なマニフェストを生成します。スナップショットページを公開する前に添付します。返されたSHA-256を記録します。
重複するすべての以前のマニフェストをダウンロードし、scripts/source-manifest.mjs plan を実行します。カバーされている/されていない間隔、および追加/変更/削除/未変更/未解決のリストを検査します。
3〜5個の実質的な項目または議論をテストし、次に knowledge-ingest（会議の場合は knowledge-meeting-ingest）を介して取り込みます。チャットの場合は、関連メッセージを返信コンテキストとグループ化します。knowledge-entities を使用して、貢献から関連する人、会社、プロジェクト、概念をエンリッチメントします。サポートされている開発内容を、チャンネルダイジェストだけでなく、状態、日付付きタイムライン、およびコンテキストバックリンクに反映します。ソース引用には安定した外部IDを使用し、保持されたスナップショットを依存関係として使用します。議論ごとに1つのコピーをアップロードするのではなく、そのオリジナルを再利用します。
派生レコードを公開または更新し、次にスナップショットページを公開します。スナップショットが complete となるのは、取得とマニフェスト作成が宣言された間隔をカバーした場合のみです。派生抽出は依然として部分的である可能性があり、そのように報告する必要があります。
正規ページ、スナップショットページ、添付ファイル、派生レコード、およびソース依存の接続を読み戻します。ハッシュと正確なカバレッジを検証します。

Discrawlの例

node scripts/discrawl-normalize.mjs --config /approved/discrawl.yaml \
  --channel 1234567890 --since 2026-09-21T00:00:00-07:00 \
  --before 2026-09-28T00:00:00-07:00 --output messages.jsonl
node scripts/source-manifest.mjs snapshot --provider discord \
  --source-key discord:GUILD_ID:1234567890 \
  --coverage-start 2026-09-21T00:00:00-07:00 \
  --coverage-end 2026-09-28T00:00:00-07:00 \
  --input messages.jsonl --output manifest.jsonl.gz --summary snapshot.json
node scripts/source-manifest.mjs plan --current manifest.jsonl.gz \
  --previous prior-1.jsonl.gz --previous prior-2.jsonl.gz --output plan.json

資格情報、アーカイブパス、または生のプライベートコンテンツを知識ベースページの散文に含めないでください。スケジューラ、コネクタデーモン、またはプラグイン所有の取り込みジョブは作成されません。このスキルとスクリプトは、許可されたエージェント実行ワークフローをサポートします。

ソース取り込みスキル