用途:检查新写或更新的 Elastic 文档是否与文档库其他位置的内容发生事实性矛盾,例如流程、概念、前置条件、取值、名称等。它只报告发现,供作者判断还需同步更新哪些页面,不负责改写。
主要能力:从新内容中提取事实性断言(取值、命名、步骤、前置条件、概念定义、可用范围、关系、能力、建议),在本地检出仓库和已发布的 Elastic 文档中搜索同一主题并逐条比对,输出结构化报告。报告按本地与跨仓库分区,每条包含位置、严重程度(High/Medium/Low)、修复方向(Review draft/Review existing/Verify both)、断言类型、矛盾描述与建议。
使用方式:输入为包含新文档的文件或目录($ARGUMENTS),为空时询问用户。先读取全部 .md 文件并建立断言清单,再构造精确搜索词,用 Grep 搜索本地仓库,用 Elastic Docs MCP(https://www.elastic.co/docs/_mcp/,无需认证)搜索已发布文档;MCP 不可用时回退到 WebFetch 指定已发布文档 URL。
适用场景:任何类型的文档编辑,包括新功能页、修订流程、更新概念、变更前置条件、重命名设置、修正取值或新增建议。与 docs-check-style(语言格式)和 docs-applies-to-tagging(部署范围标签)互补。
限制:只标记真正的事实冲突,不标记措辞、详细程度或风格差异;排除 _snippets/、release-notes/、redirects.yml 及自动生成文件;跨仓库检查仅覆盖已发布文档,其他仓库未合并或未发布内容不在范围内;无法确定正确状态时需 SME 确认。