research-citation-check

Research Citation Check

• 既存の {テーマ}_review.tex にある本文中の引用が、対応する論文の内容と本当に一致しているかを確認します。
• 致命的な誤りがあると確認できた場合に限り、「該当する引用を含む文」を最小限書き換えます。
• PDF／Word のレンダリングでは research-literature-review を優先的に使用します。構造化入力の準備にはこのスキルは必要ありません。
• 旧名 check-review-alignment のプロンプトによる起動にも対応します。.check-review-alignment/ は、過去から使われている安定したワークスペース名です。

入力

• work_dir：*_review.tex と .bib を含むディレクトリ
• 任意の --tex：tex ファイル名を指定します

基本原則

• 変更のための変更はしません
• 確認できない場合は変更しません
• 必要な文だけを変更します
• すべての LaTeX コマンドの構造を保持します

手順

入力

ユーザーの依頼と設定ファイルに基づいて、必要な入力を用意します。不足している情報を明示し、その入力に依存する手順は停止します。

実行手順

• ユーザー環境で、このスキルの設計上の欠陥に起因するバグが発生した場合は、まず bensz-collect-bugs を使用して、定められた手順に従い ~/.bensz-skills/bugs/ に記録します。ユーザーのローカル環境にある Claude Code／Codex にインストール済みのスキルのソースコードを直接変更してはいけません。
• AI が回避策を使ってユーザーのタスクを続行できる場合は、まずバグを記録してから現在のタスクを完了します。
• ユーザーが「report bensz skills bugs」などの公開報告を明示的に求めた場合は、ローカルの gh と bensz-collect-bugs を使用し、新規のバグのみを huangwb8/bensz-bugs にアップロードします。バグリポジトリ全体を pull／clone してはいけません。

依存関係の確認

• research-literature-review の必須確認はレンダリングを実行する場合に限ります。移行期間中は systematic-literature-review にフォールバックできます。
• --prepare のみを実行する場合、レンダリング依存関係が利用可能である必要はありません。

事前確認とファイルの特定

• *_review.tex と対応する .bib を探します
• 必須ファイルが1つでも欠けている場合は、ただちに停止します

構造化コンテキストの抽出

cd /path/to/research-citation-check
python3 scripts/run_ai_alignment.py --work-dir "/path/to/work_dir" --prepare

• ai_alignment_input.json を生成します
• 入力には少なくとも、文、bibkey、文献のメタデータ、DOI／URL、PDF の要約段落または BibTeX の要約を含めます

AI による意味の確認

• 証拠の優先順位：PDF の要約段落 > BibTeX の abstract/title > 文のみからの推論
• 各引用を次のいずれかに分類します。
  • fake_citation
  • wrong_citation
  • contradictory_citation
  • weak_support
  • overclaim
  • style_issue
• 確認できない場合は原文を維持し、Warnings に記録します

レポート

• レポートには少なくとも次の項目を含めます。
  • Summary
  • 具体的な詳細
  • Critical Fixes (P0)
  • Warnings (P1)
  • Rendering Result
• 各引用の詳細には少なくとも、タイトル、DOI、原文の文、文献の実際の内容、妥当性の評価、問題のレベルを含めます

レンダリング

cd /path/to/research-citation-check
python3 scripts/run_ai_alignment.py --work-dir "/path/to/work_dir" --render

出力

• {work_dir}/.check-review-alignment/ai_alignment_report.md
• {work_dir}/.check-review-alignment/ai_alignment_input.json
• 変更後の {テーマ}_review.tex
• 新たに生成された {テーマ}_review.pdf
• 新たに生成された {テーマ}_review.docx

出力の管理

このスキルの新しいタスクで生成される中間ファイルは、すべて ./.bensz-api/task-{yyyymmdd-hhmm}-{簡短描述}/{skill名}/input|output|log/ に書き込みます。同じタスクでは1つのタスクルートディレクトリを再利用します。複数のスキルが連携する場合に限り、shared/ を作成します。正式な成果物はこのディレクトリに書き込みません。過去の隠しディレクトリは、明示的に互換読み込み、移行、またはクリーンアップを行う場合に限り使用できます。

検証

• 設定は config.yaml を参照してください
• スクリプトのエントリーポイント：scripts/run_ai_alignment.py
• レンダリング依存関係：research-literature-review（フォールバック：systematic-literature-review）

失敗と復旧

エラーの証拠と完了済みの成果物を保持します。入力、環境、または外部依存関係が復旧した後に限り、直近で失敗した手順から再試行します。

制約

• P0：必ず修正します。最小限の書き換え、または誤った bibkey の修正が許可されます
• P1：警告のみとし、書き換えません
• P2：完全にスキップします
• 禁止事項：
  • 引用を含まない文の書き換え
  • 段落全体の書き直し
  • 新しい bibkey の追加（誤った key の修正を除く）
  • 論文の内容の捏造

共通の必須制約

• タスクでファイルへの書き込みが必要な場合は、一意の ./.bensz-api/task-{yyyymmdd-hhmm}-{簡短描述}/ ルートディレクトリを使用します。共有資料は shared/ に、スキル固有の資料はそのスキルの input/、output/、log/ に保存します。
• 正式な成果物、ソースコード、正式な計画はプロジェクトの規約に従って保存し、タスクワークスペースには書き込みません。許可なく上書き、削除、移行、またはリモートへの書き込みを行ってはいけません。
• プロジェクトの保守変更では BAC の利用可否を確認し、要件、AI の出力、ツールの結果、ファイルの変更、検証の概要を記録します。BAC はプロセス監査のみを目的とし、著者の明記、責任、コンプライアンスの判断に代わるものではありません。
• API Key、アクセス トークン、パスワード、Cookie、環境ファイル／認証情報ファイル、非公開の Prompt、個人情報、ローカルのユーザー名、ホスト名、または不要な大容量の生データを記録してはいけません。
• ファイルパスを正規化し、許可されたプロジェクトの範囲内に制限します。外部 URL、子プロセス、ネットワークアクセスには最小権限の原則を適用し、パストラバーサル、SSRF、コマンドインジェクションを防止します。
• スキルのバージョンは、自身の config.yaml:skill_info.version にのみ記録します。公開 API、プロトコル、ディレクトリ、設定を変更した場合は、ドキュメントと CHANGELOG.md も更新します。
• bensz-collect-bugs に報告するのは、スキル自体または Bensz インフラストラクチャ自体の設計上の欠陥に限ります。機密情報を除去してから ~/.bensz-skills/bugs/ に書き込み、現在のタスクを中断しません。公開報告を行うのはユーザーが明示的に求めた場合に限ります。ユーザーのインストール済みスキルのソースコードを直接変更してはいけません。

スキル固有の制約

このスキルの description と上記の手順で定められた範囲を超えてはいけません。未検証の情報を確定した結論であるかのように扱ってはいけません。