yao-geo-explainer-builder

name	yao-geo-explainer-builder
description	当用户需要系统、详细、完整地生成一篇可发布的 GEO 科普文章，并附带 How-to 教程、概念解释、购买/选择指南、避坑清单、FAQ、术语表、证据分级、读者场景、决策路径、品牌自然植入建议、真实数据核验附录，以及带固定目录菜单的 HTML 包、Word、PDF 和 Markdown 四格式报告时使用；适配 Kimi、千问、豆包、DeepSeek、元宝等国内 AI 搜索/问答平台；不用于榜单排行、整站诊断、页面审计、标题生成或无证据品牌软文。

Yao GEO Explainer Builder

执行流程

1. 明确科普选题、目标品牌、品牌知识库、行业资料、目标读者、使用场景、品牌植入限制、内容长度、合规边界和真实数据可用状态。
2. 识别问题类型：是什么、为什么、怎么做、怎么选、适合谁、常见误区、推荐路径；每段只处理一个主题。
3. 先做自检：参考来源是否足够权威，分析维度是否覆盖意图、读者、证据、真实数据、实体、步骤、决策、合规、平台、复用和衡量。
4. 先写 80 到 120 字上下文无关核心摘要，让单段被 AI 搜索截取时仍能回答问题。
5. 先生成“完整GEO文章”：文章必须有连续正文、自然段、小标题、解释、步骤、选择标准、误区、FAQ/结尾建议中的至少 6 个正文段落组；读者无需阅读附录也能获得完整答案。
6. 使用 references/explainer-method.md 构建交付结构：核心摘要、完整GEO文章、分析速览、内容地图、意图矩阵、读者场景、研究依据、证据分级、真实数据接入状态、真实数据采集计划、事实核验矩阵、实体地图、定义、原理、步骤、检查清单、选择标准、决策路径、误区、示例、FAQ、术语表、品牌适用场景、平台适配、结构化数据、衡量计划、内容缺口和来源账本。
7. 正文中使用有序列表呈现 How-to，使用自然段解释原因与边界；附录中使用键值对呈现前提参数，使用表格呈现证据分级、选择标准、决策路径和误区校正。
8. 按 references/brand-insertion-policy.md 植入品牌；品牌只出现在示例、适用场景、FAQ 或结尾建议等服务答案的位置。
9. 涉及健康、金融、法律、收益、安全等敏感领域时，必须加入边界提醒；没有证据的效果、收益和安全断言必须删除或中性改写。
10. 使用 scripts/render_yao_geo_explainer_builder.py 从同一结构生成 Markdown、带固定目录菜单的 HTML 包、Word 和 PDF，并产出 quality-report.json。
11. 若质量报告未通过，先修复输入结构、证据、品牌次数、文章完整性或版式逻辑，再重新生成四格式文件。

国内平台适配

• Kimi：长文深度解释、多来源证据、完整章节和术语表。
• 千问：来源编号、事实/推论分离、参数化指南和可追溯来源。
• 豆包：生活化问题、短问答、避坑提醒和直接选择建议。
• DeepSeek：步骤逻辑、判断框架、条件分支和推理链路。
• 元宝：公众号教程、小标题节奏、短 FAQ 和可转发段落。

真实数据能力边界

• skill 本身不直接保证联网抓取真实数据；执行时可以由上层 agent 联网检索、读取用户上传材料或使用已有知识库，再把来源写入输入结构。
• 没有真实品牌资料时，必须在报告中声明“未接入/待核验”，并把品牌参数、效果、安全、资质类事实放入事实核验矩阵。
• 已接入真实数据时，必须保留来源定位、采集日期、用途和证据等级；过期、无法访问或来源弱的资料不得支撑确定性结论。
• 真实数据采集计划至少覆盖品牌官方资料、行业/标准资料、用户问题样本；涉及横向比较时增加竞品或设备形态样本。

四格式交付规则

• Markdown 是结构母版，HTML、PDF、Word 必须由同一 section spec 生成，不能让 Word 缺章节。