该技能用于跨网站、GitHub 仓库与本地文档做只读的消息一致性校验,帮助发现“混合口径”问题。运行参数为温度 0.0,即只做事实分析,不做创意发挥;只报告差异,不提出创意性修复方案;只做精确比对,不做解读推断。
用途
- 以网站为官方事实来源,本地文档(SOP、标准、原则、信念、培训材料、内部文档、流程)必须与网站一致。
- 报告内部文档相比已发布网站缺少什么。
- 覆盖三类内容源:任意 HTML 网站(WordPress、Hugo、Astro、Next.js、静态 HTML 等)、GitHub 仓库(README、技术文档)、本地文档。
主要能力
- 来源发现:识别静态 HTML、Hugo/Astro、Jekyll/GitHub Pages、WordPress、Next.js/React、Vue/Nuxt、Gatsby、11ty/Eleventy、Docusaurus 等网站结构,定位营销页、落地页、产品描述;定位仓库、README.md、CONTRIBUTING.md、文档目录;定位 claudes-docs/、docs/、internal/ 等本地文档。
- 内容提取:核心表述、功能描述、版本号、URL 与链接、联系信息、技术规格、术语用法。
- 一致性分析:按三级分类——关键差异(版本号冲突、功能清单不同、技术要求矛盾、联系信息不符、交叉引用失效)、警告(术语不一致、同一概念表述不同、一方信息缺失、时间戳过时)、提示(风格差异、平台特定差异、详细程度不同)。
- 报告生成:输出 Markdown 报告,含执行摘要、网站与 GitHub 差异、网站与本地文档差异、GitHub 与本地文档差异、术语一致性表、按优先级排序的行动项,并给出文件位置与行号。
使用方式
- 自然语言触发,如“检查网站与 GitHub 的一致性”“校验文档一致性”“审计跨平台消息”“查找混合消息”“更新内部文档前先核对网站”“确保网站与 GitHub 一致”“生成一致性报告”。
- 只使用只读工具:Read、Glob、Grep、WebFetch(读取已部署网页)、只读 Bash(cat、grep、find);绝不使用 Write、Edit、git commit 或任何文件修改操作。
- 输出:Markdown 报告保存至 consistency-reports/YYYY-MM-DD-HH-MM-SS.md,并提供终端友好摘要;可选导出 JSON 供自动化使用。
适用场景
- 更新内部文档、创建培训材料、撰写新营销内容、发布博客、发布新版本之前。
- 网站更新、GitHub README 变更、重大功能发布、品牌重塑之后。
- 核对版本号、功能声明(如插件数量)、联系邮箱、安装命令(npm install 与 pnpm install)是否一致。
限制
- 不自动修复问题、不修改任何文件、不做内容决策、不判定哪个版本“正确”,只生成供人工审阅的只读报告。
- 冲突时的信任优先级为网站 > GitHub > 本地文档,更新流转方向为网站 → GitHub → 本地文档。