224 个 Kotlin 翻车实录，被他打包成 Claude Skill 直接喂 AI

我刷到一个 Skill 包，打开 README 愣了三秒。

224 份 Markdown，27,000 行，每一份都是「Kotlin/Compose 多平台踩过的坑」——而且全部从一个叫 SimpMusic 的真实生产 app 里挖出来的，不是从官方文档抄的。

23 岁开发者 maxrave，独自维护一个跨平台音乐客户端三年，没有 mentor、没有 code review，所有 bug 全靠自己啃。三年下来攒了 224 个真实的翻车记录，每个都按这个结构写：

什么会出错 → 为什么会错 → 在你自己代码里验证的命令

这玩意儿叫 kotlin-footguns。

为什么它值得装

市面上大部分 Kotlin/AI Agent Skill 都是从官方文档「总结」出来的——告诉 Claude API 该怎么用。

但这个包记录的是「API 告诉你成功了，其实把你的数据悄悄丢了」「这个 build flag 在 Mac 上是一个意思，在 Linux 上是另一个」「这个 verification step 在坏代码上也能通过」这种真实踩过的雷。

每一条「经验」背后都是一次 crash report、一次失败发布、一轮 review、一个用户提的 issue。是已经付过学费的，不是纸上谈兵。

适合谁

• 在做 Android / Compose Multiplatform / 桌面 JVM 项目
• 给 Claude Code 开了 Kotlin/Compose 任务权限，不想让它瞎跑
• 团队里有 junior Kotlin 开发者，需要一份「生产级避坑清单」

怎么装

一行命令：

npx skills add maxrave-dev/kotlin-footguns

装好后 Claude 会在涉及 Kotlin/Compose 任务时，按需拉取对应的 SKILL.md。SkillHub 上给它打了 S 级（Grade S · 9.1）。

一点看法

这种 Skill 才是 Agent 时代真正稀缺的——不是文档搬运，而是第一手失败经验的沉淀。GitHub star 11k 的 SimpMusic 是它的背书；224 份文档是它的弹药库。

如果你玩 Kotlin，别错过。

GitHub：https://github.com/maxrave-dev/kotlin-footguns

GitHub: https://github.com/maxrave-dev/kotlin-footguns