本文首发于公众号"Android技术圈"
自Android Skill发布之后，Kotlin协程也发布了相关Skill。
是什么
Kotlin Coroutines Skill 是一份开源的 Agent Skill（v2.0.0），隶属于 Structured Coroutines 项目。
你可以把它理解成一本"AI 专用的协程操作手册"：
-
•
SKILL.md：入口文件，包含 Agent 行为契约（身份、严格规则、语气、输出格式）和完整的分诊表（topic/error → 对应参考文件） -
•
references/：32 个 Markdown 文件，每个对应一条实践，结构统一：Bad / Recommended / Why / Quick fix
当 Agent 接收到协程相关的提问或代码 Review 请求时，它会沿着分诊表找到对应的参考文件，按"分析 → 问题代码 → 优化代码 → 技术解释"的固定格式输出。
为什么需要它
AI 写协程代码最常犯的错误，往往不是"不会写"，而是"用了一种看起来能跑但长期有害的写法"。这些错误你可能见过很多次：
这些写法为什么反复出现？因为互联网上大量教程、StackOverflow 回答、甚至官方早期示例里就是这么写的。模型的训练数据里充满了这些"能跑但不推荐"的模式，如果没有一份明确的规范来覆盖它，AI 只会继续复读。
Kotlin Coroutines Skill 的解法是：把正确做法编码成可检索、可触发的结构化文件，让模型在需要时"查手册"而不是"凭印象"。
它覆盖了哪些场景
v2.0.0 包含 32 条实践 和 34 条分诊规则，按 9 个主题组织：
展开来看几个"最容易中招"的：
Scope 与结构化并发
-
•
1.1GlobalScope：直接禁止，改用viewModelScope/lifecycleScope/ 注入的自定义 scope -
•
1.2async 没有 await：异常会被静默丢弃，直到 Deferred 被 GC 才可能暴露 -
•
1.4awaitAll：并发任务应当用coroutineScope { }+awaitAll()而不是逐个 await
取消与异常
-
•
4.2吞掉 CancellationException：你的catch(Exception)可能在默默破坏取消链 -
•
4.6--4.7withTimeout：不处理TimeoutCancellationException会让 scope 被取消------这在嵌套场景下特别隐蔽
测试
-
•
6.1用runTest+ 虚拟时间替换runBlocking+ 真实delay()，否则 CI 会慢且不稳定 -
•
6.3``Dispatchers.setMain/resetMain：Android 单元测试里绑定与清理的标准写法
Flow 与 Android 生命周期
-
•
8.2在lifecycleScope.launch里收集 Flow 但没有repeatOnLifecycle：后台继续收集，白耗资源 -
•
9.1--9.4Flow 的冷/热选型、flowOn 的用法、stateIn 的初始值策略
每条参考文件都是同一个格式：问题代码 → 推荐做法 → 为什么 → 一步修复。
规则清单速览
如果你暂时不想装，也可以先把这份 Quick Checklist 当作团队协程 Review 的最小共识：
写在最后
Agent Skill 这个概念正在从"锦上添花"变成"基础设施"------当你的 AI 工具有了领域专用的规范文件，它的输出质量会显著稳定。
你在用 AI 写 Kotlin 代码时踩过哪些协程的坑？你更希望 Skill 覆盖哪些新场景（Compose、Ktor、KMP）？