用途:审计 adk-docs 仓库中所有语言 SDK 的 API 参考文档,检测三类漂移:docs/api-reference/ 下生成的参考文档落后于最新 SDK 发布;正文与示例中硬编码的版本字符串(依赖坐标、pom.xml 版本)未随 Java/Kotlin 发布更新;代码示例中引用固定版本或明显弃用 API(仅轻度标记,深度校验不在范围内)。
主要能力:按版本映射表读取各 surface 的仓库内版本标记(Python API/CLI/REST、Python Agent Config、TypeScript、Go、Java、Kotlin),与上游仓库及包注册表(PyPI、npm、Maven Central、pkg.go.dev)对比,将每个 surface 分类为最新、落后或未知/手动,并检查硬编码版本引用与 Go 链接。
使用方式:先读取各标记文件记录当前版本,再用 gh api、PyPI/npm/Maven 接口获取上游最新版本;Java/Kotlin 以 GitHub tag 为准,Maven Central 仅作交叉核对。Agent Config 无版本字段,需对比上游 AgentConfig.json 的 $defs 键集合。输出 Markdown 报告,含状态表与按优先级排列的发现(🔴 过期/损坏、🟠 硬编码版本陈旧、🟡 示例漂移提示)。仅当用户明确要求时,才输出可执行计划,包括各 surface 的生成命令(如 bash tools/python-api-docs/generate.sh <new-version>)与文件行级修改建议。
限制:默认只报告与建议,不编辑文件、不运行生成器、不开 PR;映射表仅为提示,需逐步验证路径是否存在;不得改动语言支持标签内的版本;不编造未读取或未获取的版本与链接。