| role | [AI] |
| name | anchor-fixer |
| description | 安全修复 Markdown 锚点跳转失效——标题锚点与链接片段不一致、标题规范化后的锚点漂移。适用场景:文档内跳转链接失效修复、标题变更后的锚点同步。 |
锚点修复工作流
目标
修复 Markdown 内部锚点跳转失效,保持文档结构和语义不变。
输入项
- 目标文件/目录
- 模式:只读核查或写盘
- 是否允许跨文件修改(默认否)
- 是否允许改动标题文本(默认仅修链接)
Gotchas
- GitHub 风格锚点会将标题中的大写字母转为小写、空格转为连字符、移除标点符号。中文字符在锚点中通常被完全移除(如
## 第一步:准备 → #第一步准备)。
- 同一文件内存在同名标题时,GitHub 会自动追加
-1、-2 后缀。修复时必须确认目标锚点是否包含这些后缀。
- 不要混淆文件内锚点(
[link](#heading))和跨文件锚点([link](file.md#heading))——两者的修复策略不同。
执行流程
- 预检——收集范围内所有链接和标题,映射检测不匹配
- 若只读模式 → 产出核查报告
- 若写盘模式 → 输出
### Blueprint → 工具调用获取授权
- 执行最小编辑——根据上下文决定修链接片段、修标题、或两者兼修
- 完成校验——所有锚点可解析、结构完整、未改动无关内容
输出模板
### 核查报告(只读)
- 扫描链接总数: ...
- 失效链接数: ...
- 受影响标题: ...
- 修复建议: ...
### Blueprint(写盘)
- 目标: ...
- 修复策略: ...
- 风险: ...
- 回滚点: ...
- 校验项: ...