Kotlin AI Agent 技能库
为 Kotlin 项目提供一套遵循 Agent Skills 标准的现成技能包，让编码代理掌握后端框架与构建工具的正确用法。
证据仅包含 README、LICENSE 与 CI 工作流，未提供任何 SKILL.md 或脚本内容，技能实际执行什么指令、是否要求最小权限、是否需要用户确认、如何处理敏感数据均无从验证，故各信任准则仅给 1（仅由 '纯指令型技能' 的性质间接推断，缺乏直接支持）；rollback 为 0，仓库无任何回滚/卸载说明。source_attribution 给 2：工作流注明了源自 Corey Haines 的出处，README 标注 JetBrains incubator 徽章，但 LICENSE 版权行仍是未填写的模板占位符，扣 1 分。
无任何技能内容、测试或校验输出可评估一致性；唯一可见的可靠性机制是 validate-skills.yml CI（目录命名与第三方 validate-skill@v1 校验），故三项均给 1：仅有间接、未经执行的佐证。工作流依赖外部 Action 'Flash-Brew-Digital/validate-skill@v1' 与 'ubuntu-slim'，可用性与该第三方 Action 的供应链风险在静态审查中无法核实。
受众与场景描述较清楚（面向 Kotlin 项目，分 backend/tooling 类别），环境适配含多种安装方式（skills CLI、Claude Code、Codex、手动复制），给 2；但 capability_boundaries 与 trigger_precision 完全依赖未提供的 SKILL.md frontmatter（name/description），证据中无法确认触发描述是否精确、边界是否声明，各给 1。
install_notes 给 3：README 覆盖三种官方 CLI 安装方式加手动复制，命令完整。license 给 3：Apache-2.0 全文在库。information_architecture 与 naming_stability 给 2：目录布局与命名规范有文档且有 CI 强制校验，但 CATEGORIES 文件本身未提供。examples_and_faq、known_limitations 给 1：无 FAQ、无已知限制章节。versioning_changelog 为 0：无版本号、无 changelog、无 release 约定。maintenance_responsibility 给 1：仅有 CONTRIBUTING.md 的引用，责任人与更新路径未在证据中体现。
无任何技能正文或输出样例可评估输出可用性；marginal_value 仅是 README 的断言（'对 Kotlin 项目有用'），未见具体技能内容佐证；cost_benefit 因无法估算运行成本或收益，均给 1。
fact_inference_separation 给 2：README 对事实（安装命令、目录结构）与机制描述区分尚清楚，未混入夸大宣传；claim_traceability 给 1：'遵循 agentskills.io 标准' 仅一条外链，无本地规格对照；cross_source_corroboration 给 1：安装命令与第三方 CLI 文档的对应关系无法在静态证据中核实，且未提供技能文件使 README 声明与内容交叉验证不可行。
- 本次审查未包含任何 SKILL.md 或脚本文件，技能实际指令内容未经验证——安装前请自行阅读每个技能的 SKILL.md，确认其不要求过度权限或外发数据。
- CI 依赖第三方 Action 'Flash-Brew-Digital/validate-skill@v1'，属于供应链风险点，建议固定到完整 commit SHA。
- LICENSE 文件的版权行仍是 '[yyyy] [name of copyright owner]' 占位符，未正式填写。
- 仓库无版本号、无 changelog，难以锁定或回溯已安装技能的具体内容。
- 发布者在企业注册表中未经验证，身份视为未知；请勿仅凭 Kotlin/JetBrains 组织名推断安全性。
这个 Agent 能做什么，适合哪些场景？
Kotlin/kotlin-agent-skills 是 Kotlin 官方组织在 GitHub 上发布的技能集合，面向使用 Kotlin 语言的 AI 编码代理项目。仓库中的每个技能是一个自包含文件夹，包含 SKILL.md（带 YAML frontmatter 的名称与描述）以及指导代理的具体内容，遵循 agentskills.io 定义的 Agent Skills 标准。技能按命名规范 kotlin-<category>-<functional-name> 组织，当前类别包括 backend（服务端开发，如 Spring、JPA 等框架在 Kotlin 中的正确使用）和 tooling（构建工具等）。安装方式覆盖 skills CLI（npx skills add）、Claude Code 插件市场、Codex 插件市场以及手动复制文件夹到 .claude/skills/ 等代理技能目录。项目采用 Apache-2.0 许可证，目前处于孵化阶段，新增技能类别需通过 issue 提议。
仓库提供一组可安装的技能文件夹：每个技能包含 SKILL.md，其中 YAML frontmatter 声明 name 和 description，正文给出编码代理在该技能激活时应遵循的指导。例如 README 中出现的 kotlin-tooling-agp9-migration 技能用于构建工具相关迁移场景。用户可通过 npx skills add Kotlin/kotlin-agent-skills 安装技能，或在 Claude Code 中执行 claude plugin marketplace add Kotlin/kotlin-agent-skills 和 claude plugin install kotlin-agent-skills@Kotlin，或在 Codex 中添加市场并经 /plugins 菜单安装插件，也可直接 cp -r skills/<技能名> .claude/skills/ 手动部署。技能全部存放于仓库的 skills/ 目录。
- 使用 Kotlin + Spring/JPA 的后端开发者，希望编码代理按 Kotlin 惯用方式正确使用这些框架，可安装 backend 类技能
- 负责 Android 项目从 AGP 旧版本迁移到 AGP 9 的工程师，可安装 kotlin-tooling-agp9-migration 技能获得迁移指导
- 使用 Claude Code 的团队，通过插件市场一键安装整套 Kotlin 技能
- 使用 Codex 的开发者，通过 marketplace add 加命令行 /plugins 安装插件
- 自维护代理环境的用户，直接复制 skills/ 下所需技能文件夹到 .claude/skills/
- 希望贡献新技能或新增类别（如新的 backend/tooling 子领域）的 Kotlin 社区成员，通过 issue 提议
这个 Agent 有哪些优点和局限？
- 遵循开放 Agent Skills 标准（agentskills.io），不绑定单一代理产品，Claude Code、Codex、skills CLI、手动复制多条安装路径
- 由 Kotlin 官方组织维护并有明确命名规范 kotlin-<category>-<functional-name>，类别划分（backend/tooling）清晰，便于检索与贡献
- 技能为自包含文件夹（SKILL.md + 资源），可按需挑选单个技能安装，例如仅装 AGP9 迁移技能
- 项目带 JetBrains 孵化器（Incubator）标识，尚处早期阶段，API 与技能内容可能变动
- 技能只有 Markdown 指导，效果取决于所使用代理对 Agent Skills 标准的支持程度，无独立运行时
- 当前仅 backend 和 tooling 两个预定义类别，覆盖面有限，扩展类别需提 issue 等待
- 安装 skills CLI 路径依赖 Node.js/npx，Claude Code 与 Codex 路径依赖各自插件市场工具链
如何安装或部署这个 Agent？
任选其一：
1) skills CLI：npx skills add Kotlin/kotlin-agent-skills2) Claude Code：claude plugin marketplace add Kotlin/kotlin-agent-skills，然后 claude plugin install kotlin-agent-skills@Kotlin
3) Codex：先在 shell 执行 codex plugin marketplace add Kotlin/kotlin-agent-skills，再在 codex 内调用 /plugins，搜索 kotlin-agent-skills 回车并选择 Install plugin
4) 手动：cp -r skills/kotlin-tooling-agp9-migration .claude/skills/（将技能文件夹复制到代理的技能目录）
如何使用这个 Agent？
安装后技能由所支持的编码代理自动发现并按需激活；技能激活时，代理读取对应 SKILL.md 中的 YAML frontmatter（name、description）及正文指导并据此执行任务。也可不经市场，直接把 skills/ 目录中的任意技能文件夹复制到代理的技能目录（如 .claude/skills/）即可使用。
这个 Agent 与同类方案有什么区别？
README 未提及其他同类 Kotlin 技能仓库，但技能遵循 agentskills.io 的 Agent Skills 标准，因此可与任何支持该标准的代理技能生态互换使用；相比之下，本仓库的差异点在于由 Kotlin 官方组织提供、专注 Kotlin 语言场景。