1仕組みと動作原理
実装原理 = 純粋なプロンプトオーケストレーション + ホストのバックグラウンドエージェント機能(スキル内コードゼロ):メインエージェントに調査をバックグラウンドエージェントへ委任するよう指示し(非同期でメインエージェントをブロックしない)、ホストが提供するサブエージェント/ツールが実際の読解とファイル書き込みを実行します。
skills/engineering/research/SKILL.md
Spin up a **background agent** to do the research, so you keep working while it reads.
スキル全体はこの指示テキストのみで構成されています。スクリプト、フック、特定のホストAPIの呼び出しは一切含まれていません。「background agent」はホスト(Claude Code/Codexなど)が既に備えている委任機能であり、スキルはその利用方法を規定しているだけです。
情報源の品質規律が中核メカニズム:二次的な伝聞ではなく一次情報源(公式ドキュメント/ソースコード/仕様書/ファーストパーティAPI)を強制し、各主張(claim)をその発信元へ遡ることで、トレーサビリティのルールによってハルシネーションや二次情報の歪みに対処します。
skills/engineering/research/SKILL.md
Investigate the question against **primary sources** (official docs, source code, specs, first-party APIs), not a secondary write-up of them. Follow every claim back to the source that owns it.
ここでのメカニズムは自動検証ではなく制約(バイアス)です。引用の真偽を検証するのではなく、エージェントに対してすべての論断を一次情報源まで遡るよう要求します。
成果物の形式は「リポジトリ内の単一Markdownファイル + 主張ごとの出典明記」に固定されており、調査結果を対話の要約ではなく、バージョン管理・再検証が可能なリポジトリ資産として記録します。
skills/engineering/research/SKILL.md
Write the findings to a single Markdown file, citing each claim's source.
単一ファイルかつ引用付きであることが成果物の規約です。固定の構造テンプレートはなく、フォーマットは自由です。
保存先戦略:リポジトリ既存のノート命名・配置ルールを優先して踏襲し、規約がない場合はエージェントが適切な場所を自選した上でユーザーに保存先を明示します。
skills/engineering/research/SKILL.md
Save it where the repo already keeps such notes; match the existing convention, and if there is none, put it somewhere sensible and say where.
「規約の発見と配置の決定」をユーザーに対話形式で尋ねるのではなく、エージェント自身の判断に委ねています。
2コア機能
01バックグラウンドでの非同期調査の委任(メインエージェントをブロックせず、作業を継続可能)
02一次情報源の優先と主張のトレーサビリティ(公式ドキュメント/ソースコード/仕様/ファーストパーティAPIを重視し、二次情報の伝聞を排除)
03調査結果を単一のMarkdownファイルに集約し、各主張に出典を付与
04リポジトリのノート規約に沿ってファイルを保存し、保存場所を報告(規約がない場合は適切な場所を自選して説明)
05トリガー条件の定義:テーマ調査、ドキュメント/APIの事実収集、読解作業のバックグラウンドエージェントへの外注
06ホストツールUI向けの自己記述(Codex/OpenAI系のdisplay_name + short_description)
4推奨統制措置と判定根拠
安全運用のための推奨統制措置
Agent 向け
作業ディレクトリを限定
管理者向け
操作ログを保持
判定根拠(ファイルパスと抜粋)
- 本地工作目录: ファイルの読み書きおよび成果物の出力: リポジトリ内の単一Markdown調査ノートファイル(ホストエージェントにより書き込みが実行されます。デフォルトではリポジトリ既存のノート規約に従い、規約がない場合はエージェントが適切な場所を自選してユーザーに通知します)。
監査ノート: ディレクトリ全体でテキストファイルが2つのみ存在し(SKILL.md 794B + agents/openai.yaml 94B、git ls-filesおよびfindにてスクリプト、隠しファイル、シンボリックリンクがないことを確認済み)、一語一句の精査でもネットワークエンドポイント、認証情報の読み取り、埋め込み実行可能コンテンツは検出されませんでした。唯一の「アクション」は、指示に従ってモデルがユーザーのリポジトリにMarkdownノートファイルを1つ書き込むことだけです(成果物そのものであり、ホストの権限管理下で実行)。純粋なプロンプトオーケストレーションであり、同一バッチ・同一リポジトリの類似スキル(grill-with-docs: 純粋な指示 + プロジェクト内ドキュメント作成、同様にgreen評価)と分類基準が一致しています。
5二重目の独立検証
- [ok] 目录内容仅 SKILL.md + agents/openai.yaml 两个文件(无脚本/附属代码) — git ls-files skills/engineering/research 仅列出两文件;find -type l 为 0;ls -la 无隐藏条目——与第一遍一致
- [ok] 实现依赖'宿主后台 agent 能力'而非内置机制 — git show 复核 SKILL.md 全文仅 794B 指令文本,无任何对具体宿主 API/工具名的调用代码,'background agent' 确为宿主既有能力
- [ok] 一手信源优先 + claim 回溯规则存在且为 skill 核心 — 复核到 SKILL.md 正文步骤 1 原文:'Investigate the question against **primary sources** … Follow every claim back to the source that owns it.'
- [ok] 引用纪律(逐 claim 标注来源) — 复核到步骤 2:'Write the findings to a single Markdown file, citing each claim's source.'
- [ok] 仓库约定落盘 + 无约定自选并告知 — 复核到步骤 3 原文 'Save it where the repo already keeps such notes; match the existing convention…'
- [ok] agents/openai.yaml 仅界面元数据、无行为 — git show 复核 94B,仅 interface.display_name/short_description 两字段
- [ok] external_deps 为空(无 CLI/API/网络端点/第三方包) — 两文件全文逐词复查:无 URL、无域名、无命令行、无包名、无环境变量引用;'official docs, source code, specs, first-party APIs' 只是信源类型描述,非调用点
- [ok] 安全分级 green(无脚本/无网络外发/无凭证/无隐藏内容) — 找反例未果:无 .sh/.py/可执行位文件、无 fetch/curl 字样、无 key/token/env 字样;唯一写入为交付用的仓库 Markdown(宿主动作)。与同批纯指令型 skill 分级口径一致
6結論
最適な用途: ドキュメントの精読、API仕様の確認、調査タスクを委任し、再検証可能なリポジトリノートとして記録したいシナリオ。すでにnotes/docsなどの規約ディレクトリが存在し、メインエージェントが並行して別の作業を進める必要がある場合に特に適しています。
不向きな用途: 固定フォーマット、構造化レポート、厳格な文字数制限が求められるシナリオ(本スキルにはレイアウト規約がありません)。リアルタイムかつ対話型で深掘りを行う調査(バックグラウンドエージェントの処理プロセスが不可視のため)。敵対的・機微な情報が含まれ、引用の真偽を人間が検証できないシナリオ。
Install Agent-Ready
① Verified Mirror 2026-09-06
Option A · Direct DownloadDownload research.tar.gz
sha256:
Option B · Copy Guide for Agentb3019d041dd6a97f…Agent はこの JSON ガイドから自動的にダウンロードして検証します。
② Upstream GitHub
GitHub Repo ↗
Pinned to commit 3cca18b368.