Skip to content

Usar plugins · Crear plugins — Preparación, no es un lanzamiento. La migración de proyectos a v2 aún no está disponible.

Cree su primer complemento

Instantánea histórica de la rama plugin-kit-ai v1. 1.2.4 es la referencia de comandos, no la versión exacta de esta instantánea.

Instantánea histórica de la rama plugin-kit-ai v1. 1.2.4 es la referencia de comandos, no la versión exacta de esta instantánea.

Cree su primer complemento

Este tutorial le brinda el primer repositorio de trabajo más simple en la ruta predeterminada más sólida.

Mantiene el alcance intencionalmente limitado:

  • primer objetivo: codex-runtime
  • primer idioma: go
  • primera puerta de preparación: validate --strict

Esa forma estrecha es sólo para la primera ejecución. Si lo que más le interesa es la historia más amplia de un repositorio y muchos resultados, lea Un proyecto, múltiples objetivos justo después de este tutorial.

1. Instale el CLI

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

2. Estructurar un proyecto

bash
plugin-kit-ai init my-plugin
cd my-plugin
go mod tidy

La ruta predeterminada init ya es el punto de inicio de producción recomendado.

3. Generar los archivos de destino

bash
plugin-kit-ai generate .

Trate los archivos de destino generados como salidas. Siga editando el repositorio a través de plugin-kit-ai en lugar de mantener manualmente los archivos generados.

4. Ejecute la puerta de preparación

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

Utilice esto como puerta principal de grado CI para un proyecto de complemento local.

Lo que tienes ahora

  • un repositorio de complementos
  • archivos creados bajo plugin/ para repos nuevos
  • generó Codex salida de tiempo de ejecución
  • una puerta de preparación clara a través de validate --strict

5. Cuándo cambiar de ruta

Cambie a otra ruta sólo cuando realmente la necesite:

  • elija claude para los complementos Claude
  • elija --runtime node --typescript para la ruta principal admitida que no sea Go
  • elija --runtime python cuando el proyecto permanezca local en el repositorio y su equipo sea Python-primero
  • elija codex-package, gemini, opencode o cursor solo cuando realmente necesite una forma diferente de enviar el complemento

Eso no significa que el repositorio deba permanecer con un único objetivo para siempre: comience con el objetivo más importante hoy y agregue los demás sólo cuando el producto se expanda genuinamente.

Próximos pasos

Documentación pública para autores de plugins e integradores.