八大AI编码工具都能接:compose-skill 接入清单与 5 分钟安装教程

原创2026-11-17 22:33:052,272 阅读

八大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 份真实源码兜底。🚀

登录后查看全文
compose-skill