Research Artifacts(研究アーティファクト)
研究は、意思決定の根拠となる外部エビデンス(技術評価、ライブラリ比較、業界慣行調査)を記録します。研究は日付付き、出典付き、追記専用であり、時点で証拠が示していた内容のスナップショットであり、生きた意見ではありません。
このスキルは、研究をどのように整理、フォーマット、インデックス化するかを定義します。deep-research スキルはどのように収集・相互検証するかを定義し、living-docs はそれが供給する決定や課題を管理します。これら3つは連携します。研究アーティファクトはOKF コンセプトです。ここで適用されるフロントマター/予約ファイルルールについては、okf-knowledge-format スキルを参照してください。
このスキルの使用(段階的な開示)
この SKILL.md はスリムなスタブです。トリガーとタスク→トピックルーターです。living-docs CLI が完全な研究ルール、出典規律、構造、トレーサブルチェーンを保持し、段階的に開示します。何かを作成する前に、タスクに対応するトピックをロードしてください:
living-docs guide --list— すべてのトピックを表示。living-docs guide <topic> --skill research-artifacts— そのトピックをロード。
パイプ出力はデフォルトで minified JSON です。人間向けテキストの場合は --plain、JSON を強制する場合は --json を使用します。トピック: rules, structure, research-report, research-index, research-general-references, about。
このスタブは純粋なルーター(ADR 0017)です。トリガーとトピックの指示を提供し、インラインでルールは保持しません。出典規律および研究→決定→課題チェーンはトピックであり、作成前に guide rules --skill research-artifacts / guide structure --skill research-artifacts でロードされます。
呼び出すタイミング
- 研究セッションの出力を
docs/research/に記録する場合 —living-docs guide research-report --skill research-artifacts。 - 研究ノート(
docs/research/NNNN-<slug>.md+ インデックス一覧 + 一般ロールアップ)を構造化またはインデックス化する場合 — テンプレートにはliving-docs guide research-index --skill research-artifacts/guide research-general-references --skill research-artifacts、レイアウトルールにはguide structure --skill research-artifacts。 - ドラフトに出典規律を適用する場合(一次情報源、ベンダーCOIフラグ、推論と事実のラベル、信頼度、取得失敗メモ) —
living-docs guide rules --skill research-artifacts。 - 研究→決定→課題のトレーサブルチェーンを配線する場合(受け入れられた推奨事項はADRに到達し、その後
living-docs内の課題に到達する必要があります) —living-docs guide structure --skill research-artifacts。