Route Sync

让功能路由图与当前代码定位信息保持一致。只有确认定位信息发生变化时才修改文档；如已确认变化但部分字段未知，只更新已确认信息，未知字段标记为 uncertain。

核心原则

• 功能路由图不是完整代码索引或功能知识库，只记录下次修改功能时最值得先读的位置。
• 实际代码变更优先于计划文档。
• 无法确认的信息写 未知、uncertain 或直接省略，不得编造。
• 默认只改相关条目，不为统一样式而重写整个路由图。
• 默认只修改 RouteSpec 文档，不修改业务代码。

何时需要检查

以下情况必须检查 route-sync：

• 新增或删除核心功能。
• 功能入口文件变化。
• 核心实现文件迁移。
• 关键测试入口新增、删除、迁移或重命名。
• 原路由图指向明显过期。

以下情况通常只需说明无需修改：内部实现细节调整、格式化、注释、普通文案、日志、不改变定位路径的小型重构、单纯补充测试但不影响关键测试入口。

工作流

1. 读取功能路由图：默认 docs/routespec/feature-routes.md 或 docs/routespec/feature-routes/。
2. 收集本次任务信息：实际变更文件、git diff、测试结果、执行摘要、plan.md、design.md、用户说明。
   • 如实现未完成或验证失败，只能同步已确认的定位变化；存在未验证路径时必须标记为 uncertain，不得输出确定的“已更新”。
3. 判断是否需要修改：
   • 不需要：输出原因，不改文件。
   • 需要：更新已有功能定位条目，或新增功能定位条目。
   • 不确定是否发生变化：不改文件，只输出未确认内容。
   • 确认发生变化但部分字段未知：更新已确认信息，未知字段标记为 uncertain。
4. 处理废弃或移除功能：
   • 功能仍在但不推荐使用：在备注中说明已废弃。
   • 功能已删除或被替代：删除或移动相关定位条目；需要保留时只记录原入口和替代功能。
   • 只有用户明确要求整理归档时，才移动到 feature-routes-archive.md。
5. 修改内容与已有路由图的条目格式保持一致。
6. 输出同步摘要。

输出格式

# Route Sync Summary

## 结果
- 已更新 / 无需更新 / partial / uncertain

## 新增功能路由
- 无 / ...

## 修改功能路由
- 无 / ...

## 废弃或移除
- 无 / ...

## 文件位置变化
- 无 / ...

## 未确认内容
- 无 / ...

## 后续建议
- 无 / 建议人工确认 / 建议再次执行 route-sync 审计模式 ...

审计模式

当用户要求检查路由图是否过期时，先做轻量审计。逐条检查功能定位条目：

1. 核心 中引用的文件是否存在。
2. 入口 描述的位置是否仍与代码匹配。
3. 测试 中引用的文件是否存在，是否仍是该功能的关键测试或验证入口。
4. 是否存在关键测试入口迁移、重命名或删除但未在路由图中反映。
5. 是否存在已删除或被迁移但未在路由图中反映的功能。
6. 每个条目是否至少包含可用于下次定位的入口或核心代码位置。

全部通过则输出"无需更新"；发现缺失关键定位信息时结果标记为 partial，并按本技能正常流程补充已确认信息。发现其他问题后按本技能正常流程更新。不需要单独进入复杂审计流程，除非用户明确要求全面审计。