research-topic-extractor

Research Topic Extractor

• ファイル、画像、ウェブページ、フォルダー、または自然言語の説明から、構造化されたレビューのテーマを抽出します。
• research-literature-review またはその他の文献レビューのワークフローに直接利用できる出力を生成します。
• 旧名 get-review-theme によるプロンプトの呼び出しに対応します。システムレベルの旧ディレクトリはインストーラーが削除します。
• 最優先事項：テーマは実行可能であること、キーワードは検索可能であること、核心となる問いは具体的であること。

入力

必須：

• {输入源}：ファイルパス、URL、フォルダーパス、画像パス、またはテキストによる直接の説明

任意：

• {输出格式}：text / yaml / json。デフォルトは text

フロー

入力

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

実行手順

• ユーザー環境で、この Skill の設計上の欠陥に起因するバグが発生した場合は、まず bensz-collect-bugs を使用し、規定に従って ~/.bensz-skills/bugs/ に記録します。ユーザーのローカル環境にインストール済みの Claude Code / Codex の Skill ソースコードを直接変更することは厳禁です。
• AI がワークアラウンドによってユーザーのタスクを続行できる場合は、まずバグを記録してから、現在のタスクを続行します。
• ユーザーが「report bensz skills bugs」など、公開報告を明確に求めた場合は、ローカルの gh と bensz-collect-bugs を呼び出し、新たに追加されたバグのみを huangwb8/bensz-bugs にアップロードします。バグリポジトリ全体を pull / clone しないでください。

入力タイプの識別

• 自然言語の説明
• 画像
• URL
• テキストファイル
• PDF
• Word
• フォルダー

内容の抽出

• 自然言語：そのまま使用します
• 画像：LLM のネイティブな視覚機能を利用します
• URL：ウェブページ読み取りツールを優先し、失敗した場合は本文の提供をユーザーに依頼します
• テキスト / PDF / Word：そのまま読み取ります
• フォルダー：再帰的にスキャンし、.md/.txt/.pdf などの主要な資料を統合します

原則：

• ホストのネイティブ機能と既存の標準ツールを優先します
• ツールが利用できない場合は、追加のスクリプト依存を導入せず、適切に機能を縮退させます

意味の抽出

以下の項目を出力します。

• テーマを一文で要約する
• 英語の標準用語を 5～10 個抽出する
• 具体的な研究上の問いまたは課題を 2～5 個抽出する

書式設定

• text：下流の Skill にそのままコピーするのに適しています

• yaml / json：構造化された連携に適しています

• topic は research-literature-review に直接渡せます

• keywords は検索戦略の補足に使用できます

• core_questions はレビューの範囲設定と採否の参考にできます

出力

常に以下の 3 項目を含めます。

• テーマ
• キーワード
• 核心となる問い

形式はユーザーが選択します。

• text
• yaml
• json

出力管理

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

検証

• テーマには研究対象と、核心となる問いまたは方法を含めます
• キーワードには標準的な検索用語を優先します
• 核心となる問いは具体的にし、「重要な意義がある」「課題が多い」といった内容のない表現は避けます

失敗と復旧

• ファイルが存在しない：パスを変更するか、内容を直接貼り付けるようユーザーに案内します
• 対応していない形式：変換するよう案内します
• 内容の抽出に失敗：テキストを手動で提供するようユーザーに依頼します
• URL の解析に失敗：ウェブページ本文をコピーするか、PDF を提供するようユーザーに依頼します
• 画像の意味が不明瞭：補足説明を一文追加するようユーザーに依頼します

制約

以下の共通制約を遵守し、この Skill 固有の範囲も守ります。

共通の厳守事項

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

Skill 固有の制約

この Skill の description と上記のフローで明示された範囲を超えてはなりません。検証されていない情報を、確定した結論であるかのように示してはなりません。