1. 基本信息
| 项目 | 内容 |
|---|---|
| 名称 | navigation-3-android-skills |
| 项目自述名称 | navigation-3（SKILL.md frontmatter name 字段） |
| 作者/维护者 | Google LLC（Android 官方团队） |
| 来源链接 | https://github.com/android/skills/tree/main/navigation/navigation-3 |
| 许可证 | Apache License 2.0（GitHub API 确认，仓库级） |
| GitHub Stars / Forks | 6,252 / 354（GitHub API；为 android/skills 整个合集仓库的数据，不代表本条子技能单独热度） |
| 最新版本 | 仓库标签 v1.0.5（2026-07-10 发布）；本技能 SKILL.md 最近更新于 2026-07-09（frontmatter last-updated 字段） |
| 安装方式 | Android CLI 一条命令，或手动复制到对应 Agent 的 skills 目录（详见第 10 章） |
2. 功能介绍与亮点
这是 Google Android 官方团队发布的结构化技能，指导 Agent 完成从 Jetpack Navigation 2 迁移到 Navigation 3，并实现深链接、多返回栈、Scenes（对话框、Bottom Sheet、列表-详情双栏、辅助面板）、条件导航（如登录态切换）、跨页面返回结果、与 Hilt/Koin 依赖注入及 ViewModel 集成、View 互操作等一整套现代导航模式。
亮点：
- 官方出品：作者为 Google LLC，是 2026 年 4 月 Android Developers Blog 公开发布的
android/skills系列技能之一。 - 内容体量与广度突出：SKILL.md 正文 112 行，链接到数十份细分 recipe 文档，覆盖从最基础 API 用法到动画、模块化 DI 等高级模式的完整谱系。
- 不止是一次性迁移指南：同时是可反复查阅的导航模式速查手册，后续新增页面、新导航流程时可继续调用，而非用完即弃。
- 持续高频维护：SKILL.md 本身 2026-07-09 更新，配套版本标签 2026-07-10 发布，来源仓库整体 2026-07-14 仍有推送。
3. 适用场景
固定分类：前端与设计。
适用于使用 Jetpack Compose 构建 Android 应用、需要把导航架构从 Navigation 2 迁移到 Navigation 3、或要实现深链接、多窗格、对话框等现代导航模式的 Android 工程师；也适合刚接触 Navigation 3、希望有可靠代码范例而非零散博客文章可查的初中级开发者。
4. 跨 Agent 兼容性
- Claude Code：✅ 原生支持（格式兼容）。
android/skills遵循开放的 Agent Skills 标准，官方文档明确写明“compatible with any AI tool that supports skills”；技能目录就是标准 SKILL.md + YAML frontmatter + references 结构，与 Claude Code 自身的技能规范一致，可直接复制到.claude/skills/使用。 - Codex：✅ 原生支持（格式兼容）。同一开放标准，Codex 同样原生识别 SKILL.md 格式，手动放置即可使用。
- OpenClaw：❓ 未验证。已抓取的官方文档与仓库 README 均未提及该 Agent。
- Hermes Agent：❓ 未验证。同上，抓取材料中无相关信息。
需注意：官方 Android CLI 默认仅为 Gemini 与 Antigravity 自动安装技能（未显式指定 Agent 时），面向 Claude Code / Codex 需手动指定或手动复制，详见第 10 章。
5. 推荐理由
导航是几乎所有 Compose 应用都绕不开的高频场景，Navigation 3 又是 Google 主推的新一代导航架构。这份官方 SKILL.md 把从迁移到十余种具体 UI 模式（对话框、Bottom Sheet、双栏、多返回栈、条件导航等）的实现方式系统整理成可供 Agent 直接调用的知识库，省去在分散的官方文档、样例仓库之间来回查找的成本，对正在规划迁移或刚上手 Navigation 3 的初中级 Android 开发者尤其省心。
6. 评分
| 维度 | 分数 | 说明 |
|---|---|---|
| 受欢迎程度 | 9 | 官方一线机构（Google Android 团队）出品，2026-04 由 Android Developers Blog 公开发布；仓库 6,252 stars（属整个合集，非本技能专属，已在第 1 章注明） |
| 可用性 | 9 | 内容详尽（112 行正文 + 数十份细分 recipe），SKILL.md 本身 2026-07-09 仍有更新，配套版本 v1.0.5 于 2026-07-10 发布；手动复制即可用于 Claude Code / Codex，无付费依赖 |
| 安全性 | 9 | 详见下方安全检查清单 |
| 综合 | 9.0 | 三项均值 |
安全检查清单：
| 检查项 | 结果 |
|---|---|
| ① Shell 命令及权限范围 | 全文未要求执行任何 shell 命令或脚本，纯文档/代码范例型技能 |
| ② 运行时联网外发 | 无，不涉及任何数据外发 |
| ③ API Key / 凭据 | 不需要 |
| ④ SKILL.md 与脚本可疑指令 | 已通读 SKILL.md 全文（112 行）及引用的 recipe 文档清单，内容均为 Jetpack Navigation 技术文档与代码范例，未发现要求执行越权操作或外发数据的可疑指令 |
| ⑤ 作者/组织信誉 | Google LLC，Android 官方团队，信誉良好 |
| ⑥ License | Apache License 2.0，明确（仓库级） |
| ⑦ 最近维护时间 | SKILL.md 2026-07-09 有更新，仓库整体 2026-07-14 仍有推送，非弃置项目 |
7. 跟同类 Skills 相比的优势
android/skills 合集仓库中其他官方子技能与本技能的定位差异：
| 名称 | 来源 | 定位 | 与本技能的差异 |
|---|---|---|---|
| navigation-3（本推荐） | android/skills | Navigation 2→3 迁移 + 全谱系导航模式范例库 | — |
| migrate-xml-views-to-jetpack-compose | android/skills | XML View → Compose 全流程迁移，含视觉回归验证 | 面向 View 层迁移，不涉及导航架构 |
| agp-9-upgrade | android/skills | Android Gradle Plugin 9 构建系统升级 | 面向构建工具链升级，与 UI/导航无关 |
| edge-to-edge | android/skills | 修复系统栏遮挡、适配 Android 15 强制边到边显示 | 聚焦系统栏适配这一单点问题，范围远小于导航架构 |
| r8-analyzer | android/skills | 分析 R8/Proguard keep 规则，优化包体积 | 面向发布期包体积优化，与开发期导航搭建无交集 |
差异化总结：同属 android/skills 的其他子技能各自聚焦迁移、构建、包体积、系统栏适配等单点问题；navigation-3 是仓库内内容体量最大、覆盖场景最广的一份，既是迁移指南也是长期可复用的导航模式速查手册，覆盖对话框、多窗格、深链接、条件导航、依赖注入集成等十余种具体实现，方法论完整度突出。
8. 用户评价
该技能作为 2026 年 7 月新收录进 android/skills 仓库的子目录，目前第三方平台尚无针对该技能本身的具名用户评价。
9. 其他补充
无。
10. 安装使用方式
方式一：Android CLI（官方推荐，一条命令）
android skills add --skill=navigation-3 --project=.需先安装 Android CLI；未指定 --agent 时默认为 Gemini 与 Antigravity 安装，面向 Claude Code / Codex 需显式使用 --agent 参数指定，具体取值以官方文档为准。
方式二：手动安装（适用于 Claude Code / Codex）
git clone https://github.com/android/skills.git
cp -r skills/navigation/navigation-3 <你的项目>/.claude/skills/navigation-3复制时需保留 SKILL.md 与 references/ 目录的相对结构。安装后无需重启，Agent 会在识别到“迁移到 Navigation 3”或“实现某种导航模式”类任务时自动触发，也可按各 Agent 自身语法手动调用。
11. 注意事项
- 技能本身不含独立的 Shell 脚本或自动化测试，迁移正确性依赖 Agent 自行验证（如手动运行
./gradlew build确认编译通过），建议在版本控制下操作并人工复核 diff。 - 部分 Scene（自定义 BottomSheet、双栏等）recipe 要求项目已引入 Material 3 Adaptive 等配套库，使用前需按 recipe 中的依赖说明补齐。
- OpenClaw、Hermes Agent 兼容性未经验证，使用前建议先在小范围试点。
- 官方 Android CLI 默认只为 Gemini / Antigravity 自动安装，Claude Code / Codex 用户需手动复制或显式指定
--agent参数。