Route Init

首次创建功能路由图，定义格式模板并写入初始条目。

核心原则

• 只在路由图不存在时执行首次初始化。
• 基于当前任务做定向代码扫描，只记录本次任务直接相关的功能，不做全仓库盘点。
• 仅当当前任务能关联到明确功能、入口或核心代码时写入功能定位条目；如无法确认功能名称或入口，字段标记为 uncertain。
• 如果当前任务不适合生成首个功能条目（如 typo、格式化、依赖升级、纯文档），只创建基础模板并说明原因，不强行写入低质量条目。
• 功能路由图不是完整索引或功能知识库，只记录下次修改功能时最值得先读的位置。
• 无法确认的信息写 未知、uncertain 或直接省略，不得编造。

路由图位置

• 默认创建 docs/routespec/feature-routes.md。
• 只有项目已采用目录模式，或用户明确要求拆分时，才使用 docs/routespec/feature-routes/。
• 目录模式下按功能或模块使用 kebab-case 文件名，例如 docs/routespec/feature-routes/user-auth.md；lookup 时必须读取目录下相关文件，无法确定相关文件时再做定向扫描。
• 目录模式必须维护轻量索引：docs/routespec/feature-routes/README.md 或 docs/routespec/feature-routes/index.md，记录“功能名 -> 路由文件”的映射，便于 lookup 先定位具体文件。

工作流

1. 确认路由图不存在：检查 docs/routespec/feature-routes.md 或 docs/routespec/feature-routes/。
2. 基于当前任务做定向代码扫描，优先源码、入口、配置和测试目录，排除依赖、构建产物、缓存和生成代码。
3. 使用首次初始化模板创建路由图文件；默认使用 docs/routespec/feature-routes.md。
4. 如使用目录模式，先创建功能索引文件，再创建匹配当前任务的具体功能文件。
5. 当前任务能关联到明确功能、入口或核心代码时，写入至少一个功能定位条目；不适合生成条目时只保留基础模板，并说明原因。
6. 初始化完成后，回到 route-lookup 继续 lookup 流程，并将覆盖状态标记为 partial。

首次初始化模板

# 功能路由图

## 项目概览

- 入口：`...`
- 核心目录：`...`
- 测试：`...`

## 功能

### {功能名}

- 说明：...
- 入口：`...`
- 核心：`...`
- 测试：`...`

功能定位条目

每个功能只保留能帮助定位代码的信息：

• 功能名。
• 一句话说明。
• 用户入口或外部入口。
• 核心代码位置。
• 相关测试或验证位置。
• 必要备注。

功能定位条目只包含有助于定位代码的信息。状态、类型、变更历史、编排流程、状态数据、集成点、配置、平台差异、观测调试或关联功能等扩展信息，确实影响定位时合并到一句备注。

新增条目模板

### {功能名}

- 说明：...
- 入口：`...`
- 核心：`...`
- 测试：`...`
- 备注：...

缺失字段可以省略，不强制填 N/A。

目录模式索引模板

# 功能路由索引

- {功能名}: `{feature-file}.md`