【免费下载链接】kotlin-footgunsBattle-tested agent skills mapping the footguns of Kotlin, Compose Multiplatform and the desktop JVM — mined from a production music app, not from documentation.项目地址https://gitcode.com/gh_mirrors/ko/kotlin-footguns点击查看免费下载kotlin-footguns 是一个经过实战检验的避坑技能库系统覆盖Kotlin、Compose Multiplatform 与桌面 JVM的常见陷阱全部经验来自一款持续生产运营的跨平台音乐应用而非官方文档。本文带你看清它 16 大分组、224 个技能的完整目录并教你 3 步定位法快速找到你当前项目需要的避坑方案。 为什么 kotlin-footguns 值得完整收藏大多数 Kotlin/Android 技能资料是照着 API 文档写的——告诉你接口应该怎么做。而 kotlin-footguns 记录的是另一面这些 API 在生产环境里实际搞砸过什么。它来自 SimpMusic一款自 2023 年 4 月起持续运营的跨平台音乐客户端覆盖 Android、Windows、macOS、Linux 四大平台包含原生媒体引擎绑定、双播放器交叉淡化、真实用户规模的 Room 数据库、三系统桌面打包与签名等绝大多数示例项目碰不到的场景。几个关键数字帮你建立体感指标数据技能总数224 个独立 SKILL.md内容总量27,000 行单文件篇幅60–140 行2 分钟可读完质量流程5 批次流水线 对抗式审查命令逐条实测每个技能文件都遵循统一结构简介工作模式→ Traps陷阱主体部分→ Verifying it如何在你自己的代码库中验证。其中 Traps 是最核心的章节逐个说明技术为什么会失败、以及修复方式。想深入了解写作标准可阅读 skills/writing-agent-skill-house-style/SKILL.md。️ 16大分组kotlin-footguns完整目录清单目录按技术领域划分为 14 个基础分组A–N 2 个增量批次Δ6、Δ7合计 16 大分组分组数量主题典型问题A11桌面 JVM 原生代码JNA 绑定陷阱、内存占用、原生库打包B13桌面打包 / CI / 构建Gradle 配置解析过早、代码签名、CI 不稳定C9KMP 模块结构 / DI / 架构模块拆分、Hilt 迁移 Koin、ViewModel 作用域D18媒体播放引擎双播放器交叉淡化、队列状态机、响度归一化E11数据库 / SQLNOT IN空值陷阱、级联删除顺序、大规模迁移F7Compose 主题 / 配色 / 遮罩调色板提取、强制深色、渐变与 scrimG11Compose 组件与交互拖拽重排、滑动操作行、骨架屏加载H8屏幕 / 导航 / 自适应布局响应式断点、类型安全导航、视差工具栏I8响应式状态StateFlow 合并反转状态、Job 生命周期J7仓库层 / 数据层模式先缓存后网络、TTL 键控缓存、分页契约K8后台任务 / 平台运行时备份 Worker、单实例守护、崩溃上报L12远程 API 消费Ktor 架构、分块下载、重试退避、OAuth 回调M10Kotlin / KMP 工具与语言陷阱JvmName消歧、组合字符、expect/actualN7工程方法 / 纪律判别性实验先行、构建日志自底向上阅读Δ676同步房间、均衡器与配置导入、播放器样式、UI 特效、平台经验多人同步回声防护、曲线编辑、图表不撒谎Δ78v2.0.0 发布冲刺逐字卡拉 OK 歌词、罗马化管线、截图分享A–N 共 140 个加上 Δ676 个与 Δ78 个两个增量批次正好224 个。Δ6 与 Δ7 增量批次长什么样这两个批次是从源项目的后续开发中二次挖掘的覆盖了不少基础分组没涉及的方向同步会话桥接回声防护、加入者追位、播放位置同步10 个通信协议与生命周期单调时钟偏移同步、WebSocket 握手生命周期7 个均衡器与配置导入双引擎一条曲线、预设身份回读10 个双形态屏幕壳/内容分层、动画标志提升11 个诚实的图表自归一化坐标轴、空基线差分7 个时间与统计存储时间戳是本地墙钟、周期快照8 个完整的一行式索引每个技能附主要证据文件都在 CATALOG.md 中。 快速定位避坑方案的 3 步法224 个技能看似很多但结构高度统一定位思路可以标准化。第 1 步按症状判断领域分组先描述你遇到的问题现象而不是纠结技术名词加载转圈盖住了已加载内容 → 响应式状态I数据库查询成功但结果少了行 → 数据库 / SQLE构建报了一个莫名其妙的错误 → 桌面打包 / CIB列表滑动、多选、拖拽手感不对 → Compose 组件G网络请求重试把设备烫热了 → 远程 API 消费L每个分组的关注点见 README.md 中的目录表与上表一致。第 2 步在 CATALOG.md 总索引中检索CATALOG.md 是主索引每个技能一行包含技能名 — 一句话说明 — 主要证据文件。直接全文搜索关键词即可命中比如搜crossfade、StateFlow、NOT IN、retry。第 3 步打开对应的 SKILL.md 精读技能目录结构非常规整skills/技能名/SKILL.md文件夹名就是技能名全小写、连字符分隔的英文关键词因此也能直接在文件系统里搜grep -ril stateflow skills/打开文件后优先读Traps章节失败模式 机械原因 替代做法再用Verifying it章节的命令在自己的代码库中逐条确认。⭐ 新手推荐5 个最通用的必读技能如果你暂时对号不上这几个技能的教训适用面最广技能一句话陷阱适用场景stateflow-conflation-inverts-state一次事件内多次写入合并流会让最后写入成为真相状态直接反转所有用 StateFlow 的屏幕sql-not-in-nullable-trapNOT IN查询可空列时匹配 0 行却照常报告成功所有含空值的数据库查询gradle-config-resolved-too-early报错指向的元凶往往不是真正的元凶桌面项目构建排错cache-then-network先发缓存再发网络只有完全没有缓存时才报 Error数据层设计retry-needs-backoff-and-cap无上限的重试循环会持续占用设备资源所有网络重试逻辑 如何获取 kotlin-footguns方式一克隆仓库推荐先通读目录再挑选git clone https://gitcode.com/gh_mirrors/ko/kotlin-footguns方式二Claude Code 插件安装整包只读托管随仓库更新/plugin marketplace add maxrave-dev/kotlin-footguns /plugin install kotlin-footgunsmaxrave方式三skills CLI 复制为可编辑文件适用于任意编码 Agentnpx skillslatest add maxrave-dev/kotlin-footguns安装器会让你挑选要带走的技能和目标 Agent。无论哪种方式技能只在其description触发条件匹配时才进入上下文批量安装几乎没有成本。两种方式不要同时用否则技能会重复两份。 仓库文件导读文件作用README.md项目概览、分组总览、安装方法、验证流程CATALOG.md主目录224 个技能的一行式索引 证据文件skills/224 个技能文件夹各含一个 SKILL.mdHANDOFF.md项目创建过程的存档了解技能从哪来raw-docs.md / raw-git.md / raw-core.md / raw-handlers.md / raw-ui.md各挖掘通道的原始候选清单约 282 条pipeline-handoffs/挖掘与审查流水线的批次记录LICENSEGPL-3.0与源项目一致总结kotlin-footguns 的价值在于用 224 个经过对抗式验证的实战陷阱换掉你未来的 224 次踩坑。建议的用法是先通读本文的分组目录建立地图遇到问题时用症状 → 分组 → CATALOG 检索 → Traps 精读的 3 步法定位最后用每个技能自带的验证命令在自己的项目里复核。它既是给 AI 编码 Agent 的技能库也是一本人类可读的 Kotlin / Compose 桌面端工程参考书。赞分享【免费下载链接】kotlin-footgunsBattle-tested agent skills mapping the footguns of Kotlin, Compose Multiplatform and the desktop JVM — mined from a production music app, not from documentation.项目地址https://gitcode.com/gh_mirrors/ko/kotlin-footguns点击查看免费下载相关推荐如何快速上手eww16个内置组件box、button、graph、transform、systray完整清单与详解如何快速上手eww16个内置组件box、button、graph、transform、systray完整清单与详解 ! eww 内置组件概览 https://桌面应用什么是kotlin-footguns224个来自10.8k星音乐App的Kotlin实战陷阱Agent Skills完全指南什么是kotlin footguns224个来自10.8k星音乐App的Kotlin实战陷阱Agent Skills完全指南 kotlin footguns如何快速把长视频切出9:16竖版高光video-podcast-maker 短视频 Shorts 工作流完整指南附避坑清单如何快速把长视频切出9:16竖版高光video podcast maker 短视频 Shorts 工作流完整指南附避坑清单 还在为 Bilibili 长视AI 技能媒体生成音视频语音创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
