check-docs-drift - 检测并同步 polkadot-docs 教程漂移与依赖版本
扫描 polkadot-docs README 文件检测上游提交漂移，将差异分类为表面或实质性变更，自动更新表面变更的 docs_commit，为实质性漂移创建 GitHub Issue，并从上游 variables.yml 同步依赖版本。
标签
更新于: 2026-06-30该技能可以做什么
- 扫描 polkadot-docs README 文件
- 从 frontmatter 提取固定提交
- 比较固定提交与上游提交
- 通过 GitHub API 获取差异补丁
- 将差异分类为表面或实质性变更
- 自动更新 README 中的表面漂移
- 为漂移创建 GitHub Issue
- 从上游同步依赖版本
- 更新 package.json 和 lockfile
- 生成带指标的运行报告
输入
- polkadot-docs README 文件
- versions.yml 文件
- polkadot-docs 仓库的上游 variables.yml
- 测试目录中的 package.json 文件
- GitHub API 访问令牌
输出
- 更新后的 README 文件（含新 docs_commit）
- 更新后的 versions.yml
- 更新后的 package.json 文件
- 重新生成的 package-lock 文件
- 包含漂移报告的 GitHub Issue
- 包含各阶段指标的运行报告
要求
- 已安装并认证的 GitHub CLI
- 已安装 npm 用于 lockfile 重新生成
- 对仓库的 Git push 权限
- 对 polkadot-developers/polkadot-docs 仓库的读取权限
- 支持并行子代理的 Agent 工具