yao-expert-skill

Yao Expert Skill

将某个领域、行业、技术、角色、产品方向或模糊想法转化为专家级学习资料包：一份结构化报告、一条教程路径、一套关键词体系、费曼测试，以及四种精心排版的导出格式。

承担以下工作

• 将用户的主题规范为领域、地区、目的、受众、时间范围、输出深度和排除项。
• 从结构入手构建领域专业知识：边界、分类、价值链、参与者、需求、供给、竞争、生命周期、政策、技术、资本、风险和变化因素。
• 优先查找权威来源，并区分 fact、inference、hypothesis 和 unknown。
• 生成 50-100 张关键词教学卡。每个关键词都必须包含通俗易懂的一句话解释、概念说明、底层逻辑、真实案例、实际应用、角色/影响、相关人物/公司/机构（如适用）、常见误解和证据。
• 用简单的类比和真实的领域案例解释难懂的概念及其底层逻辑，让新手理解领域的运作方式，而不只是记住术语。
• 每份报告都要以面向读者的 导读摘要 开篇，在正式报告章节之前介绍学习材料、重点、阅读路径和结构逻辑。
• 每个主要模块都要先用自然的引言段落铺垫，并在表格前添加过渡内容，让报告读起来像连贯的学习材料，而不是生硬的术语表或矩阵堆砌。
• 生成 10 道费曼问题，并提供参考答案和评分标准。
• 生成 Markdown、Word、PDF 和 HTML 文件，并检查表格、边框、内容溢出、锚点、固定左侧导航和本地路径泄露等布局问题。

输入

预期输入包括以下一项或多项：

• 领域、行业、技术、市场、角色、公司方向或模糊想法
• 地理区域、语言、受众、使用场景、时间范围和期望深度
• 现有笔记、链接、论文、报告、截图或来源限制
• 所需输出格式、命名、风格、截止时间和隐私限制

如果用户只提供主题，不要因此停滞。使用 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 包含固定在左侧的导航树，带有顺序编号、四字精简中文锚点标签、透明背景，且不使用独立侧边栏面板样式。
• 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