构建你的第一个插件
本教程为您提供了最强默认路径上最简单的第一个工作存储库。
它故意缩小范围:
- 第一个目标:
codex-runtime - 第一语言:
go - 第一个准备门:
validate --strict
这种狭窄的形状仅适用于第一次运行。如果您主要关心的是更广泛的一个存储库、多个输出的故事,请在本教程之后阅读一个项目,多个目标。
1. 安装 CLI
bash
brew install 777genius/homebrew-plugin-kit-ai/plugin-kit-ai
plugin-kit-ai version2. 脚手架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-package、gemini、opencode或cursor
这并不意味着存储库必须永远保持单一目标:从今天最重要的目标开始,只有当产品真正扩展时才添加其他目标。