用途:当 content/ 下的页面移动或重命名时使用本技能,保留旧的公开 URL,并修复仓库内的交叉引用。支持 PR 范围模式(单次 PR 的迁移)与全站模式(PR 后的完整迁移)。
使用前先阅读 CLAUDE.md / AGENTS.md(URL 规则、vendored 区域、外部链接、特殊情况)与 hugo.yaml(permalinks、refLinksErrorLevel、disablePathToLower);正文与链接文本遵循 STYLE.md,组件、front matter 与链接示例遵循 COMPONENTS.md。
强制流程:先用 git diff --name-only main...HEAD(其他目标分支先用 git merge-base 求 BASE,再 git diff --name-only "$BASE"...HEAD)确定移动范围,建立旧→新的源路径与公开 URL 映射;随后在允许的树中扫描(至少 content/,必要时 data/ 与 layouts/),把命中记录为 List 1(旧路径、无片段)与 List 2(旧路径带 #…)。按 Phase 1 处理 front matter 别名,Phase 2 更新 List 1,Phase 3 逐个交互确认 List 2 的新路径与锚点;最后重新扫描同一旧路径集合并运行 docker buildx bake validate,验证前可运行 review-changes。
关键规则:不能用 git diff 的文件清单当作待修链接的完整集合,入站链接常出现在 PR 未触及的文件中;不得猜测替换路径、公开 URL 或片段 ID,用户未给出明确目标时应询问、推迟或停止;别名只加在新规范页,注意碰撞检查,不添加从未发布过的投机重定向;内部 Markdown 链接用相对源文件路径(.md),并遵循各文件既有写法。
限制与缺失:资料未提供该技能的具体安装方式、运行命令、收费与平台信息。