adding-resource について
ローカルファイル、ディレクトリ、URL、リモートリポジトリを OpenViking のコンテキストデータベースに取り込むスキルです。処理指示の追加やセマンティック処理の完了待ちに対応し、継続的に参照できる資料の構築に使えます。
主な機能
- 01ファイル、ディレクトリ、URL、リポジトリの取り込み
- 02理由や指示による処理のガイド
- 03タイムアウト付きの処理完了待ち
- 04取り込んだリソース URI の返却
活用シーン
- 01後で検索するプロジェクト文書の追加
- 02ウェブ記事の参考資料への取り込み
- 03エージェントのセッションをまたぐ情報の保存
インストール
コマンドをコピーしてターミナルで実行します。
$
npx skills add https:/ / github.com/ volcengine/ openviking --skill adding-resourceインストール後、Claude Code で/adding-resourceを入力して読み込まれたか確認します。
詳細
OpenViking (OV) add-resource
ov add-resource コマンドは、外部リソースを OpenViking のコンテキストデータベースにインポートします。ローカルファイル、ディレクトリ、URL、リモートリポジトリに対応しています。リソースはセマンティック分析によって自動的に処理され、viking://resources/ 名前空間の下に整理されます。
使用する場面
- プロジェクトのドキュメント、コードリポジトリ、参考資料をインポートするとき
- 後で検索できるように、ウェブページ、記事、オンラインリソースを追加するとき
- 外部ソースからナレッジベースを構築するとき
- エージェントが、セッションをまたいで保持すべき価値のあるコンテンツを見つけたとき
入力オプション
基本的な使い方
ローカルファイルまたは URL をインポートします。
# Import from URL
ov add-resource https://raw.githubusercontent.com/volcengine/OpenViking/main/README.md
# Import local file
ov add-resource ./docs/api-spec.md
# Import local directory
ov add-resource ./project-source
コンテキストと指示
処理をガイドするメタデータを追加します。
# Provide reason for import
ov add-resource ./api-docs.md --reason "REST API documentation for v2 endpoints"
# Add processing instructions
ov add-resource ./large-repo --instruction "Focus on authentication and authorization patterns"
# Combine reason and instruction
ov add-resource https://example.com/guide --reason "User guide" --instruction "Extract best practices and examples"
非同期処理の制御
セマンティック処理が完了するまで待機します。
# Wait until processing finishes
ov add-resource ./docs --wait
# Wait with timeout (in seconds)
ov add-resource https://example.com/docs --wait --timeout 60
# Fire and forget (default)
ov add-resource ./docs
出力
インポートしたリソースのルート URI を返します。
root_uri viking://resources/...
前提条件
- CLI が設定済みであること:
~/.openviking/ovcli.conf - URL のインポートにはネットワークアクセスが必要です
- ローカルファイル/ディレクトリへの読み取り権限が必要です
コメント
Markdown 対応