Codex Kotlin ABI 技能:核对 JVM 与 KLIB 基线改动
EnglishCodex 安装步骤
- 从固定 GitHub 提交复制 `.codex/skills/executables-abi-maintenance/` 完整目录到项目 `.agents/skills/executables-abi-maintenance/`。
- 在 Codex 读取 `AGENTS.md`、`files/build.gradle.kts` 与 `files/api/` 的两份基线。
中文摘要
检查 Executables 项目的公共 API 改动是否匹配 JVM 和 KLIB 基线,以及 Gradle 任务是否覆盖 ABI。
SKILL.md 中文导读
可复现示例
为一个本地演示改动新增公开函数,先执行 `.\gradlew.bat :executables-files:check --dry-run` 检查任务。对照 JVM 和 KLIB 基线,说明预期签名差异。工作步骤
- 先确认改动是否影响公开签名,并检查 Gradle 任务路径。
- 对有意更改的公开 API 审阅基线差异,同时检查 Linux CI 采用的 KLIB 配置。
验收方法
报告写清楚当前任务路径、两个基线的预期变动和仍需在 Linux 环境核对的条件。
GitHub 原文 · 更新日期
适用环境
需要 Executables 工作区、项目 Gradle Wrapper 和适用的 Kotlin 工具链。示例基于本地 Windows PowerShell。
常见问题
只看到 JVM 基线变化就能确认全部吗?
分别检查 JVM、KLIB 输出和 CI 执行条件。需要时用与 CI 一致的目标环境验证。