1. 基本信息
| 项目 | 内容 |
|---|---|
| 名称 | edge-to-edge-android-skills |
| 项目自述名称 | edge-to-edge（SKILL.md frontmatter name 字段） |
| 作者/维护者 | Google LLC（Android 官方团队） |
| 来源链接 | https://github.com/android/skills/tree/main/system/edge-to-edge |
| 许可证 | Apache License 2.0（GitHub API 确认，仓库级） |
| GitHub Stars / Forks | 6,258 / 355（GitHub API；为 android/skills 整个合集仓库的数据，不代表本条子技能单独热度） |
| 最新版本 | 仓库标签 v1.0.5（2026-07-10 发布）；本技能 SKILL.md frontmatter last-updated 为 2026-04-01，子目录最近一次代码提交为 2026-05-09 |
| 安装方式 | Android CLI 一条命令，或手动复制到对应 Agent 的 skills 目录（详见第 10 章） |
2. 功能介绍与亮点
这是 Google Android 官方团队发布的结构化技能，指导 Agent 将 Jetpack Compose 应用迁移到自适应边到边（edge-to-edge）显示：修复被状态栏、导航栏遮挡或重叠的 UI 组件（按钮、列表等）、修复输入法（IME）insets 问题、确保系统栏图标在不同背景下清晰可辨。
工作流分三步：①规划阶段分析项目中的 Activity 与列表/悬浮按钮等组件；②添加 enableEdgeToEdge() 调用并配置 windowSoftInputMode；③通过 Scaffold、Material 组件或 padding modifier 正确应用系统 insets。
亮点：
- 官方出品：作者为 Google LLC，2026 年 4 月由 Android Developers Blog 公开发布的
android/skills系列技能之一。 - 对接平台强制变化：Android 16（API 36）起，边到边显示的 opt-out 属性已被弃用并失效，应用无法再选择退出——本技能直接针对这一不可逆的平台级迁移提供官方指导。
- API 稳定、非实验性：迁移过程使用的是稳定 API（
enableEdgeToEdge()等），不依赖 alpha/experimental 版本库，比同仓库内部分仍处实验阶段的技能更适合直接用于生产项目。 - 覆盖规划到验证的完整流程：不止是“加一行代码”，而是给出组件级排查方法论，包含 IME insets、系统栏图标可读性等容易被忽略的细节。
3. 适用场景
固定分类：前端与设计。
适用于使用 Jetpack Compose 构建 Android 应用、需要处理系统栏（状态栏/导航栏）遮挡内容、软键盘弹出时布局错位等具体问题的工程师；尤其适合应用 targetSdk 升级到 Android 16（API 36）后必须完成边到边强制迁移的开发者，也适合刚接触这一系列 API、希望有官方权威范例可依循而非零散排查的初中级 Android 开发者。
4. 跨 Agent 兼容性
- Claude Code：✅ 原生支持（格式兼容）。
android/skills遵循开放的 Agent Skills 标准，官方文档写明兼容任何支持该标准的 AI 工具；技能目录即标准 SKILL.md + YAML frontmatter 结构，可直接复制到.claude/skills/使用。 - Codex：✅ 原生支持（格式兼容）。同一开放标准，Codex 同样原生识别 SKILL.md 格式，手动放置即可使用。
- OpenClaw：❓ 未验证。已抓取的官方文档与仓库页面均未提及该 Agent。
- Hermes Agent：❓ 未验证。同上，抓取材料中无相关信息。
需注意：官方 Android CLI 默认仅为 Gemini 与 Antigravity 自动安装技能（未显式指定 Agent 时），面向 Claude Code / Codex 需手动指定或手动复制，详见第 10 章。
5. 推荐理由
从 Android 16（API 36）开始，边到边显示不再可选——应用无法再通过属性关闭这一行为，处理不当会直接导致内容被系统栏遮挡、软键盘弹出时布局错乱等用户可见的破坏性问题。这份官方 SKILL.md 把规划、实施、验证的完整方法论整理成可供 Agent 直接调用的知识库，且使用的是稳定 API 而非需要额外配置的实验性功能，对正面临这一强制迁移、或刚接触边到边适配的初中级 Android 开发者尤其省心。
6. 评分
| 维度 | 分数 | 说明 |
|---|---|---|
| 受欢迎程度 | 9 | 官方一线机构（Google Android 团队）出品，2026-04 由 Android Developers Blog 公开发布；且 Android 16 强制边到边生效带来广泛独立讨论（官方 migration codelab 之外，另有 Medium、Stackademic 等独立技术文章分析这一平台变化） |
| 可用性 | 8 | 迁移所用 API 稳定、非实验性，三步工作流清晰，Android CLI 一条命令可装；子目录最近一次代码提交为 2026-05-09，处于“近 3 个月有维护”区间靠后段，故未给满分 |
| 安全性 | 9 | 详见下方安全检查清单 |
| 综合 | 8.7 | 三项均值 |
安全检查清单：
| 检查项 | 结果 |
|---|---|
| ① Shell 命令及权限范围 | 仅涉及标准 ./gradlew build 构建验证命令，无需额外权限 |
| ② 运行时联网外发 | 无，不涉及任何数据外发 |
| ③ API Key / 凭据 | 不需要 |
| ④ SKILL.md 与脚本可疑指令 | 已通读 SKILL.md 全文，内容均为 Jetpack Compose 系统栏适配技术文档与代码范例，未发现要求执行越权操作或外发数据的可疑指令 |
| ⑤ 作者/组织信誉 | Google LLC，Android 官方团队，信誉良好 |
| ⑥ License | Apache License 2.0，明确（仓库级） |
| ⑦ 最近维护时间 | SKILL.md frontmatter 标注 2026-04-01，子目录最近一次提交 2026-05-09，仓库整体近期仍在持续发布新版本 |
7. 跟同类 Skills 相比的优势
android/skills 合集仓库中其他官方子技能与本技能的定位差异：
| 名称 | 来源 | 定位 | 与本技能的差异 |
|---|---|---|---|
| edge-to-edge（本推荐） | android/skills | 修复系统栏遮挡、IME insets，适配 Android 16 强制边到边显示 | — |
| navigation-3 | android/skills | Navigation 2→3 迁移 + 全谱系导航模式范例库 | 聚焦导航架构，覆盖面远大于本技能，但不涉及系统栏适配 |
| migrate-xml-views-to-jetpack-compose | android/skills | XML View → Compose 全流程迁移，含视觉回归验证 | 面向整体 UI 框架迁移，边到边适配只是其中可能涉及的一环，不如本技能聚焦 |
| jetpack-compose/adaptive | android/skills | 大屏、可折叠设备的自适应布局 | 解决屏幕尺寸自适应问题，与系统栏遮挡是两类不同的适配需求 |
| styles（jetpack-compose/theming/styles） | android/skills | 将自定义组件迁移到 Compose Styles API 统一主题 | 面向设计系统主题化，且明确标注为 EXPERIMENTAL、需切换到 alpha 版 Compose，稳定性弱于本技能 |
差异化总结：同属 android/skills 的其他子技能各自聚焦导航、迁移、大屏适配、主题化等问题，edge-to-edge 是其中唯一直接对接 Android 16 平台强制变化、且全程使用稳定 API（不要求 alpha 依赖）的一份，适配范围明确、可直接用于生产项目。
8. 用户评价
该技能所属的 android/skills 官方合集于 2026 年 4 月发布，本技能最近一次更新为 2026 年 5 月，目前第三方平台尚无针对该技能本身的具名用户评价。
9. 其他补充
无。
10. 安装使用方式
方式一：Android CLI（官方推荐，一条命令）
android skills add --skill=edge-to-edge --project=.需先安装 Android CLI；未指定 --agent 时默认为 Gemini 与 Antigravity 安装，面向 Claude Code / Codex 需显式使用 --agent 参数指定，具体取值以官方文档为准。
方式二：手动安装（适用于 Claude Code / Codex）
git clone https://github.com/android/skills.git
cp -r skills/system/edge-to-edge <你的项目>/.claude/skills/edge-to-edge复制时需保留 SKILL.md 相对结构。安装后无需重启，Agent 会在识别到“边到边”“系统栏遮挡”“状态栏/导航栏适配”类任务时自动触发，也可按各 Agent 自身语法手动调用。
11. 注意事项
- 技能本身不含独立的自动化测试脚本，迁移正确性依赖开发者自行验证（如运行
./gradlew build确认编译通过，并在真机/模拟器上核查视觉效果）。 - 若项目使用 Scaffold、Material 组件之外的自定义布局，需要手动应用
WindowInsets，具体工作量因项目结构而异。 - OpenClaw、Hermes Agent 兼容性未经验证，使用前建议先在小范围试点。
- 官方 Android CLI 默认只为 Gemini / Antigravity 自动安装，Claude Code / Codex 用户需手动复制或显式指定
--agent参数。