yao-expert-skill

Yao Expert Skill

分野、業界、テクノロジー、職種、製品の方向性、または漠然としたアイデアを、専門知識を学ぶためのパッケージにまとめます。構成されたレポート、チュートリアルの学習パス、キーワード体系、ファインマン・テスト、そして完成度の高い4種類の出力形式を作成します。

担当する作業

• ユーザーのトピックを、分野、地域、目的、対象者、期間、出力の詳細度、除外事項に整理します。
• まず構造から分野の専門知識を構築します。境界、分類、バリューチェーン、関係者、需要、供給、競争、ライフサイクル、政策、テクノロジー、資本、リスク、変化をもたらす変数を扱います。
• 権威ある情報源を優先して調査し、fact、inference、hypothesis、unknownを区別します。
• 50-100件のキーワード学習カードを作成します。各キーワードには、平易な一文での説明、概念の解説、根底にある論理、実例、実践的な活用法、役割と効果、関連する人物・企業・機関（該当する場合）、よくある誤解、根拠を含めます。
• 難しい概念とその根底にある論理を、簡単な比喩と実際の分野の事例を使って説明し、初心者が用語を暗記するだけでなく、その分野の仕組みを理解できるようにします。
• すべてのレポートの冒頭に、学習資料の紹介、要点、読み進め方、構成上の論理を示す、読者向けの导读摘要を設けます。
• 各主要モジュールは、表の前に自然な導入段落とつなぎの文章を加えて作成し、レポートが用語集やマトリックスを羅列したものではなく、一貫性のある学習資料として読めるようにします。
• 模範解答と採点基準を添えたファインマン質問を10問作成します。
• 表、罫線、はみ出し、アンカー、固定式の左側ナビゲーション、ローカルパスの漏えいを確認したうえで、Markdown、Word、PDF、HTMLの成果物を作成します。

入力

次のうち、1つ以上が渡されることを想定します。

• 分野、業界、テクノロジー、市場、職種、企業の方向性、または漠然としたアイデア
• 地域、言語、対象者、ユースケース、期間、希望する詳細度
• 既存のメモ、リンク、論文、レポート、スクリーンショット、または情報源に関する制約
• 希望する出力形式、命名、スタイル、期限、プライバシーに関する制約

ユーザーからトピックだけが提示された場合も、対応を止めないでください。references/domain-expert-method.mdに記載された既定値を使用し、前提を明示したうえで、入力不足がパッケージの内容に重大な影響を及ぼす場合を除き、作業を続けてください。

このスキルの対象外

• 単発の事実確認や簡単な説明
• 専門知識を学ぶためのパッケージを作成しない一般的なウェブ調査
• 純粋なビジネスモデルの検討。代わりにビジネスモデル用のスキルを使用してください。
• 業界・分野の構造を扱わない初心者向けチュートリアルの作成。代わりにチュートリアル用のスキルを使用してください。
• レポートやチュートリアルの設計を伴わない、完成ファイルの形式変換
• 法律、医療、金融、安全に関する助言を最終的な推奨事項として提示すること。こうした内容は、出典と不確実性に関する注記を付した教育目的の調査として扱ってください。

既定のワークフロー

1. references/domain-expert-method.mdを読み、前提と専門知識の学習概要をまとめます。
2. references/research-and-source-quality.mdを読み、情報源の計画を立てます。分野の情報が時間とともに変化する場合は、最新の事実を確認します。
3. templates/expert-report-template.mdを使用して、標準となるレポートをMarkdownで作成します。
4. チュートリアルの学習パス、キーワード学習カード、概念マップ、代表的な人物・企業・事例のマップ、ファインマン・テスト、根拠一覧、不確実性ログを追加します。
5. references/report-and-tutorial-contract.mdを読み、セクションの網羅性、根拠のラベル、学習内容の十分さを確認します。
6. references/export-and-layout-quality.mdを読み、scripts/export_expert_report.pyを実行して、Markdown、DOCX、PDF、HTMLを出力します。
7. scripts/validate_artifacts.pyを実行し、納品前にレイアウト、表、アンカー、はみ出し、引用、ローカルパスの問題を修正します。

出力仕様

通常の出力一式は次のとおりです。

• {basename}.md：専門家向け学習レポートとチュートリアル一式の正本
• {basename}.docx：読みやすい表と控えめなレポートスタイルを備えた Word 文書のエクスポート
• {basename}.pdf：ページレイアウトと表のはみ出しリスクを確認した PDF のエクスポート
• {basename}.html：固定表示の左側番号付きナビゲーションメニューとセクションアンカーを備えたスタンドアロン HTML レポート
• 前提、情報源の網羅範囲、不確実性、検証結果、次の学習ステップを記載した短い納品メモ

品質ゲート

• トピックの範囲には、広い範囲、狭い範囲、除外範囲、データ／情報源の範囲が含まれています。
• レポートは 导读摘要 から始まり、導入、ハイライト、読み進め方、論理の概要を含みます。Markdown、DOCX、PDF、HTML のすべてのエクスポートで、この冒頭の要約が保持されている必要があります。
• 主要な各モジュールには、詳細な表やマトリックスの前に、読者向けの導入があります。
• 重要な主張には、情報源の階層、日付、確信度が示されています。
• 主要な判断には、事実、推論、仮説、不明のいずれかのラベルが付いています。
• キーワード学習カードは、需要、製品、テクノロジー、バリューチェーン、ビジネスモデル、競争、政策、財務、運用、リスク、トレンドを網羅しています。
• 各キーワード学習カードでは、次の項目を説明します。意味、一文での理解、存在する理由、仕組み、実際の分野での登場箇所、応用方法、果たす役割、関連する人物／企業／機関（該当する場合）、初心者がよく誤解する点。
• 学習の手がかりとして、代表的な人物、企業、機関、製品、事例を、根拠のないランキングではなく、役割ラベルと情報源の注記とともに掲載しています。
• チュートリアルは、用語を列挙するだけでなく、初心者が全体像の把握から自己確認まで進められる構成です。
• HTML には、順序付きインデックス、簡潔な中国語 4 文字のアンカーラベル、透明な背景、独立したサイドバーパネル風のスタイリングを持たない固定表示の左側ナビゲーションツリーが含まれています。
• PDF のエクスポートでは、印刷前に HTML のナビゲーションノードを削除し、ブラウザーの印刷用表示を非表示にします。ナビゲーションラベル、file:// パス、日付、ブラウザーのページフッターは表示されません。
• DOCX／PDF／HTML のエクスポートが存在し、scripts/validate_artifacts.py の検証に合格しているか、未解決の失敗があればその内容が正確に明示されています。

参照マップ

• references/domain-expert-method.md
• references/research-and-source-quality.md
• references/report-and-tutorial-contract.md
• references/export-and-layout-quality.md
• templates/expert-report-template.md
• templates/expert-report.css
• templates/report-html-shell.html
• scripts/export_expert_report.py
• scripts/validate_artifacts.py
• evals/trigger_cases.json