1. 基本信息
| 项目 | 内容 |
|---|---|
| 名称 | wear-compose-m3-android-skills |
| 项目自述名称 | wear-compose-m3（SKILL.md frontmatter name 字段） |
| 作者/维护者 | Google LLC（Android 官方团队） |
| 来源链接 | https://github.com/android/skills/tree/main/wear/wear-compose-m3 |
| 许可证 | Apache License 2.0（GitHub API 确认，仓库级） |
| GitHub Stars / Forks | 6,802 / 413（GitHub API；为 android/skills 整个合集仓库数据，不代表本子技能独立热度） |
| 最新版本 | SKILL.md frontmatter last-updated：2026-08-06；该子目录最近一次提交：2026-08-07 |
| 安装方式 | Android CLI 一条命令，或手动复制到对应 Agent 的 skills 目录（详见第 10 章） |
2. 功能介绍与亮点
指导 Agent 在 Wear OS 应用中正确使用 Jetpack Compose Material3 组件库（androidx.wear.compose.material3 / foundation / navigation3），覆盖新建界面、添加新特性、从 Material 2.5 或 Horologist 库迁移三类场景。
亮点：
- 严格版本纪律：强制使用官方认定的最新稳定版（禁止 alpha/beta/rc）；若无内部工具可查询版本，直接抓取 Google 官方 Maven 元数据 XML 确认版本号；遇到“Unresolved reference”报错时明令禁止靠降级版本“修复”，必须先完成 Gradle 同步验证。
- 样例 JAR 强制解压机制：Wear Compose 库自带完整样例 JAR，SKILL.md 明确要求在提出任何非预览类代码改动前，必须先把样例解压到本地缓存，禁止仅凭库源码猜测 API 用法。
- 组件-样例映射总表 + 强制检查清单：SKILL.md 正文逾 4 万字节，配 59 份 references（共约 466KB），为近百个 Material3/Foundation 组件符号各自标注对应官方样例文件；另附一份 13 条的组件用法检查清单（如
ScreenScaffold与TransformingLazyColumn的正确组合、EdgeButton的溢出滚动配置），可直接作为代码审查依据。 - 明确划清弃用边界：禁止使用
ScalingLazyColumn（应改用TransformingLazyColumn）、禁止硬编码颜色/字号（须走MaterialTheme）、禁止使用 Horologist 的 Composable/Layout/Material 库。
3. 适用场景
固定分类：前端与设计。
面向正在为智能手表构建或升级 Wear OS 应用界面的 Android 前端工程师，尤其适合：新建 Wear OS Compose 应用、需遵循官方 Material3 组件规范；已用 Horologist 或旧版 Material 2.5、需要迁移到 M3 的存量项目；以及需要对已有 Wear Compose 代码做规范性审查的团队。
4. 跨 Agent 兼容性
- Claude Code：✅ 原生支持。仓库自带
.claude-plugin/marketplace.json，可用claude plugin install android-skills@android-skills一键安装。 - Codex：✅ 官方确认支持。SKILL.md 为通用 Agent Skills 开放标准格式（YAML frontmatter + Markdown 正文），OpenAI Codex CLI 原生支持该标准，技能可直接放入
~/.agents/skills/使用。 - OpenClaw：⚠️ 未经本技能专门验证；SKILL.md 格式本身通用，理论可复制使用，但仓库自带的一键安装机制为 Claude Code 插件市场专用。
- Hermes Agent：❓ 未经本技能专门验证。
5. 推荐理由
Wear OS Compose Material3 从早期版本、Material 2.5 乃至 Horologist 库迁移到位，涉及大量组件级别的破坏性变更（如 ScalingLazyColumn → TransformingLazyColumn），仅凭模型自身训练知识很容易给出过时或不兼容的代码。这份官方技能用“强制最新稳定版、禁止靠降级修复报错”的版本纪律、样例 JAR 强制解压后再编码的求证机制，以及覆盖近百个 API 符号的组件-样例映射表，把 Agent 的输出锚定在官方当前真实可用的 API 上。13 条强制检查清单进一步把“用对组件”从经验判断变成可核对的标准，适合团队在代码审查环节直接引用。
6. 评分
| 维度 | 分数 | 说明 |
|---|---|---|
| 受欢迎程度 | 7 | Google LLC（Android 官方团队）出品，属官方保底档；仓库 6,802 stars 为 android/skills 整个合集数据，不代表本子技能独立热度；本子技能自身可核实的独立第三方证据为第 8 章列出的 2 条 GitHub issue 真实互动，尚未见更广泛的独立讨论，故不高于保底档 |
| 可用性 | 8 | 一条 CLI 命令或手动复制即用；SKILL.md 正文逾 4 万字节 + 59 份 references（共约 466KB），组件-样例映射极其完整；明确要求仅用稳定版依赖，无付费依赖；该子目录 2026-08-07 有提交，近一个月内历经至少 5 次修订，两起真实社区 bug 报告均已修复；唯一的额外步骤是使用前须解压样例 JAR 到本地缓存，故未打满分 |
| 安全性 | 9 | 详见下方安全检查清单 |
| 综合 | 8.0 | 三项均值 |
安全检查清单：
| 检查项 | 结果 |
|---|---|
| ① Shell 命令及权限范围 | 无需执行 shell 命令；仅指导读取本地 gradle/libs.versions.toml 等配置文件，且明确禁止运行 ./gradlew dependencies 等命令解析版本 |
| ② 运行时联网外发 | 仅在无内部版本查询工具时，读取 Google 官方 Maven 元数据 XML（dl.google.com）确认最新稳定版本号，不涉及任何用户数据外发 |
| ③ API Key / 凭据 | 不需要 |
| ④ SKILL.md 与脚本可疑指令 | 已通读 SKILL.md 全文（40KB）及 59 份 references 目录列表，内容均为 Wear Compose 官方 API 规范与样例代码，未发现越权指令或夹带与任务无关的推广内容 |
| ⑤ 作者/组织信誉 | Google LLC，Android 官方团队，Wear Compose 库本身即由该团队维护 |
| ⑥ License | Apache License 2.0，明确 |
| ⑦ 最近维护时间 | 该子目录 2026-08-07 有提交，近一个月内多次修订，非弃置项目 |
7. 跟同类 Skills 相比的优势
| 名称 | 来源 | 定位 | 与本技能的差异 |
|---|---|---|---|
| wear-compose-m3（本推荐） | android/skills | 专注 Wear OS Compose Material3 组件规范、版本纪律与代码审查清单 | — |
| aldefy/compose-skill | 独立开发者仓库 | 覆盖 Android/Desktop/iOS/Web 全平台 Compose，引用 androidx/androidx 真实源码作佐证 | 面向通用 Compose 开发，不含 Wear OS 专属的组件-样例映射，也不涉及 Ambient 模式、旋转表冠输入等手表专属指导 |
| adaptive-android-skills | 同合集内 android/skills | 让 Compose 应用适配手机/平板/折叠屏/桌面/TV/XR 等多种窗口尺寸 | 解决的是“同一套 UI 如何跨设备形态自适应”，与本技能“如何在 Wear OS 这一种设备形态内正确使用 M3 组件”是互补关系而非替代 |
| Horologist（google/horologist） | Google 开源库本身 | Wear OS 早期 Compose 辅助库，涵盖 Media、Health、Network 等场景组件 | 本技能 SKILL.md 明确将其列为迁移起点而非并行选项，指导 Agent 把 Horologist 的 Composable/Layout/Material 替换为官方 M3 组件 |
8. 用户评价
- GitHub 用户 saadkhalidkhan 实际 fork 仓库并测试了包括本技能（原名
wear/jetpack-compose-m3）在内的多个技能，在 issue #49 中指出其 Prerequisite 章节存在语句被截断的问题，可能导致 Agent 跳过强制样例解压步骤，并提交了修复分支（来源：github.com/android/skills/issues/49）。 - GitHub 用户 ezrareeves 在 issue #112 中发现仓库插件清单
marketplace.json里本技能路径拼写错误（误写为改名前的旧路径），导致整个 android-skills 插件（全部 20 个技能）加载失败；该用户通过对比两次提交记录定位到问题根源为改名后清单未同步更新，问题已修复（来源：github.com/android/skills/issues/112）。
9. 其他补充
无。
10. 安装使用方式
方式一：Android CLI（官方推荐，一条命令）
android skills add --skill=wear-compose-m3 --project=.需先安装 Android CLI；未指定 --agent 时默认为 Gemini 与 Antigravity 自动安装，面向 Claude Code / Codex 需显式使用 --agent 参数指定。
方式二：Claude Code 插件市场
/plugin marketplace add android/skills
/plugin install android-skills@android-skills方式三：手动安装（适用于任意遵循 Agent Skills 标准的 Agent）
git clone https://github.com/android/skills.git
cp -r skills/wear/wear-compose-m3 <你的项目>/.claude/skills/wear-compose-m3复制时需保留 SKILL.md 与 references/ 目录的相对路径结构（59 份样例文件均以相对路径被正文引用）。安装后无需重启，Agent 会在识别到“Wear OS”“Compose Material3 手表”“AppScaffold/ScreenScaffold”等任务时自动触发。
11. 注意事项
- 使用前建议按 SKILL.md 要求解压 Wear Compose 库自带的样例 JAR 到本地缓存，否则 Agent 可能仅凭库源码猜测 API 用法。
- 明确禁止使用 Horologist 的 Composable/Layout/Material 与旧版
androidx.compose.material（M2）库，迁移期项目需先完成 M3 切换。 - 仓库插件清单此前发生过路径拼写错误导致全部 20 个技能加载失败的问题（已修复），安装后建议执行
claude plugin list确认加载状态正常。 - OpenClaw、Hermes Agent 的兼容性未经本技能专门验证，使用前建议先小范围试点。