| name | oss-research-session |
| description | oss-researcher サブエージェントの起動・成果保存を標準化する。保存先パス規約、ツール別起動指針、 注入プロンプト、親エージェントの検証チェックを含む。遵守はモデル依存であり100%ではない。
|
OSS 調査セッション — oss-researcher 運用スキル
調査の中身（Phase 1–4 の手順・出力セクション構造）は agents/oss-researcher.md を正とする。本スキルは オーケストレーション（誰に何を渡し、どこに保存するか）のみを定義する。
いつ使うか
- OSS / ライブラリについて
oss-researcher で調査し、結果をリポジトリ内の Markdown 1 本に残すとき
- Cursor / Claude Code のいずれかでサブエージェントや同等の委譲を使うとき
限界（前提）
- サブが指定パスへ
Write できること、プロンプト遵守は ベストエフォート（IDE のモード・権限・モデル挙動に依存）
- ファイル書き込みができない場合は、ユーザーが本スキルの
OUTPUT_FILE に手動で貼り付ける
保存先の正（デフォルト）
| 項目 | 規約 |
|---|
| リポジトリルート | 調査対象ワークスペースの $REPO（通常は git ルート） |
| ディレクトリ | $REPO/docs/research/oss-sessions/ |
| ファイル名 | YYYY-MM-DD_<slug>.md（<slug> はトピックやリポジトリ名から kebab-case、英小文字・数字・ハイフン推奨） |
| 同日・同一 slug の衝突 | ファイル名末尾に _2、_3 … を付与（時刻サフィックスでも可だが、本スキルでは _2 連番に統一） |
作業前にディレクトリが無ければ、親エージェントまたはサブが作成する（mkdir -p 相当）。
成果ファイルのフロントマター（推奨）
調査本文の先頭に YAML フロントマターを付ける。記法は markdown-conventions スキルに合わせる（箇条書きは -、コードフェンスは言語指定）。
---
researched_at: "YYYY-MM-DD"
topic: "<調査トピック一行>"
primary_url: "<メインリポジトリまたは公式URL>"
agent: oss-researcher
skill: oss-research-session
---
サブエージェント起動（ツール別・ベストエフォート）
原則（subagent-strategy ルール）: 委譲前に oss-researcher に相当するカスタムエージェントがないか確認する。
- Cursor: カスタムエージェント一覧で
oss-researcher を優先して起動する（/エージェント名 や Subagent / Task 等、IDE の提供する方法。UI 名はバージョンで変わりうる）
- Claude Code: サブエージェント / カスタムエージェントで同様に
oss-researcher を選ぶ
- 配置の参照: プロジェクトは
~/.cursor/agents/ / ~/.claude/agents/ 等（sync 済みなら本リポジトリの canonical/agents/oss-researcher.md が源）
フォールバック: ネイティブ起動が使えない場合は canonical/agents/oss-researcher.md を Read し、その全文（必要ならユーザーの調査指示を追記）をサブへ prompt 注入する。
サブへ渡す統合プロンプト（テンプレ）
以下をコピーし、プレースホルダだけ置換してからサブに渡す。
## コンテキスト（oss-research-session）
- 調査対象: <URL または org/repo>
- 成果物（必須）: 調査の **全文** を次の **1 ファイル にのみ** 書き込むこと:
- 絶対パス: <OUTPUT_FILE 例: /path/to/repo/docs/research/oss-sessions/2026-04-01-my-lib.md>
- 本文構造・調査手順: リポジトリの `canonical/agents/oss-researcher.md`（Phase 4 のテンプレ）に従うこと
- チャット返信: **短い要約** と **書き込んだファイルパス** のみ。長文の複製は不要
（任意の追加観点があればここに書く）
保存契約（サブ向け）
- 調査の完成形は 指定された
OUTPUT_FILE のみ とする
- ツールでファイルに書けない環境のときは、その旨をチャットで明示し、ユーザーが手動で
OUTPUT_FILE に保存できるよう全文を一度だけ 出す
- 各非自明な主張に
evidence-verification-rule の検証ステータス（verified / unverified-summary / speculation）を付す。根拠（file:line / URL）は verified / unverified-summary に必須、speculation は根拠なし（必要なら理由）。一次ソース実体を確認していない主張を verified としない
親エージェントのチェックリスト
$REPO/docs/research/oss-sessions/ を決め、OUTPUT_FILE のフルパスをテンプレに埋める（衝突時は _2 等）- 上記 統合プロンプト で
oss-researcher（または注入した同等サブ）を起動する
- 成果の spot-check（
evidence-verification-rule §3）— 体裁確認だけで終わらせない:
Read でフロントマター・構造が期待どおりかを確認した上で、主張のうち重要・高不確実なものを優先して数件、ソース実体（file:line / URL）に直接当てて裏取りする- 配分はリスク比例（固定件数ではない。重要主張は必ず、未確認を優先）。最終確認はソース実体に当て、LLM の自己申告・要約だけで
verified としない
- 根拠リンクが欠けた主張・ソースと矛盾する記述を見つけたら、サブに差し戻すかユーザーに
unverified-summary として明示する
- ユーザーに ファイルパス を返す
関連リソース
| リソース | パス |
|---|
| 調査エージェント定義 | canonical/agents/oss-researcher.md |
| カタログ | canonical/CATALOG.md |
| サブエージェント方針 | canonical/rules/subagent-strategy-rule.md |
| 検証ディシプリン | canonical/rules/evidence-verification-rule.md |
