Skip to content

构建你的第一个插件

本教程为您提供了最强默认路径上最简单的第一个工作存储库。

它故意缩小范围:

  • 第一个目标:codex-runtime
  • 第一语言:go
  • 第一个准备门:validate --strict

这种狭窄的形状仅适用于第一次运行。如果您主要关心的是更广泛的一个存储库、多个输出的故事,请在本教程之后阅读一个项目,多个目标

1. 安装 CLI

bash
brew install 777genius/homebrew-plugin-kit-ai/plugin-kit-ai
plugin-kit-ai version

2. 脚手架A项目

bash
plugin-kit-ai init my-plugin
cd my-plugin

默认的 init 路径已经是推荐的生产起点。

3. 生成目标文件

bash
plugin-kit-ai generate .

将生成的目标文件视为输出。通过 plugin-kit-ai 继续编辑存储库,而不是手动维护生成的文件。

4. 运行准备门

bash
plugin-kit-ai validate . --platform codex-runtime --strict

使用它作为本地插件项目的主要 CI 级门。

你现在拥有的

  • 一个插件存储库
  • src/ 下创作的文件
  • 生成 Codex 运行时输出
  • 通过 validate --strict 的明确准备门

5. 何时切换路径

仅当您确实需要时才切换到另一路径:

  • 为 Claude 插件选择 claude
  • 选择 --runtime node --typescript 作为主要支持的非 Go 路径
  • 当项目位于存储库本地且您的团队优先为 Python 时,选择 --runtime python
  • 仅当您确实需要不同的方式来发送插件时,才选择 codex-packagegeminiopencodecursor

这并不意味着存储库必须永远保持单一目标:从今天最重要的目标开始,只有当产品真正扩展时才添加其他目标。

后续步骤

面向插件作者和集成者的公共文档。