Kotlin 技能包是一个面向 AI 智能体的 Kotlin 语言与工具链参考资料集,内容整理自 kotlinlang.org 官方文档及 kotlinx 相关库文档,按主题分目录存放,便于按任务检索。
用途:当任务涉及 Kotlin 语言语法、标准库、类型系统、面向对象特性、函数与 DSL、集合操作、Java 互操作、协程、序列化、Gradle/Maven 构建配置、编译器与 KSP/kapt 工具链、版本发布与兼容性时,可按映射表定位到对应目录的说明文件,再读取具体页面获取细节。需要可运行示例时查示例目录,需要安装与命令行操作时查脚本目录。
主要能力(按资料记录的目录结构):
- 基础语法:语法、null safety、控制流、异常、KDoc、注解、可见性修饰符等(14 页)。
- 类型系统:数值、字符串、数组、泛型、类型转换、typealias 等(10 页)。
- 类与对象:class、data class、sealed class、接口、扩展、委托属性、object 声明、inline class 等(15 页)。
- 函数相关:函数、lambda、inline 函数、context parameters、类型安全构建器、运算符重载(8 页)。
- 集合:集合概览与操作、Sequence、Range 等(18 页)。
- 标准库补充:作用域函数、opt-in 要求、反射、时间度量、UUID 等(7 页)。
- Java 互操作:Java 与 Kotlin 相互调用、JVM records 等(7 页)。
- 协程:协程基础、Flow、Channel、异常处理等(14 页)。
- 序列化:入门、JSON 配置、多态、ProtoBuf 等(14 页)。
- 构建工具:Gradle 与 Maven 项目配置、编译器选项、Kotlin daemon 等(14 页)。
- 编译器:编译器参考、K2 迁移指南、KSP 概览与快速入门、kapt 等(23 页)。
- 版本发布:各版本新特性、兼容性指南、组件稳定性(10 页)。
- 示例:null safety 模式、sealed class 与 when、作用域函数、结构化并发、Flow 收集与取消、JSON 往返序列化、Gradle JVM 项目等 22 个示例。
- 脚本与命令:安装、kotlinc、Gradle、Maven、Kotlin daemon、KSP、编译器插件等 7 个命令页。
使用方式:从任务到类别的映射表入手,先读对应类别目录的 README 定位目标页面,再读取该页面的 Markdown 文件;需要可运行示例时查示例目录的 README,需要安装与命令行操作时查脚本目录的 README。资料中记录了文档版本信息:Kotlin 2.4.21(languageVersion / apiVersion 2.4),kotlinx.coroutines 1.11.0,kotlinx.serialization 1.11.0,KSP 2.3.10,获取日期为 2026-10-16;原始文档以 JetBrains/kotlin-web-site 的指定 commit 固定,kotlinx.coroutines 以指定 commit 固定,kotlinx.serialization 因 Writerside 源未公开仅有文档副本并以 v1.11.0 标签辅助。已排除 Kotlin 2.5.0-Beta1 与 kotlinx.serialization 1.12.0-RC 等预览版本。
适用场景:为编写、审查或解释 Kotlin 代码的智能体提供权威语言参考;查找协程、序列化、构建配置和编译器工具链的具体用法;需要示例或命令时快速定位。
限制:资料是文档整理而非教程或产品,具体行为与版本细节以官方文档为准;未提供安装步骤以外的额外说明时,相关内容暂未提供;具体 API 细节需查阅对应页面,本介绍不展开。