kotlin-footguns 是什么?从生产音乐应用提炼的 Kotlin 与 Compose 踩坑集

中文导读

kotlin-footguns 是开源项目,站内分类为 AI 智能体。简介:从生产音乐应用提炼的 Kotlin 与 Compose 踩坑集。项目说明中列出的主要功能包括:224 个从生产代码库提炼的 Kotlin/Compose 陷阱，按九个领域技能组织；每个陷阱文件包含失败模式、验证方法和修复建议；footgun-scan 扫描器可检查代码变更并关联到具体陷阱。使用 Kotlin、Compose Multiplatform 或桌面 JVM 的开发者，以及希望为编码代理补充实战经验的 AI 代理用户。

根据 GitHub 公开数据,该项目的编程语言为 Python,开源协议为 GPL-3.0,创建于 2026-08-20,最近更新于 2026-10-15,目前有 1,332 个 Star。

项目介绍

kotlin-footguns 是一个面向 AI 编码代理的技能集合，收录了 224 个在 Kotlin、Compose Multiplatform 和桌面 JVM 开发中真实遇到的陷阱。这些内容并非来自官方文档，而是从作者维护的跨平台音乐应用 SimpMusic 的生产代码库中提炼而来，每个陷阱都对应实际发生过的崩溃、发布失败或用户反馈。

项目将陷阱按领域组织成九个技能，每个技能是一个索引，每个陷阱是独立的 Markdown 文件。代理在遇到相关工作时可以打开对应文件，人类开发者也能直接阅读。此外还提供一个扫描器 footgun-scan，用 32 个模式检查代码变更是否触及相关陷阱。

主要功能

• 224 个从生产代码库提炼的 Kotlin/Compose 陷阱，按九个领域技能组织
• 每个陷阱文件包含失败模式、验证方法和修复建议
• footgun-scan 扫描器可检查代码变更并关联到具体陷阱
• 兼容 Claude Code 等支持 agent-skills 格式的编码代理
• 提供 evals 评估用例，对比有无插件时的代理表现

适合谁用

使用 Kotlin、Compose Multiplatform 或桌面 JVM 的开发者，以及希望为编码代理补充实战经验的 AI 代理用户。

快速上手

1. 将仓库克隆到本地或作为 Claude Code 插件安装
2. 在代理中按领域打开对应的技能文件，例如 skills/desktop-and-build-footguns/SKILL.md
3. 运行扫描器检查代码变更：python3 .claude/skills/footgun-scan/scripts/scan.py --base origin/main --fail

Star 增长趋势

同类项目