用途 该技能面向开发者文档负责人，解决“开发者先问 AI 助手怎么做，再复制返回的代码”这一场景下的文档可见性与版本正确性问题。目标是让 AI 回答引用官方文档，并使用当前发布版本，同时用可复现的测量证明效果。
主要能力
- 管线诊断：区分 AI 回答来自训练记忆、搜索检索还是实时抓取，指出针对错误链路修改无效。
- 提示词面板基线：按开发者真实提问（核心任务、确切错误串、迁移问题、是否仍支持）编写提示词，为每条准备答案要点，多次运行并按引用来源、是否引用自有页面、版本是否正确、是否使用废弃 API、是否编造 API 打分。
- 失败归因：用搜索开关、来源请求、版本探测、日志检查、索引检查五项测试判断失败所属管线，并给出修复见效的滞后估计。
- 措施排序：按单位投入价值排序，默认优先“页面文本中的版本标识”和“清理自有陈旧副本”；有旧符号提问时加入新旧符号映射表；在 SDK 发布中运行时弃用警告与向编码代理投递版本匹配文档价值最高但投入大。
- 删除清单：明确删除仅作为战术的通用 AI 搜索改写、日期更新、把 llms.txt 当作引用手段、隐藏仍在使用的版本等做法。
- 复测：使用 14 天以上第一方数据，统计文档路径上的 AI 来源引荐、按机器人角色与版本文档路径切分服务器或 CDN 日志、使用 Bing 的 Copilot 引用报告、支持工单中的“助手生成代码”信号，并在固定时间点重跑同一面板。
使用方式 以访谈方式逐题询问，尽量提供选项，记录任务信息于 devrel-context.md 或既有记忆系统。先检查访问权限（robots.txt、CDN 机器人策略、片段控制、无 JavaScript 抓取测试），再建立提示词面板基线，随后诊断、选措施、复测。仓库提供脚本 python3 scripts/ai-bot-log-summary.py --path-prefix /docs/ access.log，可按厂商 IP 范围文件添加 --ip-ranges <file>（仅用 Python 3 标准库，combined 日志格式）。
适用场景 ChatGPT 或 Claude 用已弃用的 v2 文档回答安装问题；想知道文档是否出现在 AI 回答中；考虑是否添加 llms.txt 让 Perplexity 引用；GitHub Copilot 建议使用已移除的配置开关；管理层要求为文档制定 GEO 计划。
限制与边界 不发布引用算法，所有关于助手如何选择来源的说法须标注为厂商文档、独立测量、实践推断、厂商营销或第一方数据。不得编写引导助手选择某产品的文本（提示注入）。训练记忆类失败通常只能等下一次模型发布或依靠运行时信号。搜索索引类修复需数天到数周。单次运行属噪声，需多次运行并按提示词族汇总。一个月内的截止日期只能展示页面改动，无法证明引用结果。无 SDK 发布权限时须说明运行时警告与最终补丁无法实施。搜索、索引、规范化与版本树归 docs-seo；机器可读界面与代理入口归 coding-agent-docs-optimization；查询规模归 developer-keyword-research；渠道与分析归 devrel-analytics。具体默认面板规模、复测周期等为本技能自身默认值，非行业标准。