1. 基本信息
| 项目 | 内容 | 数据来源 |
|---|---|---|
| 名称 | compose-skill | — |
| 项目自述名称 | Compose Agent Skill | GitHub README |
| 作者/维护者 | aldefy（Adit Lal，个人开发者） | GitHub API |
| 来源链接 | https://github.com/aldefy/compose-skill | — |
| 许可证 | MIT | GitHub API + LICENSE 原文核对 |
| GitHub Stars | 540 | GitHub API |
| Forks | 33 | GitHub API |
| 最新版本 | v2.4.0（发布于 2026-07-08） | GitHub Releases |
| 安装方式 | Claude Code：/plugin marketplace add aldefy/compose-skill + /plugin install compose-expert |
官方 README/INSTALL.md |
2. 功能介绍与亮点
Compose Skill 让 AI 编程工具真正理解 Jetpack Compose 与 Compose Multiplatform，覆盖 Android、Desktop、iOS、Web 四端。它由两层材料构成：
- 24 份分主题参考文档：状态管理（
remember/derivedStateOf/rememberSaveable）、性能与重组、类型安全导航（含 Nav 2 → Nav 3 迁移决策指南）、动画与手势、Paging 3（含离线优先与 MVI 测试模式）、无障碍、Compose Multiplatform 架构、Android TV（D-pad/焦点系统）、Material 3 Motion 全部时长与缓动 token、原子设计体系、设计稿转代码工作流，以及一份归纳 6 类真实生产崩溃模式的排查手册。 - 6 份直接摘取自
androidx/androidx与JetBrains/compose-multiplatform-core的真实源码文件：当 agent 需要核实某个 API 的真实行为而非“猜测”时，可直接查阅官方源码，而不是凭训练记忆生成可能过时或幻觉的用法。
亮点还包括：自动在 GitHub PR 链接与“review this PR”等短语上激活专门的 Review Mode；在 session_start 时自动侦测 Compose 项目；配套一套 verify-claims CI 机制，把参考文档里的技术断言转成可执行的 Robolectric 测试，持续验证文档内容与真实框架行为一致。
3. 适用场景
所属分类：工程效率与代码质量
适合使用 AI 编程工具（如 Claude Code、Codex CLI 等）开发 Jetpack Compose 或 Compose Multiplatform 界面的开发者，尤其是需要正确处理状态管理、避免不必要重组、实现类型安全导航、适配 Android TV 或跨平台（Desktop/iOS/Web）差异等细节场景；也适合在 Code Review 环节让 agent 按同一套标准检查 Compose PR。
4. 跨 Agent 兼容性
- Claude Code：原生支持——以插件形式分发，
/plugin marketplace add+/plugin install一键安装并可/plugin update升级 - Codex：支持，需手动安装——官方 INSTALL.md 给出明确步骤（
git clone到~/.codex/skills-src/后建软链接到~/.codex/skills/），无原生插件系统与自动更新通道 - OpenClaw：未验证——未见相关材料
- Hermes Agent：未验证——未见相关材料
（此外该 skill 还为 Copilot CLI、Gemini CLI、Cursor、Google Antigravity 分别提供了安装说明，覆盖面超出本报告固定考察的四个生态。）
5. 推荐理由
AI 编程工具生成 Compose 代码时常见的问题是：能编译但细节不对——用错 remember/derivedStateOf、误判重组稳定性、破坏 Modifier 顺序、使用已废弃的导航模式，甚至直接编出不存在的 API。这个 skill 用 24 份结构化参考文档加 6 份真实 androidx 源码，把“猜行为”变成“查真实实现”，覆盖面从状态管理、性能一路延伸到 TV、多平台与设计转代码等长尾场景。已有多名与作者身份不同的外部开发者提交了 Android TV 参考指南、Google Antigravity 安装说明等实质性内容并被合并，说明这不是自娱自乐的个人笔记，而是有真实开发者在用、在补充。
6. 评分
| 维度 | 分数 | 说明 |
|---|---|---|
| 受欢迎程度 | 7 | 540 stars / 33 forks，处于中等星数区间；但 issue 与已合并 PR 中出现至少 6 位与作者身份不同的独立用户（含功能贡献、文档改进、bug 报告），显示存在真实第三方使用与回馈，而非仅作者自用 |
| 可用性 | 9 | 面向 Claude Code 一条命令即可安装；文档体系完整（24 份参考文档 + 6 份源码文件 + 独立 INSTALL/MIGRATION 文档）；近期（2026-07-08）仍在发布新版本；不依赖任何付费服务 |
| 安全性 | 9 | 见下方检查清单 |
安全检查清单：
- shell 命令执行范围：skill 本体是给 agent 阅读的参考文档与源码片段，运行时不执行任何脚本；仓库自带的 shell/bats 脚本仅用于仓库自身 CI（校验 SKILL.md 长度、插件清单格式等），不随 skill 分发触达最终用户
- 联网外发：skill 运行时不发起任何网络请求
- API key/凭据：不需要任何 API key 或凭据
- 可疑指令：抓取阅读 SKILL.md 全文及核心参考文档，未发现面向 AI 助手的可疑指令或数据外发企图
- 作者信誉：作者为具名个人开发者，提交记录以真实功能/文档/CI 改动为主，已有多名外部贡献者的 PR 被合并，未见刷星或 SEO 操纵措辞
- License：MIT，已核对仓库内 LICENSE 原文，明确
- 最近维护：最近一次版本发布为 2026-07-08（v2.4.0），提交活跃
7. 跟同类 Skills 相比的优势
| Skill | 定位 | 与本 skill 的差异 |
|---|---|---|
| android/skills 仓库下的 migrate-xml-views-to-jetpack-compose、navigation-3、edge-to-edge 等子技能 | Google Android 团队官方出品，各自聚焦单一迁移或特性任务（如把 XML View 迁移到 Compose、Navigation 3 专项、边到边显示） | 官方仓库按具体任务拆成多个窄范围子技能，各自只覆盖对应主题；本 skill 是覆盖状态管理/性能/导航/动画/测试/TV/多平台的常驻型全谱系专家参考，并额外提供 androidx 真实源码用于核实实现细节 |
| claude-android-skill（dpconde/claude-android-skill） | 面向 Android 应用整体最佳实践的通用 skill，覆盖架构、依赖注入等更宽泛话题 | 定位更宽泛但不专注 Compose 细节，且自 2025 年底发布后未见后续版本更新；本 skill 专注 Compose/Compose Multiplatform 单一技术栈但覆盖深度更高，并保持持续版本迭代 |
8. 用户评价
开发者 coreypett-cube 在 GitHub Issue #12 中报告：在 .codex/skills/ 路径下安装后，Codex 提示 “SKILL.md invalid description: exceeds maximum length of 1024 characters”；另一位用户 HumboShot 跟帖确认在 Copilot CLI 上遇到同样的报错；作者 aldefy 当天确认复现并提交修复。开发者 tariqinaam 则直接贡献了一份完整的 Android TV（Compose for TV）参考指南 PR 并被合并，为该 skill 补齐了 TV Material3 组件、焦点系统与 D-pad 导航的覆盖。
9. 其他补充
仓库同时维护面向 Copilot CLI、Gemini CLI、Cursor、Google Antigravity 等更多 AI 编程工具的安装说明，各安装路径的贡献部分来自外部开发者的 PR（如 Google Antigravity 安装说明由用户 ankur141295 提交）。项目配套 verify-claims CI 机制，将部分参考文档中的技术断言转成可编译执行的 Robolectric 测试用例，在每次提交时自动核验文档描述与真实 Compose 行为是否一致。
10. 安装使用方式
- Claude Code（推荐）：
/plugin marketplace add aldefy/compose-skill，再执行/plugin install compose-expert；后续用/plugin update升级 - Codex CLI：
git clone https://github.com/aldefy/compose-skill ~/.codex/skills-src/compose-skill，再软链接~/.codex/skills-src/compose-skill/skills/compose-expert到~/.codex/skills/compose-expert；更新需自行git pull - Copilot CLI：
copilot plugin install aldefy/compose-skill - 安装后无需重启；当对话中出现
@Composable、remember、NavHost、Compose Multiplatform、Android TV 等相关关键词，或粘贴 GitHub PR 链接触发 Review Mode 时会自动加载
11. 注意事项
- Codex CLI 与 Copilot CLI 上曾出现 SKILL.md 描述字段超出 1024 字符上限导致安装报错的问题，作者已修复，但升级到旧版本的用户如遇到同类报错可参考 Issue #12
- OpenClaw、Hermes Agent 上的兼容性未见官方材料说明，需自行验证
- 早期通过手动复制文件安装到
~/.claude/skills/的用户不会再收到更新，官方建议迁移到插件安装方式（见仓库内 MIGRATION.md）