八大AI编码工具都能接:compose-skill 接入清单与 5 分钟安装教程
八大AI编码工具都能接:compose-skill 接入清单与 5 分钟安装教程
如果你在用 Codex CLI、Gemini CLI、Cursor、Copilot 等 AI 编码工具写 Jetpack Compose 代码,那么 compose-skill 值得安装。这是一个专为 Compose 开发的 Agent Skill:它把 35 份专家级参考指南和 6 份来自 androidx/androidx 官方源码的"证据文件"注入你的 AI 工具,让 AI 从"靠猜"变成"有据可查",覆盖 Android、Desktop、iOS、Web 四大平台的 Compose 与 Compose Multiplatform。
一、为什么 AI 写的 Compose 代码总差一口气?
没有 compose-skill 时,AI 工具常见的翻车现场:
remember { mutableStateOf(0) }写在组合体内,每次重组状态就被重置;- 字符串路由的旧版 Navigation 写法(已不推荐);
Modifier顺序乱排、padding和clickable位置颠倒;- 甚至"幻觉"出不存在的 API 参数。
装上 compose-skill 后,AI 会先读 SKILL.md 中的工作流与检查清单,再按 Quick Routing 路由表精确定位到对应的参考文件(如状态管理、性能、导航),拿不准时还会翻 references/source-code/ 里的真实源码签名。同一个"加个计数器"的提示词,装前写出的代码每次重组都归零,装后用 remember { mutableIntStateOf(0) } 并规避了装箱——差异就来自这种源码级 grounding。
💡 一句话:compose-skill 让 AI 回答 Compose 问题时"先查资料再开口"。
二、八大 AI 工具接入清单
compose-skill 本质就是一组 Markdown 文件,因此几乎零成本接入各种工具。以下是完整清单:
| # | AI 工具 | 接入方式 | 难度 | 是否支持一键更新 |
|---|---|---|---|---|
| 1 | Claude Code | 插件市场安装 | ⭐ 极简 | ✅ /plugin update |
| 2 | GitHub Copilot CLI | copilot plugin install |
⭐ 极简 | ✅ copilot plugin update |
| 3 | Codex CLI | clone + 符号链接 | ⭐⭐ 手动 | ⚠️ 需 git pull |
| 4 | Gemini CLI | GEMINI.md 指令 + submodule |
⭐⭐ 手动 | ⚠️ 需 git pull |
| 5 | Google Antigravity | 复制到 skills 目录 | ⭐⭐ 手动 | ⚠️ 需重新复制 |
| 6 | Cursor | .cursor/rules 规则文件 |
⭐⭐ 手动 | ⚠️ 需手动同步 |
| 7 | GitHub Copilot | copilot-instructions.md |
⭐⭐ 手动 | ⚠️ 需手动同步 |
| 8 | Windsurf | .windsurf/rules 规则文件 |
⭐⭐ 手动 | ⚠️ 需手动同步 |
| 附 | Amazon Q Developer | .amazonq/rules 规则文件 |
⭐⭐ 手动 | ⚠️ 需手动同步 |
📌 完整说明见 docs/INSTALL.md,各工具的原理差异见 README.md 的 Setup 章节。
三、各工具安装步骤
1. Claude Code:插件一条命令搞定
在 Claude Code 里执行:
/plugin marketplace add aldefy/compose-skill
/plugin install compose-expert
新版本可直接用一行:/plugin install compose-expert --marketplace aldefy/compose-skill。后续用 /plugin update 更新。
也可以手动方式把技能放入 ~/.claude/skills/(个人级)或项目的 .claude/skills/(项目级),Claude Code 会自动发现并触发,无需任何配置文件。
2. GitHub Copilot CLI:插件安装
copilot plugin install aldefy/compose-skill
更新:copilot plugin update aldefy/compose-skill。
3. Codex CLI:clone + 符号链接
Codex 暂无原生插件系统,手动接入:
git clone https://gitcode.com/gh_mirrors/co/compose-skill ~/.codex/skills-src/compose-skill
ln -s ~/.codex/skills-src/compose-skill/skills/compose-expert ~/.codex/skills/compose-expert
更新时进入 ~/.codex/skills-src/compose-skill 执行 git pull 即可。
另一种项目级玩法:在仓库根目录加 AGENTS.md,指向 skills/compose-expert/SKILL.md,再 git submodule add https://gitcode.com/gh_mirrors/co/compose-skill .compose-skill。Codex 会自动发现 AGENTS.md。
4. Gemini CLI:GEMINI.md 路由指令
在项目根目录创建 GEMINI.md,核心是告诉 AI 按主题查对应参考文件,例如:
- State management →
skills/compose-expert/references/state-management.md - Performance →
skills/compose-expert/references/performance.md - Navigation →
skills/compose-expert/references/navigation.md
再通过 submodule 引入技能目录:
git submodule add https://gitcode.com/gh_mirrors/co/compose-skill .compose-skill
5. Google Antigravity:直接复制技能目录
Antigravity 会自动发现包含 SKILL.md 的技能目录:
git clone https://gitcode.com/gh_mirrors/co/compose-skill /tmp/compose-skill
mkdir -p .agents/skills
cp -r /tmp/compose-skill/skills/compose-expert .agents/skills/compose-expert
想全局可用则复制到 ~/.gemini/antigravity/skills/ 下。
6. Cursor:规则文件一步到位
创建 .cursor/rules/compose-skill.mdc,内容为一段简短指令:遵循 skills/compose-expert/SKILL.md 的流程,回答前先查 skills/compose-expert/references/。或者更省事——直接把 SKILL.md 全文粘贴到 Settings > Rules for AI。
7. GitHub Copilot:项目级指令文件
创建 .github/copilot-instructions.md,写一段指引:所有 Compose/Android UI 任务遵循 skills/compose-expert/SKILL.md,并从 skills/compose-expert/references/ 查阅模式、坑点与源码级依据。
8. Windsurf:规则文件
创建 .windsurf/rules/compose-skill.md(旧版 .windsurfrules 也兼容),内容同样是"遵循 SKILL.md 工作流 + 回答前查 references"。
附:Amazon Q Developer 用法类似,在
.amazonq/rules/compose.md中写同样的指引即可。
四、更新与迁移:别停留在旧安装路径
⚠️ 如果你还是老版(v2.1.0 之前)手动复制文件的方式安装的,该路径不再接收更新。判断方法:打开你复制的 SKILL.md,看 frontmatter 是否有 version: 字段(当前版本为 2.5.2)。没有就需要迁移:
- Claude Code:删除旧目录后执行
/plugin marketplace add+/plugin install - Copilot CLI:删除
~/.copilot/skills/compose-expert后重新copilot plugin install - Codex CLI:删除旧副本,按上文手动方式重装
完整迁移步骤见 docs/MIGRATION.md。迁移的好处:自动更新通知、每个版本的破坏性变更说明、版本可回滚。
五、装完之后,AI 能帮你做什么?
技能内置两层内容:
第 1 层:35 份参考指南(位于 skills/compose-expert/references/),覆盖:
- 🧠 状态管理、副作用、重组与性能
- 🧭 类型安全导航、Nav 2 → Nav 3 迁移、Paging 3
- 🎬 动画、M3 动效 Token、现代图形与 AGSL 着色器
- 📱 多平台(Desktop/iOS/Web)、Android TV、Wear OS、Android XR、Android Auto、Media3
- 🩺 生产级崩溃手册、PR 评审模式、设计稿转 Compose
第 2 层:6 份源码收据(位于 references/source-code/),包括 runtime、ui、foundation、material3、navigation、CMP 的真实 Kotlin 源码,AI 需要验证实现细节时直接引用,不靠猜。
装好后不用换说话方式,直接说"我的 LazyColumn 滚动卡顿,帮我修"即可。AI 会依次读工作流 → 拉取 lists-scrolling.md 与 performance.md → 检查缺失的 key {}、不稳定项类型 → 必要时核对 foundation-source.md 里的真实 LazyList 实现。
六、常见问题
Q:装 skill 会影响 AI 的响应速度吗? 不会。技能按"信号路由"加载:只在你提到 Compose 相关话题时才读取对应文件,一次只读 1-2 份参考,不是把所有内容塞进上下文。
Q:不写 Kotlin 也能用吗? 可以。只要你的 AI 工具支持自定义指令(规则文件、AGENTS.md、插件),任何 Compose 场景都适用,包括 Android TV 大屏、手表、车载等场景。
Q:技能内容会持续更新吗? 会。项目跟进 Compose/CMP 新发布(如 2.5.0 版本覆盖了 Android Dev Summit 2026 的新特性),更新日志见 CHANGELOG.md。
七、总结
| 工具 | 推荐路径 | 关键文件 |
|---|---|---|
| Claude Code | 插件市场 | /plugin install compose-expert |
| Copilot CLI | 插件命令 | copilot plugin install |
| Codex CLI | clone + 符号链接 | docs/INSTALL.md |
| Gemini CLI / Cursor / Copilot / Windsurf | 指令文件 | GEMINI.md、.cursor/rules、.github/copilot-instructions.md、.windsurf/rules |
compose-skill 的核心价值只有一条:让 AI 用官方源码说话,而不是凭印象写 Compose。挑你正在用的工具,按上表 5 分钟接入,之后每一次 remember、LazyColumn、NavHost 的问答,背后都有 35 份指南和 6 份真实源码兜底。🚀