ov-add-paper

ov-add-paper

目標

研究論文を OpenViking 対応の構造化リソースに変換し、ov add-resource で取り込みを完了します。生成された成果物ディレクトリを検証し、OpenViking に登録するまで、作業は完了していません。

入力

• 必須：論文のソース。通常はローカルの PDF パスまたは論文の URL です。
• 任意：出力ディレクトリ、OpenViking のターゲット URI、ドメインに関するメモ、関連するリポジトリ／ソースファイル、OV の処理完了を待つかどうか。
• 論文ソースがない、またはアクセスできない場合は、作業を始める前に提示を求めてください。

ワークフロー

1. 付録と番号付きの図表をすべて含め、論文を最後まで読みます。
2. references/ara-compiler-profile.md を使用して、ARA 形式の成果物ディレクトリを作成します。
3. scripts/validate_ara.py で成果物を検証します。
4. ユーザーが明示的に承諾しない限り、検証エラーを修正します。
5. 検証済みの成果物ディレクトリを ov add-resource で直接取り込みます。
6. ov stat／ov tree でターゲットを確認し、成果物のパス、OV のターゲット／ルート URI、検証結果、取り込み結果、未解決の問題を返します。

出力要件

生成する成果物には、以下を含める必要があります。

• PAPER.md
• logic/problem.md、logic/claims.md、logic/concepts.md、logic/experiments.md、logic/related_work.md
• logic/solution/constraints.md
• src/environment.md
• trace/exploration_tree.yaml
• evidence/README.md
• 記録対象となる番号付きの図表ごとの Markdown と PNG のエビデンスファイル

最終回答には、ov add-resource コマンドの実行結果、または --wait の不具合後もターゲットが作成されたことを示す復旧確認の結果、あるいは取り込みを妨げた正確な原因を含める必要があります。

検証

このスキルのディレクトリから実行するか、バリデーターの絶対パスを指定してください。

python3 scripts/validate_ara.py <artifact-dir>

次に、OV CLI で取り込みます。

ov add-resource <artifact-dir> --to viking://resources/papers/<slug> --wait

取り込みの前に、ov -o json stat <target-uri> を使用してターゲットがすでに存在するか確認します。取り込み後は、ov -o json stat <target-uri> と ov tree <target-uri> で検証してください。

権限

• ユーザーが論文の追加または取り込みを依頼した場合、新しい OpenViking リソースの書き込みが許可されます。
• 既存のリソースを上書きまたは置き換える可能性のあるターゲット URI を意図的に再利用する場合は、事前に確認してください。
• --skip-validation は、ユーザーが列挙された検証エラーを明示的に承諾した場合に限り使用できます。

境界

• ov add-skill は使用しないでください。このスキルが作成するのは論文リソースであり、OV スキルではありません。
• ov add-resource を黙って省略しないでください。取り込みに失敗した場合は、コマンド、エラー、復旧方法を報告してください。
• ターゲットの作成後に ov add-resource --wait が接続エラーで終了した場合、同じ URI でただちに再試行しないでください。ov stat、ov wait、ov observer queue、ov tree を実行し、取り込みが完了したか確認してください。
• 主張、エビデンス、ソース参照、コード、数値、研究の経緯を捏造しないでください。
• ユーザーがそのターゲットを指定していない限り、明示的に指定された既存の OV ターゲットを上書きしないでください。
• 根拠のない内容や読み取れない内容は、補完せずに利用不可として記載してください。

実行時リソース

• 成果物の作成前に references/ara-compiler-profile.md を読み込んでください。
• OV の取り込みを実行する前、または取り込み失敗のデバッグ前に references/openviking-ingest.md を読み込んでください。
• 決定論的なチェックには scripts/validate_ara.py を使用してください。